Use this when scaffolding a new Terraform provider.
The new-terraform-provider skill automates the scaffolding process for creating a new Terraform provider using the HashiCorp Plugin Framework. It handles the complete setup workflow, from workspace creation to initial validation, ensuring developers start with a properly configured and working provider foundation. This skill eliminates the manual setup errors and configuration inconsistencies that often occur when initializing Terraform providers from scratch.
The skill performs comprehensive workspace initialization including Go module setup, dependency management with the latest terraform-plugin-framework, and code generation following HashiCorp's recommended patterns. It creates a standardized main.go file based on established examples, manages Go dependencies through go mod tidy, and validates the setup with build and test commands. The workflow includes safety checks to prevent accidental overwrites of existing provider workspaces.
This skill is designed for infrastructure engineers, DevOps practitioners, and platform teams building custom Terraform providers to manage internal services or third-party APIs. It accelerates provider development by reducing initial setup time from hours to minutes while ensuring compliance with Terraform's plugin architecture standards. The skill is particularly valuable for teams maintaining multiple providers or organizations standardizing their infrastructure-as-code tooling.
The skill will prompt you to confirm whether you want to create a new workspace. If you decline, the scaffolding process will be skipped entirely to prevent overwriting your existing work.
The skill installs the latest version of github.com/hashicorp/terraform-plugin-framework using the @latest tag, ensuring you start with the most current stable release.
You need Go installed on your system with a working Go environment. The skill will handle Go module initialization, dependency installation, and project setup automatically.
Yes, the skill validates the scaffolded code by running both go build and go test ./... to ensure the generated provider compiles successfully and passes initial tests before completion.
The workspace root directory is automatically prefixed with 'terraform-provider-' following HashiCorp's standard naming convention for Terraform providers.
Quick Setup:
.claude/skills/Repository
hashicorp/agent-skills