CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

terraform-validator

Comprehensive toolkit for validating, linting, testing, and automating Terraform configurations and HCL files. Use this skill when working with Terraform files (.tf, .tfvars), validating infrastructure-as-code, debugging Terraform configurations, performing dry-run testing with terraform plan, or working with custom providers and modules.

Quality

85%

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

81%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.

The body is a highly actionable, well-sequenced validation workflow with real one-level-deep bundle references and strong error-recovery guidance. Its weaknesses are padding: a redundant inlined remediation example and a closing section of standard terraform CLI commands Claude already knows.

Suggestions

Trim the closing "References" section to non-obvious invocations only — the standard `terraform fmt`/`validate`/`plan` flag examples (-out, -var-file, -target) re-teach CLI knowledge Claude already has.

Replace the full HCL remediation block in the example cross-referenced report with a one-line pointer like "remediation copied from security_checklist.md §Overly Permissive Security Groups", since the template already instructs copying from the reference file.

Consider moving the security report template and example into security_checklist.md alongside the Checkov ID mappings it depends on, keeping SKILL.md to the workflow and navigation.

DimensionReasoningScore

Conciseness

Mostly efficient tables and commands, but there are two padded areas: the ~40-line worked example report duplicates a full HCL remediation block that the template itself says to copy from security_checklist.md, and the trailing "References" section re-teaches standard terraform fmt/validate/plan CLI flags (e.g. `-out`, `-var-file`, `-target`) Claude already knows — fitting anchor 3 (some unnecessary explanation, could be tightened) rather than anchor 4's minor-trims profile.

3 / 5

Actionability

Fully executable throughout: exact wrapper invocations with arguments (`bash scripts/run_checkov.sh <path>`), a numbered lookup workflow naming the exact MCP calls (`mcp__context7__resolve-library-id` with the WebSearch fallback string), a fill-in report template, and a concrete missing-tool dialogue with install commands — matching anchor 5 (copy-paste ready, covering common cases).

5 / 5

Workflow Clarity

The 11-step ordered table marks Required vs Recommended gates, enforces ordering constraints (references read before scans), and provides explicit error-recovery feedback loops (Handling Missing Tools flow, common_errors.md error database) — matching anchor 5's clear sequence with explicit validation checkpoints and feedback loops; this is a validation-only skill that explicitly stops at plan, so no destructive-operation cap applies.

5 / 5

Progressive Disclosure

All four reference files (security_checklist.md, best_practices.md, common_errors.md, advanced_features.md) and all four scripts exist in the bundle, are one level deep, and are well signaled via the When/File/Content table; however, the example report inlines a remediation code block that belongs in (and is stated to come from) security_checklist.md, a minor organization gap that keeps it at anchor 4 rather than anchor 5.

4 / 5

Total

17

/

20

Passed

Description

83%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 that clearly states both what the skill does and when to use it, with concrete Terraform-specific trigger terms and file extensions. Its main weaknesses are the mildly generic action verbs, absent security-scanning trigger terms, and a couple of phrases that could overlap with a Terraform generation/provider-development skill.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "validating, linting, testing, and automating Terraform configurations" plus "performing dry-run testing with terraform plan" — which goes beyond the 1-2 actions of anchor 3, but the verbs are one level more generic than anchor 5's fully concrete action list and "Comprehensive toolkit" is mild fluff, so it fits anchor 4 (several specific actions, minor gaps such as security scanning, a core capability, being unmentioned).

4 / 5

Completeness

It explicitly answers both questions: what ("validating, linting, testing, and automating Terraform configurations and HCL files") and when ("Use this skill when working with Terraform files (.tf, .tfvars), validating infrastructure-as-code, debugging...") with concrete trigger phrases, exactly matching the anchor 5 exemplar pattern; anchor 4 would require the 'when' clause to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Strong natural coverage — "Terraform files (.tf, .tfvars)", "infrastructure-as-code", "debugging Terraform configurations", "terraform plan", "custom providers and modules", plus the HCL synonym — but anchor 5 is not fully met because common trigger phrasings like "security scan"/"Checkov" and "tflint" for the scanning/linting capabilities are missing, matching anchor 4 (good coverage, a few natural terms missing).

4 / 5

Distinctiveness Conflict Risk

The niche is clear (Terraform validation with .tf/.tfvars/terraform plan triggers), but phrases like "automating Terraform configurations" and "working with custom providers and modules" could pull in requests for generating Terraform or developing providers — closely related but different tasks — so it fits anchor 4 (mostly distinct, minor overlap risk) rather than anchor 5's minimal-conflict profile.

4 / 5

Total

17

/

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

pantheon-org/tekhne

Path

skills/infrastructure/terraform/validator/SKILL.md

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.