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-resources94
Quality
75%
Does it follow best practices?
Impact
96%
1.33xAverage score across 16 eval scenarios
Optimize this skill with Tessl
npx tessl skill review --optimize ./terraform/provider-development/skills/provider-resources/SKILL.mdQuality
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
| Dimension | Reasoning | Score |
|---|---|---|
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
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 13 / 16 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
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 | |
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.