CtrlK
BlogDocsLog inGet started
Tessl Logo

run-acceptance-tests

Guide for running acceptance tests for a Terraform provider. Use this when asked to run an acceptance test or to run a test with the prefix `TestAcc`, when a test fails with missing environment variables, or when diagnosing a failing or suspiciously passing acceptance test.

70

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

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

An exemplary instruction-only skill body: concrete executable commands, ordered diagnosis escalation, a validated false-negative flip procedure, and appropriate safety checks around real infrastructure. The only refinements are minor wording redundancy in the diagnosis list and the absence of section headers.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — e.g., "go test kills any test run after 10 minutes by default, and acceptance tests routinely exceed that" delivers only non-obvious knowledge. Minor trimming possible: the diagnose items repeat themselves slightly ("Offer verbose `go test` output. Use the `-v` option."). This is above the 3 anchor (mostly efficient, some unnecessary explanation) but not every token is maximally dense, so it does not reach 5.

4 / 5

Actionability

Fully executable, copy-paste-ready commands throughout: `go test -run=TestAccFeatureHappyPath -timeout 60m` with `TF_ACC=1`, the grep `grep -rn "os.Getenv" --include="*_test.go"`, `-count=1`, `-v`, `TF_LOG=debug`, `TF_ACC_WORKING_DIR_PERSIST=1`. The flip procedure gives concrete edit/run/undo steps. Matches the 5 anchor: specific commands cover the common cases.

5 / 5

Workflow Clarity

Sequences are explicit with validation checkpoints: a pre-run safety check ("Confirm the configured credentials point at a test account"), a cost warning before infrastructure is created, an explicitly ordered cumulative diagnosis escalation, a flip procedure with a pass/fail verification branch ("If the test fails, then undo the edit... Else, keep the edit and report an unsuccessful flip"), and post-run cleanup (sweepers) for interrupted runs. Feedback loops are present; matches the 5 anchor.

5 / 5

Progressive Disclosure

This is a single-file skill with no bundle files; all content is appropriately inline at this length (~55 lines) and cross-skill pointers ("provider-configuration", "provider-test-patterns") are clearly signaled one level deep. It falls short of 5 because there are no section headers organizing the distinct topics (run, diagnose, flip, cleanup), so navigation relies on paragraph structure.

4 / 5

Total

18

/

20

Passed

Description

82%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: explicit 'Use this when...' triggers with concrete phrases, third-person voice, and a clearly delimited Terraform-provider acceptance-test niche. Its only weakness is that the 'what' clause ('Guide for running') is somewhat thin relative to the rich trigger list.

DimensionReasoningScore

Specificity

The description names the domain ("acceptance tests for a Terraform provider") and a couple of concrete actions ("running acceptance tests", "diagnosing a failing or suspiciously passing acceptance test"), but 'Guide for running' is generic and coverage is not comprehensive (e.g., the env-var/sweeper aspects are only hinted at). It sits above the 2-anchor (domain-only) because of the explicit diagnose action, but below 4, which requires several listed specific actions with only minor gaps.

3 / 5

Completeness

It explicitly answers both questions: what ("Guide for running acceptance tests for a Terraform provider") and when ("Use this when asked to run an acceptance test... or when diagnosing a failing or suspiciously passing acceptance test") with concrete trigger phrases. This matches the 5 anchor directly and exceeds 4, where the 'when' is only partially explicit.

5 / 5

Trigger Term Quality

Natural user phrases are well covered: "run an acceptance test", "test with the prefix `TestAcc`", "test fails with missing environment variables", "diagnosing a failing or suspiciously passing acceptance test". It falls short of 5 because it lacks synonyms and variations users might say (e.g., 'integration test', 'provider test', 'TF_ACC').

4 / 5

Distinctiveness Conflict Risk

The `TestAcc` prefix and "acceptance tests for a Terraform provider" carve out a clear niche with distinct triggers; it would not fire for generic test-running or the test-*writing* skill. Minimal conflict risk — matches the 5 anchor.

5 / 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
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.