terraform-review — Claude Code skill: Terraform PR review
Walks Terraform changes through an 8-category checklist and returns a verdict: Approved, Needs Changes or Blocked. Useful before merging an infrastructure PR.
npx skills add c0x12c/ai-toolkit --skill terraform-review -a claude-codeWhat terraform-review does
The skill opens the changed .tf files in a pull request and works through eight sections: file structure, state safety, security, naming, modules, variables, providers, CI/CD. No section gets skipped. Every finding points at a file and a line.
You get back a structured report with a verdict and a per-category table. Blocking problems — secrets in code, missing state locking, 0.0.0.0/0 ingress, encryption turned off — sit apart from naming and style notes. The skill only has Read, Glob and Grep at its disposal, so it edits nothing and never runs terraform.
The checklist carries its own conventions: a live/, modules/, envs/ layout, one resource per file inside modules, prevent_destroy on critical resources, module versions pinned as ?ref=vX.Y.Z. A repo laid out differently will trip over some of those points, so compare the checklist against your own rules before making the skill part of mandatory review.
What it helps with
- catch secrets in
.tfvarsbefore the merge - confirm state lives in S3 with DynamoDB locking
- spot critical resources missing
prevent_destroy - check naming and tags across every resource in a module
- self-review your own PR before opening it
Example prompts for the agent
- Review the Terraform changes in this PR against the checklist
- Check
modules/rdsand list blocking issues separately - Run a self-review over my
.tffiles before I merge
How to install terraform-review
1Skills CLI (Vercel)
npx skills add c0x12c/ai-toolkit --skill terraform-review -a claude-code2Manually: put the files in place
~/.claude/skills/terraform-review/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/terraform-review/
1Skills CLI (Vercel)
npx skills add c0x12c/ai-toolkit --skill terraform-review -a codex2Manually: put the files in place
.agents/skills/terraform-review/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add c0x12c/ai-toolkit --skill terraform-review -a cursor2Manually: put the files in place
.cursor/skills/terraform-review/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install c0x12c/ai-toolkit terraform-review2Manually: put the files in place
.github/skills/terraform-review/SKILL.md1Skills CLI (Vercel)
npx skills add c0x12c/ai-toolkit --skill terraform-review -a gemini-cli2Platform CLI
gemini skills install https://github.com/c0x12c/ai-toolkit --path toolkit/skills/terraform-reviewManually: put the files in place
.devin/skills/terraform-review/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add c0x12c/ai-toolkit --skill terraform-review -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about terraform-review
How do I install terraform-review in Claude Code?
Run npx skills add c0x12c/ai-toolkit --skill terraform-review -a claude-code. The skill lands at ~/.claude/skills/terraform-review/SKILL.md.
What does terraform-review do?
It checks Terraform changes against an 8-category checklist and returns Approved, Needs Changes or Blocked. Findings name the file and line.
Which tools can the skill use?
Read, Glob and Grep only. It makes no edits and does not run terraform commands.
