terraform-test

Comprehensive guide for writing and running Terraform tests. Use when creating test files (.tftest.hcl), writing test scenarios with run blocks, validating infrastructure behavior with assertions, mocking providers and data sources, testing module outputs and resource configurations, or troubleshooting Terraform test syntax and execution.

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

80%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 reference with real, clearly signaled bundle files and executable examples throughout. Its main weakness is the absence of an explicit validation/feedback loop for the destructive apply-mode test workflow, which caps workflow clarity.

Suggestions

Add a short workflow with a validation checkpoint before apply-mode tests — e.g., run plan-mode unit tests first, confirm they pass, then run apply-mode integration tests — to satisfy the destructive-operation feedback-loop requirement.

Consolidate the similar "Common Test Patterns" examples (outputs, conditional resources, resource counts, tags, data sources) into a smaller set or move the variations into references/EXAMPLES.md to tighten the body.

Cross-link the cleanup-ordering guidance from the apply-mode workflow so the reverse-destroy behavior is visible at the point a user decides to run destructive tests.

Dimension	Reasoning	Score
Conciseness	The body is largely lean and assumes Terraform competence, but several "Common Test Patterns" sections (validate outputs, conditional resources, resource counts, tags, data sources) are variations of the same run-block-plus-assert structure and could be condensed without losing clarity.	4 / 5
Actionability	Provides copy-paste-ready HCL examples for each pattern and concrete `terraform test` invocations with flags (-filter, -verbose, -no-cleanup), covering the common cases a user would actually run.	5 / 5
Workflow Clarity	Apply-mode tests create and destroy real cloud resources — a destructive/batch operation — yet the skill offers no explicit validate-then-proceed checkpoint or feedback loop (e.g., run plan-mode tests first, confirm green, then run apply-mode), which caps this dimension at 3 per the rubric.	3 / 5
Progressive Disclosure	Three real bundle files (MOCK_PROVIDERS.md, CI_CD.md, EXAMPLES.md) are listed in a dedicated "Reference Files" section with one-line descriptions and a "Read the relevant reference file when…" navigation cue — one level deep, clearly signaled.	5 / 5
	Total	17 / 20 Passed

Description

100%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, third-person description that names concrete actions, includes a file extension, and pairs a clear capability statement with an explicit "Use when" trigger clause. It is comprehensive yet free of fluff or over-claims.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — "creating test files (.tftest.hcl)", "writing test scenarios with run blocks", "validating infrastructure behavior with asserts", "mocking providers and data sources", "testing module outputs and resource configurations", and "troubleshooting Terraform test syntax and execution" — giving comprehensive coverage of the skill's capabilities.	5 / 5
Completeness	Explicitly answers both what ("Comprehensive guide for writing and running Terraform tests") and when ("Use when creating test files… or troubleshooting Terraform test syntax and execution") with concrete trigger phrases.	5 / 5
Trigger Term Quality	Covers natural user terms ("writing and running Terraform tests", "troubleshooting Terraform test") plus the file extension ".tftest.hcl" and synonyms ("test files", "Terraform tests"), matching the comprehensive-coverage-with-extensions anchor.	5 / 5
Distinctiveness Conflict Risk	Occupies a clear niche — Terraform's built-in testing framework — with triggers unlikely to fire for unrelated skills, so conflict risk is minimal.	5 / 5
	Total	20 / 20 Passed

Validation

100%

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

Validation for skill structure

No warnings or errors.

Repository: hashicorp/agent-skills
Path: plugins/terraform/skills/terraform-test/SKILL.md
Commit: 3268468

Reviewed: 4 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.