)
)
Explore how Terramate can uplift your IaC projects with a free trial or personalized demo.
Today, we’re happy to announce the Terramate Agent Skills for Terraform, OpenTofu and Terramate, a collection of best practices when managing IaC at scale.
These skills are opinionated best practices we have collected since we started Terramate, and they help you write, maintain, automate, and test your IaC faster with AI Agents such as Opencode, Cursor, Codex, and Claude Code. They also provide another layer of integration with Terramate Cloud via Terramate CLI and Catalyst, in addition to the Terramate MCP Server.
What Skills are available?
The library provides two packages: Terraform and OpenTofu best practices, and Terramate best practices, which can be used together or independently.
Terramate Best Practices
Terraform and OpenTofu best practices and guidelines. Contains 37 rules across 10 categories, prioritized by impact.
Use when:
- Writing new Terraform modules or configurations
- Implementing infrastructure patterns (AWS, GCP, Azure)
- Reviewing code for security and reliability issues
- Optimizing state management and performance
- Refactoring existing Terraform code
Categories covered:
- Organization & Workflow (Critical)
- State Management (Critical)
- Security Best Practices (Critical)
- Module Design (High)
- Resource Organization (Medium-High)
- Variable & Output Patterns (Medium)
- Language Best Practices (Medium)
- Provider Configuration (Medium)
- Performance Optimization (Low-Medium)
- Testing & Validation (Low)
Terraform and OpenTofu Best Practices
Terramate CLI, Cloud, and Catalyst best practices and usage guides. Contains 15+ rules across 8 categories for stack management, orchestration, code generation, and Cloud integration.
Use when:
- Creating and organizing Terramate stacks
- Orchestrating commands across multiple stacks
- Create Catalyst bundles and components from existing Terraform modules
- Scaffold complex multi-state architectures using Catalyst
- Using code generation to keep configurations DRY
- Integrating with Terramate Cloud for observability
- Creating Catalyst components and bundles
- Setting up CI/CD workflows with Terramate
Categories covered:
- CLI Fundamentals (Critical)
- CLI Orchestration (High)
- CLI Code Generation (High)
- CLI Configuration (Medium-High)
- Terramate Cloud (Medium-High)
- Terramate Catalyst (Medium)
- CI/CD Integration (Medium)
- Advanced Patterns (Low-Medium)
Installation
npx skills add terramate-io/agent-skillsUsage
Skills are automatically available once installed. The agent will use them when relevant tasks are detected.
Examples:
Create an S3 Bucket from the available Terramate BundlesFix the drifted stacks in this repositoryRefactor this Terraform configuration to use modulesCheck out the agent-skill repository. Also, please don’t hesitate to reach out for questions or suggestions. The best place to reach us is the Terramate community on Discord.