Does this skill follow HashiCorp's official best practices?

Yes, it adheres to HashiCorp's module design principles, including proper variable validation, output documentation, and the separation of cross-cutting concerns.

Does it support the latest Terraform testing features?

Yes, it is designed to implement testing patterns compatible with Terraform 1.6+ (.tftest.hcl) and can leverage mock providers introduced in version 1.7.

Can it identify which resources should be grouped together?

Absolutely. The analysis phase identifies resources with shared lifecycles, tight coupling (like VPCs and subnets), and repeated patterns to suggest optimal module boundaries.

How does this skill handle existing Terraform state?

The skill generates a comprehensive state migration plan, providing either modern 'moved' blocks for Terraform 1.1+ or the specific 'terraform state mv' commands required to preserve your infrastructure history.

Terraform Module Refactorer

Name: Terraform Module Refactorer
Author: hashicorp

byhashicorp

•

329

•

Deployment & DevOps

Transforms monolithic Terraform configurations into reusable, maintainable modules following HashiCorp's design principles and community best practices.

This skill empowers Claude to systematically analyze and decompose large, complex Terraform files into a clean, modular architecture. It guides the agent through the entire refactoring lifecycle: identifying resource groupings, defining strict input/output contracts with validation, and implementing encapsulation strategies. Beyond code transformation, it handles the critical task of state management by generating migration plans using modern moved blocks or state commands, ensuring infrastructure stability while improving code reusability and maintainability.

Key Features

01Integrated documentation generation following registry standards

02329 GitHub stars

03Support for modern Terraform testing frameworks and mock providers

04State migration planning using Terraform 1.1+ 'moved' blocks

05Standardized HCL module generation with typed variables and outputs

06Automated analysis of resource dependencies and configuration coupling

Use Cases

01Converting a single-file 'main.tf' into a multi-tier, environment-ready module library

02Reducing technical debt in legacy Terraform codebases without losing existing state

03Standardizing infrastructure patterns to prepare code for a Private Module Registry

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add hashicorp/agent-skills refactor-module

For use in Claude.ai and ChatGPT

Download Skill