CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

terraform

Runs through the full Terraform validation pipeline — fmt, validate, tflint, security scan — and reviews a module or plan for blast radius, IAM risk, and state impact.

Quality

79%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/platform-skills/skills/terraform/SKILL.md

The canonical home for this skill is terraform in nitinjain999/platform-skills

SKILL.md
Quality
Evals
Security

Quality

Content

75%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 tight, actionable review checklist with copy-paste commands for every validation gate and a sensible ordered workflow including an approval checkpoint. The main gaps are the missing fix-and-revalidate loop and the absence of any example corrected-HCL snippet despite Section 6 promising one.

Suggestions

Add an explicit feedback loop after Section 6: after listing fixes, re-run the Section 1 gates to confirm they pass — this closes the workflow-clarity gap.

Include one short example of a corrected HCL snippet (e.g. adding a validation block or tightening a wildcard IAM action) to make Section 6's deliverable concrete.

Move the tfsec v1.0 flag-change detail into a compact "deprecated flags" note or trim it, keeping time-sensitive version info out of the main flow.

DimensionReasoningScore

Conciseness

The body assumes Terraform competence (no concept explanations) and stays tight, with useful per-gate annotations. It is not 5 because the inline "tfsec version note" is time-sensitive version information placed outside any old-patterns/deprecated section, which the guidelines penalize; it is not 3 because the rest is genuinely lean with only this minor trimmable instance.

4 / 5

Actionability

All four gates have copy-paste commands ("terraform fmt -check -recursive", "tflint --recursive", tfsec/checkov/trivy variants) plus an executable pre-merge plan snippet. It is not 5 because Section 6 instructs "List exact fixes with the corrected HCL snippet" without showing a single example fix, and sections 2–5 are question-form checklists rather than fully executable guidance.

4 / 5

Workflow Clarity

The pipeline is an explicitly ordered gate sequence with a per-gate pass/fail-and-why instruction, and the pre-merge block includes an approval checkpoint ("Any replacement of stateful resources ... requires explicit approval"). It is not 5 because there is no fix-then-revalidate feedback loop after the recommended actions — Section 6 lists fixes but never says to re-run the gates.

4 / 5

Progressive Disclosure

The skill is a single well-organized file with clear numbered sections, and no bundle files exist to reference; the cross-skill pointer to /platform-skills:checkov is clearly signaled and one level deep. It is not 5 because at ~85 lines it exceeds the under-50-line simple-skill exception, and the tfsec version-flag detail would sit more appropriately in a small reference or deprecated-flags note.

4 / 5

Total

16

/

20

Passed

Description

75%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, third-person description that names its tools and review dimensions explicitly. Its one real weakness is the absence of any "Use when..." trigger clause, which caps completeness and leaves activation guidance implicit.

Suggestions

Append an explicit trigger clause, e.g. "Use when reviewing Terraform code, plan output, or modules, or when the user mentions HCL, tflint, or infrastructure changes" — this lifts completeness from 3 to 5.

Add natural synonyms such as "HCL", "IaC", and ".tf files" to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities — "fmt, validate, tflint, security scan" for the pipeline and "blast radius, IAM risk, and state impact" for the review — in third-person voice, comprehensively covering the skill's actions. It is not 4 because the coverage has no notable gaps; seven named specifics match the comprehensive anchor.

5 / 5

Completeness

The "what" is clearly and concretely answered (validation pipeline plus three named review dimensions), but there is no "Use when..." clause or equivalent explicit trigger guidance — the "when" is only weakly implied by "reviews a module or plan". Per the judging guidelines, a missing 'Use when' clause caps completeness at 3.

3 / 5

Trigger Term Quality

"Terraform", "tflint", "validate", "IAM", "plan", and "state" are terms users naturally say, giving good keyword coverage. It is not 5 because common synonyms and variations such as "HCL", "IaC"/"infrastructure as code", and ".tf" files are missing.

4 / 5

Distinctiveness Conflict Risk

"Terraform" plus named tools (fmt, tflint) carves out a clear niche with minimal conflict risk against other skills. It is not 4 because the description is not merely "mostly distinct" — it is firmly anchored to Terraform-specific tooling and review dimensions.

5 / 5

Total

17

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

nitinjain999/platform-skills

Path

plugins/platform-skills/skills/terraform/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.