provider-framework-migration

Migrate Terraform provider resources and data sources from Plugin SDKv2 to the Plugin Framework: muxing both plugins in one provider (terraform-plugin-mux, tf5to6server), per-resource migration workflow, SDKv2-to-Framework schema mapping (ForceNew, ValidateFunc, DiffSuppressFunc, Default, Timeouts, blocks), null-vs-zero-value behavioral traps, and state-compatibility verification. Use when converting or translating SDKv2 resources to the Framework, setting up a muxed provider server, deciding whether a resource should be migrated at all, or debugging plan diffs and state errors that appeared after a migration.

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A tightly structured, highly actionable migration guide with a clear sequenced workflow, strong validation checkpoints, and proper progressive disclosure of the schema-mapping reference. Minor conciseness gains are possible around the inline code block.

Dimension	Reasoning	Score
Conciseness	Dense and assumes Terraform competence without padding, but the full main.go block and a few explanatory/related-skills sentences could be trimmed slightly; mostly efficient with minor over-explanation.	4 / 5
Actionability	Provides copy-paste-ready executable main.go mux code plus concrete, named patterns (ExternalProviders, ProtoV6ProviderFactories, ConfigPlanChecks, StateUpgrader) and a real translation-table reference covering common cases.	5 / 5
Workflow Clarity	Clear 5-step sequence (Mux, Baseline, Port, Move registration, Verify) with explicit validation checkpoints (ImportStateVerify, empty-plan check against prior release) and a closing checklist; the destructive migration has thorough verification so no cap applies.	5 / 5
Progressive Disclosure	SKILL.md is a concise overview that signals one-level-deep detail via 'references/schema-mapping.md' (a real, verified file), with the bulk translation table appropriately split out and easy navigation.	5 / 5
	Total	19 / 20 Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A precise, well-scoped description that names concrete capabilities and provides explicit, multi-sentence 'Use when' trigger guidance. Only slightly lacking in synonym breadth for its specialized domain.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — muxing plugins (terraform-plugin-mux, tf5to6server), per-resource migration workflow, schema mapping with named SDKv2 constructs (ForceNew, ValidateFunc, DiffSuppressFunc, Default, Timeouts, blocks), null-vs-zero traps, and state-compatibility verification — giving comprehensive coverage.	5 / 5
Completeness	Explicitly answers both 'what' (mux setup, per-resource workflow, schema mapping, behavioral traps, verification) and 'when' with a concrete 'Use when' clause enumerating multiple trigger scenarios.	5 / 5
Trigger Term Quality	Provides good natural trigger phrasings users would say ('converting or translating SDKv2 resources to the Framework', 'setting up a muxed provider server', 'deciding whether a resource should be migrated at all', 'debugging plan diffs and state errors'), though the domain is specialized enough that a few additional synonyms could be added.	4 / 5
Distinctiveness Conflict Risk	Targets a clear narrow niche (SDKv2-to-Plugin-Framework migration) with distinct triggers and minimal overlap risk with other Terraform skills.	5 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: hashicorp/agent-skills
Path: plugins/terraform/skills/provider-framework-migration/SKILL.md
Commit: 3268468

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.