Skip to main content
affpapa.org
RU EN
skill CX Codex

provider-framework-migration — Claude Code skill for Terraform

Guides per-resource migrations from Terraform Plugin SDKv2 to the Plugin Framework. Covers mux setup, schema translation, and state compatibility checks.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add hashicorp/agent-skills --skill provider-framework-migration -a claude-code
Open on GitHub

What provider-framework-migration does

This skill walks through migrating Terraform resources and data sources one at a time while a mux serves SDKv2 and Framework implementations side by side. It covers setting up terraform-plugin-mux with tf5to6server, translating schema elements, and checking resource behavior before and after the port.

It calls out null-versus-zero differences, blocks, the id attribute, and reading state written by SDKv2. Before changing a resource, the workflow has you prepare acceptance tests and record how optional attributes behave. The protocol 6 setup requires Terraform CLI 1.0 or later; the documented protocol 5 route is for Terraform 0.12+ support. That choice matters because nested attributes require protocol 6.

What it helps with

  • Configure a mux for SDKv2 and Framework implementations
  • Port one resource's schema and CRUD operations
  • Map ForceNew, Default, and blocks to Framework schema
  • Track plan changes caused by null and empty values
  • Verify state compatibility after a resource migration

Example prompts for the agent

  • Set up a mux server for a provider using SDKv2 and the Plugin Framework.
  • Help port this resource schema to the Plugin Framework while keeping its blocks and id attribute.
  • Investigate the plan diff after migration, focusing on null handling and state.

How to install provider-framework-migration

1Skills CLI (Vercel)

npx skills add hashicorp/agent-skills --skill provider-framework-migration -a claude-code

2Manually: put the files in place

~/.claude/skills/provider-framework-migration/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/provider-framework-migration/

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

Questions about provider-framework-migration

How do I install provider-framework-migration in Claude Code?

Run npx skills add hashicorp/agent-skills --skill provider-framework-migration -a claude-code. The skill file is placed at ~/.claude/skills/provider-framework-migration/SKILL.md.

What does provider-framework-migration do?

It guides Terraform resource and data source migrations from SDKv2 to the Plugin Framework, including mux setup and checks for schema and state compatibility.

What is required to serve a provider with protocol 6?

The described protocol 6 setup requires Terraform CLI 1.0 or later. For Terraform 0.12+ support, the skill describes a protocol 5 mux, which cannot use Framework features that require protocol 6.

Similar skills

All skills for DevOps and infrastructure →
wizard Matt Pocock This skill creates an interactive bash wizard for manual setup steps, CI secrets, third-party dashboards, and one-off migrations. 553,369installs hyperframes-cli heygen-com Controls HyperFrames video workflows from the CLI: audits layouts and contrast, edits timeline clips, captures snapshots, and renders locally or in cloud runtimes. CX Codex +1 1,300,000installs setup-pre-commit Matt Pocock This skill configures pre-commit checks for a JavaScript repository, running Prettier, type checking, and tests before each commit. 489,289installs using-git-worktrees Jesse Vincent Prepares an isolated workspace before feature work or plan execution. It checks the repository first, then uses native worktree support or Git. CX Codex 217,153installs finishing-a-development-branch Jesse Vincent This skill checks the test suite and guides branch completion: merge locally, open a Pull Request, or leave the work in place. CX Codex 214,439installs orca-cli stablyai The skill lets an agent manage Orca worktrees, terminals, artifacts and the built-in browser through the orca CLI. Useful when your work already runs inside Orca. CX Codex +1 353,600installs

From the same set20

aws-ami-builder A skill that walks your agent through building Amazon Machine Images with Packer and the amazon-ebs builder — template, source AMI filters, build commands. CX Codex +1 3,200installs provider-docs Guides Terraform provider documentation workflows for the Terraform Registry. It coordinates schema descriptions, docs templates, and tfplugindocs generation. CX Codex +1 3,200installs push-to-registry Teaches AI assistants how to register Packer build details in HCP. Useful for tracking machine image lifecycles and linking artifacts directly to Terraform. CX Codex +1 3,000installs windows-builder A skill for building Windows images with Packer over WinRM and PowerShell provisioners. Useful for Windows AMIs, Azure images and VMware templates. CX Codex +1 2,700installs azure-image-builder This skill guides Packer builds for Azure managed images and Azure Compute Gallery. Use it when preparing custom images for Azure virtual machines. CX Codex +1 2,700installs terraform-policy Creates and tests Terraform Policy files, and converts Sentinel rules into Terraform Policy. Use it when policy files or their test cases need changes. CX Codex +1 1,500installs provider-configuration Guides Terraform provider authentication and credential resolution. Use it when designing a provider schema, wiring Configure(), or investigating missing credentials. CX Codex +1 951installs provider-ephemeral-resources Walks a provider author through ephemeral resources on the Terraform Plugin Framework, where secrets reach the config and never land in state or plan. CX Codex +1 917installs

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor