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.
88
82%
Does it follow best practices?
Impact
100%
1.66xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Quality
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 clearly defines its scope around HashiCorp Terraform Stacks with specific actions, explicit trigger conditions, and distinctive terminology including file extensions. It uses proper third-person voice and provides comprehensive coverage of when the skill should be selected. The description is well-structured and concise while being thorough.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: creating, modifying, validating Stack configurations, working with stack components and deployments from various sources (local modules, public registry, private registry), managing multi-region/multi-environment infrastructure, and troubleshooting syntax and structure. | 3 / 3 |
Completeness | Clearly answers both 'what' (comprehensive guide for working with Terraform Stacks) and 'when' with an explicit 'Use when...' clause listing four distinct trigger scenarios: creating/modifying/validating configs, working with sources, managing multi-region/environment infra, and troubleshooting. | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'Terraform Stacks', '.tfcomponent.hcl', '.tfdeploy.hcl', 'stack components', 'deployments', 'multi-region', 'multi-environment', 'public registry', 'private registry', 'troubleshooting'. These cover file extensions, concepts, and common user terminology well. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche: HashiCorp Terraform Stacks specifically, not general Terraform or IaC. The mention of specific file extensions (.tfcomponent.hcl, .tfdeploy.hcl) and Stacks-specific concepts makes it very unlikely to conflict with a general Terraform skill or other IaC skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a comprehensive and highly actionable Terraform Stacks skill with excellent executable code examples covering all major configuration blocks and CLI commands. Its main weaknesses are moderate verbosity (some conceptual explanations Claude doesn't need) and missing explicit validation/error-recovery feedback loops in the deployment workflow. The progressive disclosure structure is well-designed with clear references, but the main file carries too much inline detail that could be better distributed to the referenced files.
Suggestions
Add explicit validation feedback loops to the deployment workflow (e.g., 'If `terraform stacks validate` fails, review errors, fix configuration, and re-validate before uploading').
Trim the 'Core Concepts' section to a brief glossary or remove it entirely—Claude can infer what components and deployments are from the configuration examples.
Move the detailed CLI command listings and some of the longer configuration examples (store blocks, deployment groups, auto-approve) into reference files to reduce the main SKILL.md length and improve progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is generally well-structured but includes some unnecessary explanations (e.g., explaining what a Stack, Component, and Deployment are conceptually when Claude can infer these). Some sections like 'Core Concepts' and 'Best Practices' contain filler. However, the code examples are lean and the overall structure avoids excessive verbosity. | 2 / 3 |
Actionability | The skill provides fully executable HCL code blocks for every configuration type, concrete CLI commands with exact syntax, specific file extensions, directory structures, and clear examples of provider configuration, component blocks, deployment blocks, and more. The code is copy-paste ready and covers real-world patterns. | 3 / 3 |
Workflow Clarity | The deployment workflow section provides a numbered sequence (init → validate → upload → monitor → approve), but lacks explicit validation checkpoints and error recovery loops. For example, there's no 'if validate fails, fix and re-validate' feedback loop. The destruction workflow mentions steps but doesn't provide a clear validated sequence. For infrastructure operations that can be destructive, the missing feedback loops cap this at 2. | 2 / 3 |
Progressive Disclosure | The skill references multiple files in a `references/` directory (component-blocks.md, deployment-blocks.md, linked-stacks.md, examples.md, api-monitoring.md, troubleshooting.md) which is good structure. However, no bundle files were provided, so we cannot verify these references exist. The main SKILL.md itself is quite long (~350+ lines) and includes substantial inline detail that could be offloaded to reference files, particularly the full deployment configuration section and CLI command listings. | 2 / 3 |
Total | 9 / 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.
339a113
Table of Contents
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.