CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

88

1.49x
Quality

82%

Does it follow best practices?

Impact

100%

1.49x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

65%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable with executable examples and clean reference signaling, but is over-long for a SKILL.md because many pattern examples live inline instead of in the provided EXAMPLES.md, and it lacks an explicit test→validate→fix loop for the apply-mode workflow.

Suggestions

Move most 'Common Test Patterns' examples into references/EXAMPLES.md, keeping only 2–3 representative patterns in the body to cut tokens and sharpen progressive disclosure.

Add an explicit workflow with validation checkpoints, e.g. 'write test → terraform test → on failure run -verbose / -no-cleanup → fix → re-run', to lift workflow_clarity above 2 given apply-mode tests create real resources.

Trim the mild redundancy between 'File Structure' naming guidance and 'Best Practices' item 1, which repeat the *_unit_test / *_integration_test naming convention.

DimensionReasoningScore

Conciseness

Prose is lean and code-dense, but the 'Common Test Patterns' section carries 14 full inline examples (parallel modules, state key sharing, cleanup ordering, aliased providers, etc.) that duplicate territory already covered by references/EXAMPLES.md and could be tightened or offloaded.

2 / 3

Actionability

Provides fully executable HCL blocks plus concrete commands ('terraform test -filter=test_vpc_configuration', '-no-cleanup') that are copy-paste ready, matching the executable anchor.

3 / 3

Workflow Clarity

Sections are sequenced (structure → run block → patterns → running → troubleshooting) but there is no explicit validate→fix→retry feedback loop, and apply-mode tests create real resources — a destructive/batch context where the rubric caps clarity at 2 without checkpoints.

2 / 3

Progressive Disclosure

The top 'Reference Files' section signals three one-level-deep references well, but content that belongs in EXAMPLES.md (the 14 inline pattern blocks) is kept inline rather than appropriately split, fitting the 'content that should be separate is inline' anchor.

2 / 3

Total

9

/

12

Passed

Description

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.

The description is specific, trigger-rich, and explicitly pairs what the skill does with when to use it in third-person voice. It is a strong example matching the rubric's good_overall_examples.

DimensionReasoningScore

Specificity

Lists multiple concrete actions: '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.'

3 / 3

Completeness

Explicitly answers what ('writing and running Terraform tests') and when via an explicit 'Use when ...' clause enumerating triggers, satisfying the both-what-and-when anchor.

3 / 3

Trigger Term Quality

Covers natural terms users would say — 'writing and running Terraform tests', 'test files (.tftest.hcl)', 'run blocks', 'assertions', 'mocking providers', 'troubleshooting' — matching the good-coverage anchor.

3 / 3

Distinctiveness Conflict Risk

The niche is sharply scoped to Terraform's testing framework with distinct triggers (.tftest.hcl, run blocks, assertions), making conflict with other skills unlikely.

3 / 3

Total

12

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
hashicorp/agent-skills
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.