Terraform and OpenTofu Guide
agentscope-ai/QwenPaw
Guidance for writing and testing Terraform and OpenTofu code: module structure, naming, test approaches, CI/CD workflows, state handling and security scanning.
Terraform state migration workflow with tfmigrate in Atmos: writing migration HCL, running atmos terraform migrate plan/apply/list, wiring kind: tfmigrate hooks, configuring history mode, and…
$ npx skills add cloudposse/atmos --skill atmos-terraform-state-migrations -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install cloudposse/atmos atmos-terraform-state-migrations --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/cloudposse/atmos.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agent-skills/skills/atmos-terraform-state-migrations .claude/skills/atmos-terraform-state-migrations && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "atmos-terraform-state-migrations" agent skill from https://github.com/cloudposse/atmos/tree/main/agent-skills/skills/atmos-terraform-state-migrations into .claude/skills/atmos-terraform-state-migrations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "atmos-terraform-state-migrations", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/cloudposse/atmos/tree/main/agent-skills/skills/atmos-terraform-state-migrationsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add cloudposse/atmos --skill atmos-terraform-state-migrations -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install cloudposse/atmos atmos-terraform-state-migrations --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cloudposse/atmos.git skills-src && mkdir -p .agents/skills && cp -r skills-src/agent-skills/skills/atmos-terraform-state-migrations .agents/skills/atmos-terraform-state-migrations && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "atmos-terraform-state-migrations" agent skill from https://github.com/cloudposse/atmos/tree/main/agent-skills/skills/atmos-terraform-state-migrations into .agents/skills/atmos-terraform-state-migrations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "atmos-terraform-state-migrations", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add cloudposse/atmos --skill atmos-terraform-state-migrations -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install cloudposse/atmos atmos-terraform-state-migrations --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cloudposse/atmos.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/agent-skills/skills/atmos-terraform-state-migrations .cursor/skills/atmos-terraform-state-migrations && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "atmos-terraform-state-migrations" agent skill from https://github.com/cloudposse/atmos/tree/main/agent-skills/skills/atmos-terraform-state-migrations into .cursor/skills/atmos-terraform-state-migrations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "atmos-terraform-state-migrations", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/cloudposse/atmos.git --path agent-skills/skills/atmos-terraform-state-migrations--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add cloudposse/atmos --skill atmos-terraform-state-migrations -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install cloudposse/atmos atmos-terraform-state-migrations --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cloudposse/atmos.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/agent-skills/skills/atmos-terraform-state-migrations .gemini/skills/atmos-terraform-state-migrations && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "atmos-terraform-state-migrations" agent skill from https://github.com/cloudposse/atmos/tree/main/agent-skills/skills/atmos-terraform-state-migrations into .gemini/skills/atmos-terraform-state-migrations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "atmos-terraform-state-migrations", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install cloudposse/atmos atmos-terraform-state-migrationsInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add cloudposse/atmos --skill atmos-terraform-state-migrations -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/cloudposse/atmos.git skills-src && mkdir -p .github/skills && cp -r skills-src/agent-skills/skills/atmos-terraform-state-migrations .github/skills/atmos-terraform-state-migrations && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "atmos-terraform-state-migrations" agent skill from https://github.com/cloudposse/atmos/tree/main/agent-skills/skills/atmos-terraform-state-migrations into .github/skills/atmos-terraform-state-migrations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "atmos-terraform-state-migrations", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add cloudposse/atmos --skill atmos-terraform-state-migrations -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install cloudposse/atmos atmos-terraform-state-migrations --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cloudposse/atmos.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/agent-skills/skills/atmos-terraform-state-migrations .opencode/skills/atmos-terraform-state-migrations && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "atmos-terraform-state-migrations" agent skill from https://github.com/cloudposse/atmos/tree/main/agent-skills/skills/atmos-terraform-state-migrations into .opencode/skills/atmos-terraform-state-migrations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "atmos-terraform-state-migrations", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
atmos-terraform-state-migrationsTerraform state migration workflow with tfmigrate in Atmos: writing migration HCL, running atmos terraform migrate plan/apply/list, wiring kind: tfmigrate hooks, configuring history mode, and…
Atmos Terraform State Migrations is an agent skill from cloudposse/atmos. Terraform state migration workflow with tfmigrate in Atmos: writing migration HCL, running atmos terraform migrate plan/apply/list, wiring kind: tfmigrate hooks, configuring history mode, and handling state refactors, rerun safety, workspace context, backend history variables, and CI-safe migrations.
Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/tfmigrate-migration-patterns.md`).
It sits in DevOps & Cloud, covering Infrastructure as code. It works with Terraform. The repository describes itself as: Atmos is the open-source runtime for infrastructure — it builds, authenticates, and ships Terraform, OpenTofu, Packer, Ansible, Kubernetes, Helm, and containers the same way on… The licence is Apache-2.0.
6 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit 110e139. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash, hcl and yaml).
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names these keys or tokens, usually read from environment variables:
ATMOS_TFMIGRATE_HISTORY_KEYFrom names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Atmos Terraform State Migrations loads about 1.7k tokens when it runs, and up to ~3.3k if it reads all its reference files. Until then it costs about 84 tokens; SKILL.md has 591 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from cloudposse/atmos at commit 110e139, republished under its Apache-2.0 licence (© cloudposse). 591 words, ~1,666 tokens.
.claude/skills/atmos-terraform-state-migrations/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.Use this skill when creating or reviewing Terraform state migrations for Atmos components. Atmos delegates state
migrations to tfmigrate. It runs tfmigrate in the same component context as atmos terraform plan and apply.
Before tfmigrate runs, Atmos performs auth identity setup, source and workdir provisioning, backend and varfile
generation, Terraform init, workspace selection, toolchain resolution, and TFMIGRATE_EXEC_PATH setup.
For migration HCL syntax and examples, load references/tfmigrate-migration-patterns.md.
Never guess stack names, component names, workspaces, backend paths, or state addresses.
atmos describe component <component> -s <stack>
atmos terraform migrate list <component> -s <stack>
atmos terraform state list <component> -s <stack>Use the resolved component output to confirm:
kind: tfmigrate hook already existsatmos terraform migrate listUse atmos terraform state show <component> -s <stack> <address> when resource identity or import IDs are unclear.
If a refactor can be handled with Terraform moved blocks and stays in the same state, prefer that unless the user
specifically needs tfmigrate automation or multi-state moves.
Create a migration file in a project-owned migrations directory, then preview it before applying. tfmigrate
resolves --migration relative to the migration_dir in its config. The Atmos-generated default config points
migration_dir at the component's migrations/ directory when one exists. Pass just the filename, not a
migrations/-prefixed path.
atmos terraform migrate plan <component> -s <stack> --migration 20260527090000_refactor_vpc.hcl
atmos terraform migrate apply <component> -s <stack> --migration 20260527090000_refactor_vpc.hclFor multiple selected component instances:
atmos terraform migrate plan --components vpc,eks -s <stack> --migration 20260527090000_refactor.hcl
atmos terraform migrate plan --query '.settings.requires_migration == true' --tfmigrate-config .tfmigrate.hcl
atmos terraform migrate plan --affected --migration 20260527090000_refactor.hclDo not run apply until plan succeeds and the Terraform plan after migration does not show unintended destroy/create
changes. --affected does not support --include-dependents for migrate.
Use tfmigrate HCL for state operations that need reviewable, repeatable files. A migration file contains exactly one
migration block.
migration "state" "rename_subnet" {
actions = [
"mv aws_subnet.private aws_subnet.private_primary",
]
}Common actions:
mv <source> <destination> for renames and module/address moves in one state.rm <addresses>... for removing state bindings without destroying infrastructure.import <address> <id> for binding existing infrastructure.replace-provider <from> <to> for provider address migrations.xmv <source-pattern> <destination-pattern> for wildcard moves.migration "multi_state" for moving resources between component directories or state files.Keep migration filenames sortable, usually with a timestamp prefix. In history mode, unapplied migrations are processed in filename order.
Use hooks when the migration should run as part of normal plan, apply, or deploy workflows.
components:
terraform:
s3-bucket:
dependencies:
tools:
tfmigrate: "0.4.x"
hooks:
state-migration:
events:
- before.terraform.plan
- before.terraform.apply
kind: tfmigrate
migration: 20260527090000_remove_template_provider.hcl
mode: dynamicmode: dynamic is the default. before.terraform.plan runs tfmigrate plan. before.terraform.apply and
before.terraform.deploy run tfmigrate apply. Use mode: plan or mode: apply only when the hook must always run
one action.
Hook fields:
migration: path to one migration file.config: path to .tfmigrate.hcl; omit migration when using history mode.backend_config: entries passed as repeated tfmigrate --backend-config flags for the Terraform state backend.mode: dynamic, plan, or apply.Single-file tfmigrate apply path.hcl is not idempotent. A rerun can fail if a source address already moved, or an
address was already removed. For CI-safe reruns, use tfmigrate history mode with durable storage.
hooks:
state-migration:
events:
- before.terraform.plan
- before.terraform.apply
kind: tfmigrate
config: .tfmigrate.hcl
mode: dynamicAtmos exposes helper variables for .tfmigrate.hcl:
tfmigrate {
migration_dir = "./tfmigrate"
history {
storage "s3" {
bucket = env.ATMOS_TFMIGRATE_HISTORY_BUCKET
key = env.ATMOS_TFMIGRATE_HISTORY_KEY
region = env.ATMOS_TFMIGRATE_HISTORY_REGION
role_arn = env.ATMOS_TFMIGRATE_HISTORY_ROLE_ARN
}
}
}The default history key is tfmigrate/<stack>/<component>/<workspace>/history.json. Atmos passes history settings to
tfmigrate, but does not persist or repair history itself. Configure durable S3, GCS, or CI-persisted local storage.
Before committing migration work:
atmos terraform state list, not from code names alone.atmos terraform migrate plan and inspect the post-migration Terraform plan.© cloudposse, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 1 other file (references) in agent-skills/skills/atmos-terraform-state-migrations of cloudposse/atmos.
Open the folder on GitHubat commit 110e139
Atmos Terraform State Migrations next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Atmos Terraform State Migrations this skillcloudposse/atmos | 1.4k | — | ~1.7k | Automated safety check: Pass | Apache-2.0 | |
| Terraform and OpenTofu Guideagentscope-ai/QwenPaw | 36k | 6 repos | ~4.2k | Automated safety check: Pass | Apache-2.0 | |
| Terraform Skillantonbabenko/terraform-skill | 2.4k | 1 repos | ~5.1k | Automated safety check: Pass | Apache-2.0 | |
| Review Docshashicorp/terraform-provider-aws | 11k | — | ~1.3k | Automated safety check: Pass | MPL-2.0 | |
| Senior DevOps Toolkitmaslennikov-ig/claude-code-orchestrator-kit | 260 | 6 repos | ~1.1k | Automated safety check: Notes | Custom licence | |
| Cloudflarehodgef/apiker | 127 | 7 repos | ~2.2k | Automated safety check: Pass | MIT |
agentscope-ai/QwenPaw
Guidance for writing and testing Terraform and OpenTofu code: module structure, naming, test approaches, CI/CD workflows, state handling and security scanning.
antonbabenko/terraform-skill
A skill your agent uses when writing, reviewing, or debugging Terraform/OpenTofu modules, tests, CI, scans, or state ops - diagnoses failure mode (identity churn, secrets, blast radius, CI drift…
hashicorp/terraform-provider-aws
Review a Terraform AWS Provider PR's end-user documentation (website/docs//.markdown): whether docs are needed, description openings, argument/attribute style, section structure, tags wording, code…
maslennikov-ig/claude-code-orchestrator-kit
Comprehensive DevOps skill for CI/CD, infrastructure automation, containerization, and cloud platforms (AWS, GCP, Azure). Includes pipeline setup…
hodgef/apiker
Comprehensive Cloudflare platform skill covering Workers, Pages, storage (KV, D1, R2), AI (Workers AI, Vectorize, Agents SDK), feature flags (Flagship), networking (Tunnel, Spectrum), security (WAF…
patrickchugh/terravision
Draw cloud architecture diagrams for AWS, Azure or GCP with the official provider icon sets, using TerraVision.
cloudposse/atmos
A skill your agent uses when implementing, finishing, documenting, or reviewing a fix, repair, remediation, bug fix, debug-and-fix task, workflow fix, infrastructure fix, or any change that should…
cloudposse/atmos
Atmos Terraform linting with TFLint: standalone atmos terraform lint, component-aware config discovery and toolchain versions, TFLint rule configuration, and lifecycle hooks/CI findings.
cloudposse/atmos
Blog post authoring for Atmos: MDX template, frontmatter, website/blog/tags.yml and authors.yml rules, problem-first framing, backtick-opening ban, optional cast embeds, and no-Go-internals leakage.
cloudposse/atmos
Decide whether a PR's new or changed default needs edition-journal handling (pkg/edition, docs/prd/editions.md), and do the mechanical work if so: journal entries, the four-layer default check…
cloudposse/atmos
Migrate to Atmos from native Terraform, Terraform Workspaces, Terramate, Terragrunt, Make, Just, or Task; migrate tool versions from mise or Aqua CLI; migrate AWS/GCP/Azure CLI configs, Leapp…
cloudposse/atmos
Start an hourly background loop that keeps the current branch's PR rebased, its addressed CodeRabbit threads resolved, its CI checks passing, its lint clean, its tests passing with adequate patch…
Works with
Categories
Terraform state migration workflow with tfmigrate in Atmos: writing migration HCL, running atmos terraform migrate plan/apply/list, wiring kind: tfmigrate hooks, configuring history mode, and…. Atmos Terraform State Migrations is an agent skill from cloudposse/atmos. Terraform state migration workflow with tfmigrate in Atmos: writing migration HCL, running atmos terraform migrate plan/apply/list, wiring kind: tfmigrate hooks, configuring history mode, and handling state refactors, rerun safety, workspace context, backend history variables, and CI-safe migrations.
Atmos Terraform State Migrations fits situations like: tasks that involve Infrastructure as code.
Run `npx skills add cloudposse/atmos --skill atmos-terraform-state-migrations -a claude-code`. Or copy the skill folder (agent-skills/skills/atmos-terraform-state-migrations in cloudposse/atmos) into .claude/skills/atmos-terraform-state-migrations in your project. Claude Code loads it when a task matches its description.
Run `npx skills add cloudposse/atmos --skill atmos-terraform-state-migrations -a codex`. Or copy the skill folder (agent-skills/skills/atmos-terraform-state-migrations in cloudposse/atmos) into .agents/skills/atmos-terraform-state-migrations in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add cloudposse/atmos --skill atmos-terraform-state-migrations -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/atmos-terraform-state-migrations, .gemini/skills/atmos-terraform-state-migrations, .github/skills/atmos-terraform-state-migrations and .opencode/skills/atmos-terraform-state-migrations in your project.
Going by SKILL.md and its folder, Atmos Terraform State Migrations needs credentials named ATMOS_TFMIGRATE_HISTORY_KEY. Our summary lists: A credential in ATMOS_TFMIGRATE_HISTORY_KEY.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Atmos Terraform State Migrations is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.7k tokens (SKILL.md is roughly 6.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.6k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Atmos Terraform State Migrations: Terraform and OpenTofu Guide (agentscope-ai/QwenPaw, 36k stars), Terraform Skill (antonbabenko/terraform-skill, 2.4k stars), Review Docs (hashicorp/terraform-provider-aws, 11k stars) and Senior DevOps Toolkit (maslennikov-ig/claude-code-orchestrator-kit, 260 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
cloudposse (a GitHub organization) maintains it in cloudposse/atmos, which has 1,398 GitHub stars. The repository holds 70 skills in this directory. The repository was last updated on October 10, 2026.
Source: cloudposse/atmos on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.