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.
Install with Tessl CLI
npx tessl i github:hashicorp/agent-skills --skill terraform-stacks95
Does it follow best practices?
Evaluation — 100%
↑ 1.66xAgent success when using this skill
Validation for skill structure
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that hits all the key criteria. It provides specific actions, comprehensive trigger terms including file extensions and domain concepts, explicit 'Use when' guidance with multiple scenarios, and is highly distinctive within the Terraform ecosystem by focusing specifically on Stacks rather than general Terraform usage.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'creating, modifying, or validating Terraform Stack configurations', 'working with stack components and deployments', 'managing multi-region or multi-environment infrastructure', and 'troubleshooting Terraform Stacks syntax and structure'. | 3 / 3 |
Completeness | Clearly answers both what ('Comprehensive guide for working with HashiCorp Terraform Stacks') and when with explicit 'Use when' clause covering four distinct trigger scenarios including file types, sources, infrastructure patterns, and troubleshooting. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'Terraform Stacks', '.tfcomponent.hcl', '.tfdeploy.hcl', 'stack components', 'deployments', 'local modules', 'public registry', 'private registry', 'multi-region', 'multi-environment infrastructure'. Includes both file extensions and conceptual terms. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with clear niche targeting specifically 'Terraform Stacks' (not general Terraform), unique file extensions (.tfcomponent.hcl, .tfdeploy.hcl), and specific concepts like stack components and deployments that distinguish it from general Terraform or IaC skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured, highly actionable skill document for Terraform Stacks. It excels at providing executable code examples, clear workflows, and appropriate progressive disclosure to reference files. Minor improvements could be made by trimming some explanatory content that assumes less of Claude's baseline knowledge.
Suggestions
Remove or condense explanatory phrases like 'This approach: Avoids long-lived static credentials...' under Authentication Best Practice - Claude understands OIDC benefits
Trim the 'Core Concepts' section which explains basic terminology Claude can infer from context
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is generally efficient but includes some explanatory text that Claude would already know (e.g., explaining what OIDC is, basic concepts like 'State Isolation: Each deployment has its own isolated state'). Some sections could be tightened, though most content earns its place. | 2 / 3 |
Actionability | Provides fully executable HCL code examples throughout, with specific file structures, complete configuration blocks, and copy-paste ready CLI commands. The examples are concrete and immediately usable. | 3 / 3 |
Workflow Clarity | Clear numbered workflow for deployment (init → validate → upload → monitor → approve), explicit validation steps with 'terraform stacks validate', and clear guidance on destruction workflow with explicit sequencing. The CLI section provides unambiguous step-by-step processes. | 3 / 3 |
Progressive Disclosure | Excellent structure with a comprehensive overview in the main file and well-signaled one-level-deep references to detailed documentation (component-blocks.md, deployment-blocks.md, examples.md, api-monitoring.md, etc.). Navigation is clear and content is appropriately split. | 3 / 3 |
Total | 11 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- 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.