Skip to content
cccskills
Official · HashiCorpFreePublished on GitHub

new-terraform-provider

Use this when scaffolding a new Terraform provider with the Plugin Framework: workspace layout, go module setup, provider server main.go, and a provider.go with schema and Configure. Also use when a user wants to start building a provider for a new API or asks how to begin a terraform-provider-* project.

The English summary is being prepared. Showing the original description.

Works withTerraform

Run score Not tested

See how to install

Files included (3)

  • SKILL.md1.8 KB
  • assets/main.go1.1 KB
  • assets/provider.go4.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

To scaffold a new Terraform provider with Plugin Framework:

  1. If I am already in a Terraform provider workspace, then confirm that I want to create a new workspace. If I do not want to create a new workspace, then skip all remaining steps.
  2. Create a new workspace root directory. The root directory name should be prefixed with "terraform-provider-". Perform all subsequent steps in this new workspace.
  3. Initialize a new Go module.
  4. Run go get -u github.com/hashicorp/terraform-plugin-framework@latest.
  5. Write a main.go file that follows the example.
  6. Write an internal/provider/provider.go file that follows the example. Rename the demo provider, the DEMO_* environment variables, and the authentication attributes to match the target API.
  7. Remove TODO comments from main.go and provider.go.
  8. Run go mod tidy
  9. Run go build -o /dev/null
  10. Run go test ./... The scaffold resolves credentials as explicit config with environment variable fallback. To grow that into a full credential provider chain (shared credentials files, profiles, platform identity, configure-time validation), use the provider-configuration skill (if available). To add the first resource or data source, use the provider-resources skill (if available).

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

aws-ami-builder

Official · HashiCorpFree

Build Amazon Machine Images (AMIs) with Packer using the amazon-ebs builder. Use when creating custom AMIs for EC2 instances.

The English summary is being prepared. Showing the original description.

hashicorp/agent-skills903Updated Oct 5, 2026

azure-image-builder

Official · HashiCorpFree

Build Azure managed images and Azure Compute Gallery images with Packer. Use when creating custom images for Azure VMs.

The English summary is being prepared. Showing the original description.

hashicorp/agent-skills903Updated Oct 5, 2026

azure-verified-modules

Official · HashiCorpFree

Azure Verified Modules (AVM) requirements and best practices for developing certified Azure Terraform modules. Use when creating or reviewing Azure modules that need AVM certification.

The English summary is being prepared. Showing the original description.

hashicorp/agent-skills903Updated Oct 5, 2026

provider-actions

Official · HashiCorpFree

Implement Terraform Provider actions using the Plugin Framework. Use when developing imperative operations that execute at lifecycle events (before/after create, update, destroy).

The English summary is being prepared. Showing the original description.

hashicorp/agent-skills903Updated Oct 5, 2026

provider-configuration

Official · HashiCorpFree

Implement Terraform provider configuration and authentication with the Plugin Framework: provider schema for credentials (Optional + Sensitive attributes), environment variable fallbacks, credential provider chains (static config, then environment variables, shared credentials file, and platform identity), unknown-value guards in Configure(), secret redaction, configure-time credential validation, and diagnostics that name every source tried. Use when implementing or reviewing a provider's Configure method or provider schema, adding authentication options (API keys, tokens, profiles, credentials files, assume-role), deciding how a provider should resolve credentials, debugging "no valid credential sources" or missing-credentials errors, or unit testing credential resolution.

The English summary is being prepared. Showing the original description.

hashicorp/agent-skills903Updated Oct 5, 2026

provider-docs

Official · HashiCorpFree

Create, update, and review Terraform provider documentation for Terraform Registry using HashiCorp-recommended patterns, tfplugindocs templates, and schema descriptions. Use when adding or changing provider configuration, resources, data sources, ephemeral resources, list resources, functions, actions, or guides; when validating generated docs; and when troubleshooting missing or incorrect Registry documentation.

The English summary is being prepared. Showing the original description.

hashicorp/agent-skills903Updated Oct 5, 2026

See all skills by hashicorp

Report a problem with this skill