provider-test-patterns agent skill by hashicorp

At a glance

Before you install

Read from the skill's files at the directory's October 19, 2026 snapshot: what ships with it, what its code reads, and the terms it is published under.

• Bundled scripts: none.
• License: MPL-2.0, an open-source or open-content license.

Install provider-test-patterns

The skills CLI works with Claude Code, Codex, Cursor and other agents; the other routes copy the folder by hand.

npx skills add https://github.com/hashicorp/agent-skills/tree/main/plugins/terraform/skills/provider-test-patterns

tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/hashicorp/agent-skills.git "$tmp/repo"
mkdir -p .claude/skills
cp -R "$tmp/repo/"plugins/terraform/skills/provider-test-patterns .claude/skills/
rm -rf "$tmp"

python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
    --repo hashicorp/agent-skills \
    --path plugins/terraform/skills/provider-test-patterns

hashicorp/agent-skills is third-party code. Read SKILL.md and any bundled scripts before you install it.

How the author describes it

Terraform provider acceptance test patterns using terraform-plugin-testing with the Plugin Framework. Covers test structure, TestCase/TestStep fields, ConfigStateChecks with custom statecheck.StateCheck implementations, plan checks, CompareValue for cross-step assertions, config helpers, import testing with ImportStateKind, sweepers, and scenario patterns (basic, update, disappears, validation, regression), and ephemeral resource testing with the echoprovider package. Use when writing, reviewing, or debugging provider acceptance tests, including questions about statecheck, plancheck, TestCheckFunc, CheckDestroy, ExpectError, import state verification, ephemeral resources, or how to structure test files.

From the description field of SKILL.md. Agents read this line to decide when to load the skill.

Sections in SKILL.md

• Test Lifecycle
• Test Function Structure
• Provider Factory
• TestCase Fields
• TestStep Fields
• Config Mode
• Import Mode
• Check Functions
• Modern: ConfigStateChecks (preferred)
• Legacy: Check (for CheckDestroy and migration)
• Config Helpers
• Scenario Patterns
• Basic + Update (combine in one test — updates are supersets of basic)
• Import
• Disappears (resource deleted externally)
• Validation (expect error)

Files in the skill folder

• SKILL.md
• references/checks.md
• references/ephemeral.md
• references/sweepers.md

Suede Skill Check: 81/100 · B

provider-test-patterns passes the required frontmatter check and all seven graded checks, which cover the SKILL.md format, a declared license and a commit in the last year. Those checks earn 56 of the score’s points; the rest come from description quality, instruction depth, bundled files, maintenance and curated-list citations. How the score works.

Where this skill is cited

hashicorp/agent-skills appears in 2 curated lists: BehiSecc/awesome-claude-skills, heilcheng/awesome-agent-skills.

More testing and QA skills

All testing and QA skills

More from hashicorp/agent-skills

All 19 skills in hashicorp/agent-skills