Provider Resources

If you're building Terraform providers with the Plugin Framework, this walks you through the full lifecycle: schema design, CRUD operations, state management, and acceptance testing. It covers both the older SDKv2 pattern and the newer Plugin Framework approach with concrete examples of Create/Read/Update/Delete implementations. The guide shows you how to structure your resource files, use plan modifiers like RequiresReplace, handle attribute types from strings to nested objects, and wire up finder functions. It's reference material you'll keep open while implementing resources, especially useful when you're translating API operations into Terraform's declarative model and need to see the standard patterns for error handling and state updates.

skills.sh installs: 4.2K
GitHub stars: 924
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add hashicorp/agent-skills --skill provider-resources --agent claude-code

Installs into .claude/skills of the current project.

Files

Terraform Provider Resources Implementation Guide

Overview

This guide covers developing Terraform Provider resources and data sources. Resources represent infrastructure objects that Terraform manages through Create, Read, Update, and Delete (CRUD) operations.

Use the Plugin Framework for all net-new resources and data sources. Plugin SDKv2 is for maintaining resources that already exist on it; do not write new code against it. A provider can serve both during migration by muxing (terraform-plugin-mux), so adopting the Framework never requires a big-bang rewrite. To tell which mode an existing provider is in, check go.mod: terraform-plugin-mux present means it serves both SDKv2 and Framework code; only terraform-plugin-sdk/v2 means SDKv2-only; only terraform-plugin-framework means Framework-only. Be cautious about migrating existing SDKv2 resources: the Framework distinguishes null from zero values, so naive migrations change behavior for existing users (use the provider-framework-migration skill, if available).