CtrlK
BlogDocsLog inGet started
Tessl Logo

provider-actions

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-actions
What are skills?

97

6.18x

Quality

76%

Does it follow best practices?

Impact

99%

6.18x

Average score across 15 eval scenarios

Optimize this skill with Tessl

npx tessl skill review --optimize ./terraform/provider-development/skills/provider-actions/SKILL.md
SKILL.md
Review
Evals

Quality

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.

DimensionReasoningScore

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

DimensionReasoningScore

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

license_field

'license' field is missing

Warning

Total

15

/

16

Passed

Reviewed

Table of Contents

Is this your skill?

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.