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.
Install
npx skills add hashicorp/agent-skills --skill terraform-testnpx skills add hashicorp/agent-skills --skill terraform-test -a claude-code -gnpx skills add hashicorp/agent-skills --skill terraform-test -a codex -ggemini skills install https://github.com/hashicorp/agent-skills.git --path plugins/terraform/skills/terraform-testgh skill install hashicorp/agent-skills terraform-testgit clone --depth 1 https://github.com/hashicorp/agent-skills /tmp/hashicorp__agent-skills
mkdir -p ~/.claude/skills ~/.agents/skills
cp -R /tmp/hashicorp__agent-skills/plugins/terraform/skills/terraform-test ~/.claude/skills/terraform-test # Claude Code
cp -R /tmp/hashicorp__agent-skills/plugins/terraform/skills/terraform-test ~/.agents/skills/terraform-test # Codex, Cursor, Gemini CLI, Copilot, OpenCode