Use when working with Terraform or OpenTofu - creating modules, writing tests (native test framework, Terratest), setting up CI/CD pipelines, reviewing configurations, choosing between testing approaches, debugging state issues, implementing security scanning (trivy, checkov), or making infrastructure-as-code architecture decisions
68
82%
Does it follow best practices?
Impact
—
No eval scenarios have been run
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 a strong skill description that clearly identifies its domain (Terraform/OpenTofu infrastructure-as-code) and enumerates specific capabilities with concrete tool names and frameworks. The explicit 'Use when' opening provides clear trigger guidance, and the rich set of natural keywords ensures good matching. The only minor weakness is that it leads with 'Use when' without a separate declarative statement of what the skill does, but the content within the 'Use when' clause effectively covers both dimensions.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: creating modules, writing tests (with named frameworks), setting up CI/CD pipelines, reviewing configurations, debugging state issues, implementing security scanning (with named tools), and making architecture decisions. | 3 / 3 |
Completeness | Opens with an explicit 'Use when' clause that doubles as both the 'when' trigger and the 'what' description. The what (creating modules, writing tests, CI/CD, security scanning, etc.) and when (working with Terraform/OpenTofu in these contexts) are both clearly addressed. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'Terraform', 'OpenTofu', 'modules', 'tests', 'Terratest', 'CI/CD', 'state issues', 'trivy', 'checkov', 'infrastructure-as-code'. These are terms practitioners naturally use when seeking help. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with clear niche triggers like 'Terraform', 'OpenTofu', 'Terratest', 'trivy', 'checkov', and 'infrastructure-as-code'. Unlikely to conflict with other skills unless there are multiple IaC-related skills, and even then the specific tool names provide strong differentiation. | 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 well-structured, comprehensive Terraform skill with strong actionability through concrete HCL examples, decision matrices, and specific patterns. Its main weaknesses are moderate verbosity (some content Claude already knows, and the main file is long for an overview) and workflow clarity that lacks explicit validation checkpoints and error recovery loops for multi-step processes. The progressive disclosure structure is well-designed in theory but cannot be verified without bundle files.
Suggestions
Trim content Claude already knows: remove basic file naming conventions (main.tf, variables.tf), obvious security advice ('don't store secrets in variables'), and general best practices that any Terraform-aware model would know.
Add explicit validation checkpoints and error recovery loops to the CI/CD workflow and module development sections, e.g., 'If plan shows unexpected changes: review diff → check state → re-run plan' rather than just listing stages.
Move some of the longer inline sections (e.g., the full Count vs For_Each section, Locals for Dependency Management) to reference files since they are detailed enough to warrant separate documents, keeping only a brief summary and link in the main file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is fairly long (~400 lines) and includes some content Claude already knows (e.g., basic file naming conventions like main.tf/variables.tf/outputs.tf, general advice like 'use least-privilege security groups'). However, most content adds genuine value with specific patterns, decision matrices, and concrete examples. Could be tightened by removing obvious guidance. | 2 / 3 |
Actionability | The skill provides extensive executable HCL code examples, concrete bash commands (trivy, checkov, terraform init -upgrade), specific decision matrices with clear recommendations, and copy-paste ready patterns for resource ordering, variable blocks, count vs for_each, and version constraints. The guidance is highly specific and actionable throughout. | 3 / 3 |
Workflow Clarity | The CI/CD section lists workflow stages (Validate → Test → Plan → Apply) but lacks explicit validation checkpoints and error recovery steps. The testing section provides a decision matrix but doesn't include a clear step-by-step workflow with feedback loops for when tests fail. The module development section lists best practices but doesn't sequence them into a validated workflow. For infrastructure operations that can be destructive, the missing validation/feedback loops cap this at 2. | 2 / 3 |
Progressive Disclosure | The skill references multiple detailed guides (testing-frameworks.md, module-patterns.md, ci-cd-workflows.md, security-compliance.md, quick-reference.md, code-patterns.md) with clear signaling and descriptions. However, no bundle files were provided, so we cannot verify these references exist. Additionally, the main file itself is quite long and includes substantial detail that could arguably be pushed to reference files, making the overview heavier than ideal. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (517 lines); consider splitting into references/ and linking | Warning |
Total | 10 / 11 Passed | |
70de68f
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.