How does it handle unit vs integration tests?

It differentiates them using the 'command' attribute: 'plan' mode is used for unit testing logic, while 'apply' mode is used for full-stack integration testing.

What version of Terraform does this skill support?

This skill is optimized for Terraform 1.6.0 and later, which introduced the native testing framework and the .tftest.hcl format.

Can I test modules from the public registry?

Yes, the skill provides guidance on testing local modules as well as those sourced from the Public Terraform Registry and HCP Terraform.

Can I share state between different test runs?

Yes, the skill explains how to use the 'state_key' attribute (since v1.9.0) to control state file isolation and sharing across run blocks.

Does this skill help with mocking providers?

Absolutely. It includes patterns for using mock_provider blocks (available since Terraform 1.7.0) to simulate provider behavior without creating real infrastructure.

Terraform Testing Framework

Name: Terraform Testing Framework
Author: hashicorp

byhashicorp

•

329

•

Security & Testing

Automates the creation and validation of Terraform test files to ensure infrastructure stability and code quality.

The Terraform Test skill provides a comprehensive framework for writing, executing, and troubleshooting Terraform tests using the native .tftest.hcl format introduced in version 1.6.0. It guides users through creating sophisticated test scenarios—including unit tests in plan mode and integration tests in apply mode—while leveraging advanced features like provider mocking, assertion blocks, and state management. This skill is essential for module authors and DevOps engineers who need to implement robust CI/CD practices for infrastructure as code by validating configurations before deployment.

Key Features

01Configure unit tests using plan mode and integration tests using apply mode

02Implement provider and data source mocking for isolated resource testing

03Generate .tftest.hcl files with standardized run and assert blocks

04Validate complex infrastructure logic with multi-condition assertions

05Manage variable overrides and state keys across sequential test runs

06329 GitHub stars

Use Cases

01Testing edge cases and input validation logic without deploying real resources via plan-mode unit tests

02Validating that a new Terraform module version doesn't introduce breaking changes

03Orchestrating multi-stage integration tests that share state across different infrastructure modules

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add hashicorp/agent-skills terraform-test

For use in Claude.ai and ChatGPT

Download Skill