provider-actions — Claude Code skill: Terraform Actions
Guides implementation of Terraform Actions with the Plugin Framework for operations run around resource create, update, and destroy events.
npx skills add hashicorp/agent-skills --skill provider-actions -a claude-codeWhat provider-actions does
This skill guides Terraform Provider work where an imperative action must run around a resource lifecycle event. It covers first-action setup: ProviderWithActions, passing ActionData from Configure, a configurable action base type, and schema helpers for shared attributes.
It lays out implementation, test, and documentation locations, then covers action schemas and Invoke. The guide calls out mismatched framework types, missing ElementType on list or map fields, incorrect Optional and Computed settings, and validator imports. It also advises progress events, API timeouts through context.WithTimeout(), and diagnostics for failures.
Terraform Actions are described as experimental. That is a reason to check Provider support before changing schemas. The skill also points to go build as a check for type errors.
What it helps with
- add a Terraform action around a resource lifecycle event
- prepare a Provider for its first Action
- define action fields with correct schema types
- report progress during a long-running operation
- surface API failures through Provider diagnostics
Example prompts for the agent
- Add a Terraform Action that runs after a resource is created.
- Prepare this Provider for its first Action using
ProviderWithActionsandActionData. - Review this Action schema for field types,
ElementType, andComputedsettings.
How to install provider-actions
1Skills CLI (Vercel)
npx skills add hashicorp/agent-skills --skill provider-actions -a claude-code2Manually: put the files in place
~/.claude/skills/provider-actions/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/provider-actions/
1Skills CLI (Vercel)
npx skills add hashicorp/agent-skills --skill provider-actions -a codex2Manually: put the files in place
.agents/skills/provider-actions/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add hashicorp/agent-skills --skill provider-actions -a cursor2Manually: put the files in place
.cursor/skills/provider-actions/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install hashicorp/agent-skills provider-actions2Manually: put the files in place
.github/skills/provider-actions/SKILL.md1Skills CLI (Vercel)
npx skills add hashicorp/agent-skills --skill provider-actions -a gemini-cli2Platform CLI
gemini skills install https://github.com/hashicorp/agent-skills --path plugins/terraform/skills/provider-actionsManually: put the files in place
.devin/skills/provider-actions/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add hashicorp/agent-skills --skill provider-actions -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about provider-actions
How do I install provider-actions in Claude Code?
Run npx skills add hashicorp/agent-skills --skill provider-actions -a claude-code, then run npx skills add hashicorp/agent-skills --skill provider-actions -a claude-code again. The skill file is placed at ~/.claude/skills/provider-actions/SKILL.md.
What does provider-actions do?
It guides Terraform Action implementation with the Plugin Framework for operations tied to create, update, and destroy lifecycle events. It covers Provider setup, schemas, invocation, progress messages, timeouts, and error diagnostics.
What is needed for the first Action in a Provider?
Implement ProviderWithActions with an Actions() method and set ActionData in Configure. Providers using configurable base types or shared schema attributes need matching Action variants.
