CtrlK
BlogDocsLog inGet started
Tessl Logo

terraform-stacks

Comprehensive guide for working with HashiCorp Terraform Stacks. Use when creating, modifying, or validating Terraform Stack configurations (.tfcomponent.hcl, .tfdeploy.hcl files), working with stack components and deployments from local modules, public registry, or private registry sources, managing multi-region or multi-environment infrastructure, or troubleshooting Terraform Stacks syntax and structure.

74

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

86%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A dense, executable reference for a niche HCL dialect: complete code examples for every block type, real CLI commands, and a clean one-level-deep reference structure. The weaknesses are minor — some repeated guidance, a rationale-style authentication section, and validation not explicitly sequenced into the deployment workflow.

Suggestions

Make `terraform stacks validate` an explicit step 0 of the Deployment Workflow (validate → fix → re-validate → upload) so the feedback loop is sequenced rather than implied by a standalone command.

Deduplicate the module-compatibility guidance, which appears in both Best Practices ('Test public registry modules before using in production Stacks') and Troubleshooting ('Test public registry modules before production use'), keeping the detail in references/troubleshooting.md.

Trim the workload-identity benefit bullets ('Avoids long-lived static credentials', 'Provides temporary, scoped credentials...') to a single sentence of rationale and link the dynamic-provider-credentials URL, cutting explanation Claude does not need to act.

DimensionReasoningScore

Conciseness

The body is mostly tight HCL examples and stack-language syntax rules that Claude genuinely does not know (e.g., 'Outputs require a type argument and do not support preconditions', provider 'aliases in the block header (not as an argument)'), with only minor padding — the workload-identity benefit bullets ('Avoids long-lived static credentials', 'Provides temporary, scoped credentials per deployment run') read as rationale rather than instruction, and module-compatibility testing advice is repeated in both Best Practices ('Test public registry modules before using in production Stacks') and Troubleshooting ('Test public registry modules before production use'). It is not a 3 because nearly every section is executable syntax or commands with no conceptual filler, and not a 5 because of the duplicated guidance and the introductory paragraph explaining what stacks are for.

4 / 5

Actionability

Every block type (variable, provider, component, deployment, deployment_group, deployment_auto_approve, publish_output, upstream_input, removed, store, identity_token) ships a complete executable HCL example, and the CLI section gives copy-paste commands with real flags ('terraform stacks deployment-run approve-all-plans -deployment-run-id=...', 'GET /api/v2/stack-deployment-steps/{step-id}/artifacts?name=apply-description'), covering the common cases including multi-region for_each and linked stacks.

5 / 5

Workflow Clarity

The deployment workflow is explicitly numbered with commands ('1. Upload configuration (triggers deployment runs)', '2. Monitor deployments', '3. Approve deployments') and the destroy flow is sequenced with a human approval checkpoint ('Set destroy = true, upload configuration, approve destroy run, then remove the deployment block'), and a validation command exists ('terraform stacks validate # Check syntax without uploading'). It is a 4 rather than 5 because validate is documented as a standalone command and never wired into the workflow as an explicit pre-upload checkpoint, so the feedback loop (validate → fix → re-validate) is implicit; it is above 3 because sequences are complete and approval gates cover the destructive destroy path.

4 / 5

Progressive Disclosure

The body keeps core syntax inline and defers detail through clearly signaled, one-level-deep references — 'See references/component-blocks.md for examples of dependencies, for_each, public registry modules, Git sources, and more', plus a terminal References section annotating all six files (component-blocks, deployment-blocks, linked-stacks, examples, api-monitoring, troubleshooting), all of which exist on disk and none of which nest further.

5 / 5

Total

18

/

20

Passed

Description

96%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it explicitly states what the skill covers and when to use it, with concrete actions, the characteristic file extensions, and natural trigger phrases. The only weakness is minor overlap risk with general Terraform module/registry work in the component-sourcing clause.

DimensionReasoningScore

Specificity

Multiple concrete actions are enumerated — 'creating, modifying, or validating Terraform Stack configurations', 'managing multi-region or multi-environment infrastructure', 'troubleshooting Terraform Stacks syntax and structure' — with specific file extensions, which is comprehensive coverage of the domain's actions rather than the 'several specific actions; minor gaps' of a 4.

5 / 5

Completeness

Both what and when are explicit with concrete triggers: the 'what' is stated through enumerated capabilities ('creating, modifying, or validating... configurations'), and the 'when' is an explicit multi-clause 'Use when creating, modifying, or validating Terraform Stack configurations (.tfcomponent.hcl, .tfdeploy.hcl files), working with stack components and deployments...'. Not a 4, because the 'when' is fully explicit rather than 'could be more specific'.

5 / 5

Trigger Term Quality

Natural user phrasing is comprehensively covered, including the file extensions users would literally quote: 'Terraform Stacks', '.tfcomponent.hcl', '.tfdeploy.hcl', 'stack components', 'deployments', 'multi-region or multi-environment infrastructure', 'troubleshooting'. This matches the anchor-5 pattern of 'natural terms including synonyms and file extensions'.

5 / 5

Distinctiveness Conflict Risk

The stack-specific extensions and 'Terraform Stacks' terminology form a clear niche with minimal conflict risk, but phrases like 'working with stack components and deployments from local modules, public registry, or private registry sources' overlap with general Terraform module-management requests, so a user asking about ordinary registry modules could trigger this skill — 'mostly distinct; minor overlap risk with closely related skills'.

4 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
hashicorp/agent-skills
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.