Terraform & OpenTofu Skill for AI Agents
Terraform and OpenTofu best-practices skill for AI coding agents (Claude Code, Cursor, Copilot, Gemini CLI, OpenCode, Codex, and others). Covers testing strategies, module patterns, CI/CD workflows, and production infrastructure code.
What this skill provides
Testing frameworks
- Decision matrix for native tests vs Terratest
- Testing workflows (static, integration, E2E)
- Examples and patterns
Module development
- Structure and naming conventions
- Versioning strategies
- Public vs private module patterns
State management
- Remote backends (S3, Azure, GCS, Terraform Cloud)
- Locking and security
- Multi-team state isolation
- Migration and recovery procedures
CI/CD integration
- GitHub Actions workflows
- GitLab CI examples
- Cost optimization
- Compliance automation
Security and compliance
- Trivy and Checkov integration
- Policy-as-code patterns
- Compliance scanning workflows
Quick reference
- Decision flowcharts
- Common patterns (DO vs DON'T)
- Cheat sheets
Installation
This plugin is distributed via Claude Code marketplace using .claude-plugin/marketplace.json.
Quick install (any agent)
Universal installer via skills.sh — works with any Agent Skills-compatible tool:
npx skills add https://github.com/antonbabenko/terraform-skill
Per-host instructions
Claude Code
/plugin marketplace add antonbabenko/terraform-skill
/plugin install terraform-skill@antonbabenko
Gemini CLI
gemini extensions install https://github.com/antonbabenko/terraform-skill
Update with gemini extensions update terraform-skill.
Cursor
git clone https://github.com/antonbabenko/terraform-skill.git ~/.cursor/skills/terraform-skill
Cursor auto-discovers skills from .agents/skills/ and .cursor/skills/.
Copilot
/plugin install https://github.com/antonbabenko/terraform-skill
# or
git clone https://github.com/antonbabenko/terraform-skill.git ~/.copilot/skills/terraform-skill
Copilot auto-discovers skills from .copilot/skills/.
OpenCode
git clone https://github.com/antonbabenko/terraform-skill.git ~/.agents/skills/terraform-skill
OpenCode auto-discovers skills from .agents/skills/, .opencode/skills/, and .claude/skills/.
Codex (OpenAI)
git clone https://github.com/antonbabenko/terraform-skill.git ~/.agents/skills/terraform-skill
Codex auto-discovers skills from ~/.agents/skills/ and .agents/skills/. Update with cd ~/.agents/skills/terraform-skill && git pull.
Antigravity
git clone https://github.com/antonbabenko/terraform-skill.git ~/.antigravity/skills/terraform-skill
Update with cd ~/.antigravity/skills/terraform-skill && git pull.
Manual (symlink local clone)
git clone https://github.com/antonbabenko/terraform-skill
mkdir -p ~/.claude/plugins
ln -s "$(pwd)/terraform-skill" ~/.claude/plugins/terraform-skill
Claude Code autodiscovers the skill at skills/terraform-skill/SKILL.md on next launch. Edits to the clone are picked up live.
Verify installation
After installation, try:
"Create a Terraform module with testing for an S3 bucket"
Claude picks up the skill automatically when working with Terraform or OpenTofu code.
Quick start examples
Create a module with tests:
"Create a Terraform module for AWS VPC with native tests"
Set up remote state:
"Configure S3 backend with DynamoDB locking for Terraform state"
Review existing code:
"Review this Terraform configuration following best practices"
Generate CI/CD workflow:
"Create a GitHub Actions workflow for Terraform with cost estimation"
Testing strategy:
"Help me choose between native tests and Terratest for my modules"
State management:
"How should I organize state files for a multi-team environment?"
What it covers
Testing strategy
Decision matrices for native tests (Terraform 1.6+) vs Terratest (Go-based), plus multi-environment testing patterns.
Module development