skill CX Codex

terraform-stacks — Claude Code skill: what it does, how to install

Q: How do I install terraform-stacks in Claude Code?

Run `npx skills add hashicorp/agent-skills --skill terraform-stacks -a claude-code`. The skill is placed in `~/.claude/skills/terraform-stacks/SKILL.md`.

Guides AI coding assistants through HashiCorp Terraform Stacks syntax, component definitions, and multi-environment deployment configs.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add hashicorp/agent-skills --skill terraform-stacks -a claude-code

Open on GitHub

What terraform-stacks does

This skill teaches coding assistants how to write HashiCorp Stacks configurations properly. Traditional Terraform modules sit beneath Stacks, which use their own HCL files named .tfcomponent.hcl and .tfdeploy.hcl. All configurations belong at the repository root. The skill clarifies how to wire components together from Git repositories, registry sources, or local module paths.

Stack syntax brings noticeable differences from standard Terraform. Providers accept a for_each argument and hold settings inside a config block, while block headers carry aliases. Variable definitions require a strict type attribute. Setting ephemeral = true prevents credentials from landing in state files.

Workload identity via OIDC is the recommended path for cloud access. Stacks CLI features fail on engines older than Terraform 1.13.x, which makes the root .terraform-version file mandatory before testing CLI runs.

What it helps with

write component declarations inside .tfcomponent.hcl files
configure multi-region deployments with .tfdeploy.hcl
set up ephemeral variables for cloud identity tokens
reference module sources across registries and Git repositories

Example prompts for the agent

Create a components.tfcomponent.hcl file referencing our VPC module in a private registry
Show how to configure an AWS provider with for_each and assume_role_with_web_identity
Validate this .tfdeploy.hcl setup for staging and production deployments

How to install terraform-stacks

1Skills CLI (Vercel)

npx skills add hashicorp/agent-skills --skill terraform-stacks -a claude-code

2Manually: put the files in place

~/.claude/skills/terraform-stacks/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/terraform-stacks/

1Skills CLI (Vercel)

npx skills add hashicorp/agent-skills --skill terraform-stacks -a codex

2Manually: put the files in place

.agents/skills/terraform-stacks/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add hashicorp/agent-skills --skill terraform-stacks -a cursor

2Manually: put the files in place

.cursor/skills/terraform-stacks/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install hashicorp/agent-skills terraform-stacks

2Manually: put the files in place

.github/skills/terraform-stacks/SKILL.md

1Skills CLI (Vercel)

npx skills add hashicorp/agent-skills --skill terraform-stacks -a gemini-cli

2Platform CLI

gemini skills install https://github.com/hashicorp/agent-skills --path plugins/terraform/skills/terraform-stacks

Manually: put the files in place

.devin/skills/terraform-stacks/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add hashicorp/agent-skills --skill terraform-stacks -a opencode

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about terraform-stacks

How do I install terraform-stacks in Claude Code?

Run npx skills add hashicorp/agent-skills --skill terraform-stacks -a claude-code. The skill is placed in ~/.claude/skills/terraform-stacks/SKILL.md.

What does terraform-stacks do?

It equips AI agents with syntax rules and file patterns for HashiCorp Terraform Stacks. The assistant can generate and review .tfcomponent.hcl and .tfdeploy.hcl definitions accurately.

Which Terraform release is required for Stacks?

You need Terraform 1.13.x or newer to run the Stacks CLI plugin. Set this version in your repository root inside a .terraform-version file.

terraform-skill Anton Babenko Guides Terraform and OpenTofu refactoring, state migrations, and CI workflows. Diagnoses risks like identity churn and blast radius before generating HCL. CX Codex +1 7,400installs terraform-patterns Alireza Rezvani Analyzes Terraform code for anti-patterns and scaffolds structured modules. Useful when hardening state backends or fixing security misconfigurations. 617installs terraform-generator akin-ozer This skill writes Terraform configs: resources, modules, providers, variables and outputs. Useful when you want infrastructure as code without hand-writing HCL. CX Codex +1 639installs terraform-validator akin-ozer Runs terraform fmt, validate, tflint and checkov over your .tf files, then writes a report with the findings. CX Codex +1 640installs huawei-cloud-terraform-installer huaweicloud This skill installs Terraform CLI on Linux and Windows, with Huawei Cloud mirror support for the provider. Use it when an IaC task finds Terraform missing. CX Codex +1 17,400installs huawei-cloud-terraform-generator huaweicloud Turns an infrastructure goal into a Huawei Cloud Terraform configuration, verifies resources against the target region, and deploys after your approval. CX Codex +1 17,000installs

From the same set20

terraform-style-guide A skill that generates and validates Terraform code according to HashiCorp's official standards. Ensures consistent, secure, and readable HCL across your configurations. CX Codex +1 12,600installs terraform-test Guides an agent through Terraform test files, scenarios, assertions, and plan or apply runs. Use it when checking modules, resources, and outputs. CX Codex +1 8,800installs refactor-module This skill turns a monolithic Terraform configuration into reusable modules with clear variables and outputs. Useful when one main.tf has grown too risky to touch. CX Codex +1 6,400installs terraform-search-import Discovers untracked cloud assets and sets up Terraform configuration for bulk state imports. Helpful during infrastructure migrations and audits. CX Codex +1 4,900installs provider-resources This skill guides Terraform resource and data source work with the Plugin Framework. Use it when adding resources, handling drift, or reviewing provider code. CX Codex +1 4,100installs provider-actions Guides implementation of Terraform Actions with the Plugin Framework for operations run around resource create, update, and destroy events. CX Codex +1 3,900installs new-terraform-provider A skill that walks the agent through bootstrapping a Terraform provider on the Plugin Framework, from directory layout to a passing build. CX Codex +1 3,900installs run-acceptance-tests Runs and investigates Terraform provider acceptance tests with the TestAcc prefix. Use it for missing environment variables, failed runs, or tests that pass when they should not. CX Codex +1 3,700installs