Implement Terraform Provider actions using the Plugin Framework. Use when developing imperative operations that execute at lifecycle events (before/after create, update, destroy).
Install with Tessl CLI
npx tessl i github:hashicorp/agent-skills --skill provider-actions97
Quality
76%
Does it follow best practices?
Impact
99%
6.18xAverage score across 15 eval scenarios
Optimize this skill with Tessl
npx tessl skill review --optimize ./terraform/provider-development/skills/provider-actions/SKILL.mdQuality
Discovery
75%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a reasonably well-crafted description for a specialized Terraform skill. It has strong completeness with explicit 'Use when' guidance and good distinctiveness for its niche. However, it could benefit from more specific concrete actions and additional natural trigger terms that developers might use when seeking this functionality.
Suggestions
Add specific concrete actions like 'create pre-destroy hooks', 'implement post-create callbacks', or 'handle update lifecycle logic' to improve specificity.
Include additional trigger term variations such as 'terraform plugin', 'provider development', 'resource hooks', or 'lifecycle callbacks' to improve discoverability.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Terraform Provider, Plugin Framework) and mentions 'imperative operations' and 'lifecycle events', but doesn't list specific concrete actions like 'create custom actions', 'handle destroy callbacks', or 'implement pre-update hooks'. | 2 / 3 |
Completeness | Clearly answers both what ('Implement Terraform Provider actions using the Plugin Framework') and when ('Use when developing imperative operations that execute at lifecycle events') with explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | Includes relevant technical terms like 'Terraform Provider', 'Plugin Framework', 'lifecycle events', 'create, update, destroy', but missing common variations users might say like 'terraform plugin', 'provider development', 'resource lifecycle', or 'terraform hooks'. | 2 / 3 |
Distinctiveness Conflict Risk | Very specific niche targeting Terraform Provider Plugin Framework actions at lifecycle events - unlikely to conflict with general Terraform skills or other infrastructure-as-code tools due to the specific 'Plugin Framework' and 'lifecycle events' qualifiers. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong, actionable skill with excellent executable code examples and clear validation workflows. The main weaknesses are moderate verbosity (some explanatory content Claude doesn't need) and the monolithic structure that could benefit from splitting into overview + detailed reference files. The checklists and validation steps are particularly well done.
Suggestions
Split detailed sections (Testing Actions, Documentation Standards, Common Action Patterns) into separate reference files and link from a leaner SKILL.md overview
Remove explanatory content like 'Terraform Actions enable imperative operations during the Terraform lifecycle' - Claude knows this from context
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is comprehensive but includes some verbose explanations that could be tightened. Sections like 'Overview' explain what actions are (which Claude likely knows), and some patterns are repeated across sections. | 2 / 3 |
Actionability | Provides fully executable Go code examples throughout, including schema definitions, invoke methods, error handling patterns, polling implementations, and test patterns. Code is copy-paste ready with proper imports noted. | 3 / 3 |
Workflow Clarity | Clear multi-step workflows with explicit validation checkpoints. The 'Schema Validation Checklist' and 'Pre-Submission Checklist' provide concrete verification steps. The testing section includes compile-check commands before running tests. | 3 / 3 |
Progressive Disclosure | Content is well-organized with clear sections, but it's a monolithic document (~400 lines) that could benefit from splitting detailed patterns (testing, documentation) into separate reference files. External references are provided but internal content isn't appropriately split. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
93%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 15 / 16 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
license_field | 'license' field is missing | Warning |
Total | 15 / 16 Passed | |
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.