terraform-skill

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

1.45x

Quality

85%

Does it follow best practices?

Impact

99%

1.45x

Average score across 3 eval scenarios

Securityby

Low

Low-risk findings worth noting

Quality

Content

78%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 well-structured, highly actionable skill body with excellent progressive disclosure offloading detail to six reference files. Main weakness is length and some redundancy in reference linking that could be tightened.

Suggestions

Consolidate the per-section "For detailed X, see" links into the single "Detailed Guides" section to reduce repetition, or vice versa.

Move the version-availability and feature-by-version tables into quick-reference.md, keeping only the most decision-critical rows inline.

Add an explicit validate→fix→retry feedback loop around destructive operations (e.g., `terraform plan` review before `apply`) to strengthen workflow_clarity.

Dimension	Reasoning	Score
Conciseness	Mostly efficient with dense tables and code, but the ~500-line body repeats reference links both inline and in a trailing "Detailed Guides" section, and some version/feature tables are reference material that could live in quick-reference.md.	3 / 5
Actionability	Provides copy-paste-ready HCL blocks, concrete commands ("trivy config .", "terraform init -upgrade"), and decision matrices with specific tools covering the common cases.	5 / 5
Workflow Clarity	Sequenced workflows (Validate → Test → Plan → Apply; init → upgrade → plan) with checkpoints like plan review and production approvals; minor validation-feedback-loop gaps but destructive apply is guarded by an explicit Validate stage.	4 / 5
Progressive Disclosure	Clear overview with well-signaled one-level-deep references to six real files (code-patterns.md, testing-frameworks.md, etc., all present in references/), each cited inline with descriptive labels.	5 / 5
	Total	17 / 20 Passed

Description

92%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, specific description with explicit trigger guidance and good tool-name coverage. It clearly communicates both capability and activation conditions with low conflict risk.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions — "creating modules", "writing tests (native test framework, Terratest)", "setting up CI/CD pipelines", "debugging state issues", "implementing security scanning (trivy, checkov)" — giving comprehensive coverage of the skill's capabilities.	5 / 5
Completeness	Explicitly answers both what (the enumerated actions) and when ("Use when working with Terraform or OpenTofu - ...") with concrete trigger phrases.	5 / 5
Trigger Term Quality	Strong natural keyword coverage including synonyms ("Terraform or OpenTofu") and tool names ("Terratest", "trivy", "checkov", "CI/CD"), but a few common user terms like "HCL" or ".tf files" are absent.	4 / 5
Distinctiveness Conflict Risk	The Terraform/OpenTofu niche with named tools (trivy, checkov, Terratest) is clearly distinct with minimal overlap risk against other skills.	5 / 5
	Total	19 / 20 Passed

Validation

93%

Warnings & errors only

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

Validation — 15 / 16 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	15 / 16 Passed

Repository: provectus/awos-recruitment
Path: .claude/skills/terraform-skill/SKILL.md
Commit: 556fe34

Reviewed: 15 days ago

Table of Contents

Discovery Implementation Validation

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.