CtrlK
BlogDocsLog inGet started
Tessl Logo

provider-resources

Implement Terraform Provider resources and data sources using the Plugin Framework. Use when developing CRUD operations, schema design, state management, and acceptance testing for provider resources.

Install with Tessl CLI

npx tessl i github:hashicorp/agent-skills --skill provider-resources
What are skills?

94

1.33x

Quality

75%

Does it follow best practices?

Impact

96%

1.33x

Average score across 16 eval scenarios

Optimize this skill with Tessl

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

Quality

Discovery

85%

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 strong skill description that clearly defines its scope (Terraform Provider development) and provides explicit trigger conditions. The description uses proper third-person voice and lists concrete capabilities. Minor improvement could be made by expanding trigger terms to include more natural variations users might use.

Suggestions

Add common trigger term variations like 'terraform plugin', 'provider development', 'custom provider', or file extensions like '.tf' to improve discoverability

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'CRUD operations, schema design, state management, and acceptance testing for provider resources' - these are distinct, actionable capabilities.

3 / 3

Completeness

Clearly answers both what ('Implement Terraform Provider resources and data sources using the Plugin Framework') and when ('Use when developing CRUD operations, schema design, state management, and acceptance testing') with explicit trigger guidance.

3 / 3

Trigger Term Quality

Includes relevant terms like 'Terraform Provider', 'Plugin Framework', 'CRUD operations', 'acceptance testing', but misses common variations users might say like 'terraform plugin', 'provider development', 'resource implementation', or 'data source'.

2 / 3

Distinctiveness Conflict Risk

Very specific niche - Terraform Provider development with Plugin Framework is a distinct domain unlikely to conflict with general Terraform usage skills or other infrastructure-as-code tools.

3 / 3

Total

11

/

12

Passed

Implementation

64%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill provides highly actionable, executable code examples covering the full Terraform provider development lifecycle. However, it's overly verbose for a SKILL.md file, including content that should be in separate reference documents. The workflow lacks explicit validation steps between development phases.

Suggestions

Split detailed sections (Testing, Error Handling, Documentation Standards) into separate reference files and link to them from a concise overview

Remove the Overview section explaining what resources are - Claude already knows this

Add explicit validation workflow: 'After implementing CRUD -> Run `go test -c` -> Fix compilation errors -> Run acceptance test -> Verify import works'

Condense the attribute types table and validator examples - show 2-3 key examples and reference documentation for the full list

DimensionReasoningScore

Conciseness

The content is comprehensive but includes some redundancy and explanations that Claude would already know (e.g., basic CRUD concepts, what validators do). The overview section explaining what resources are is unnecessary padding.

2 / 3

Actionability

Provides fully executable, copy-paste ready code examples for all CRUD operations, testing patterns, error handling, and documentation. Code is complete with proper imports and context, not pseudocode.

3 / 3

Workflow Clarity

While the content covers the full development lifecycle, it lacks explicit validation checkpoints and feedback loops. The pre-submission checklist is helpful but there's no clear 'validate -> fix -> retry' workflow for the development process itself.

2 / 3

Progressive Disclosure

The document is well-organized with clear sections, but it's monolithic at ~400 lines. Content like the full testing patterns, error handling, and documentation standards could be split into separate reference files. External references are provided but inline content is excessive.

2 / 3

Total

9

/

12

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (600 lines); consider splitting into references/ and linking

Warning

license_field

'license' field is missing

Warning

body_steps

No step-by-step structure detected (no ordered list); consider adding a simple workflow

Warning

Total

13

/

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.