provider-actions

Implement Terraform Provider actions with the Plugin Framework.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/benonions/dotfiles --skill provider-actions-benonions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: provider-actions
Source: https://github.com/benonions/dotfiles/tree/main/codex/.codex/skills/community/hashicorp-agent-skills/terraform/provider-development/skills/provider-actions
Command: npx skills add https://github.com/benonions/dotfiles --skill provider-actions-benonions

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a comprehensive guide for implementing imperative operations within Terraform Providers using the Plugin Framework, enabling actions at specific lifecycle events.

Core Features & Use Cases

  • Action Schema Definition: Learn how to define schemas for actions, including common pitfalls and validation checklists.
  • Action Invoke Method: Understand the structure and requirements for the Invoke method, including progress reporting, timeout management, and error handling.
  • Provider SDK Integration: Guidance on integrating with provider SDK clients and handling common patterns like batch operations and command execution.
  • Use Case: A provider developer needs to implement a new action that triggers a complex provisioning workflow after a resource is created, requiring detailed progress updates and robust error handling.

Quick Start

Refer to the Terraform Actions RFC for detailed specifications on implementing provider actions.

Frequently Asked Questions about provider-actions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I implement imperative operations in a Terraform provider using the Plugin Framework?

Define action schemas and structure the Invoke method using the Plugin Framework to execute imperative operations like batch processing during Terraform lifecycle events.

What are Terraform provider actions and when do I need them?

Terraform provider actions handle imperative operations during lifecycle events, used to trigger complex provisioning workflows, batch operations, and command execution outside standard resource creation.

How do I handle progress reporting and error handling in Terraform action Invoke methods?

Implement progress reporting, timeout management, and error handling within the Invoke method while applying schema validation checklists to prevent common design pitfalls during provider SDK integration.

Does the Terraform Plugin Framework support batch operations and command execution for lifecycle events?

The Plugin Framework supports batch operations and command execution by integrating provider SDK clients within the Invoke method to manage complex imperative workflows during lifecycle events.

What are common schema design pitfalls when defining Terraform provider actions?

Common schema design pitfalls for provider actions include missing validation checklists and inadequate error handling structures, which disrupt Invoke method execution, SDK integration, and progress reporting.

What testing strategies should I use for Terraform provider actions?

Test Terraform provider actions by validating schema definitions, verifying Invoke method progress reporting, and checking error handling and timeout management during provider SDK integration for robust imperative operations.