CtrlK
BlogDocsLog inGet started
Tessl Logo

new-terraform-provider

Use this when scaffolding a new Terraform provider.

78

1.07x
Quality

47%

Does it follow best practices?

Impact

98%

1.07x

Average score across 6 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./terraform/provider-development/skills/new-terraform-provider/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

22%

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 description is extremely terse and fails to explain what the skill actually does — it only states when to use it. While 'Terraform provider' provides some domain specificity, the lack of concrete actions and capability details makes it insufficient for Claude to confidently select this skill over others. It reads more like a trigger hint than a proper skill description.

Suggestions

Add concrete actions the skill performs, e.g., 'Generates provider scaffolding including resource and data source skeletons, provider configuration schema, acceptance test templates, and Makefile setup for Terraform providers.'

Expand trigger terms to include variations like 'terraform plugin', 'provider boilerplate', 'terraform-plugin-framework', 'new terraform provider project', 'provider SDK'.

Rewrite in third person voice describing capabilities first, then add a 'Use when...' clause, e.g., 'Scaffolds new Terraform providers with resource definitions, schemas, and test harnesses. Use when creating a new Terraform provider or bootstrapping provider plugin code.'

DimensionReasoningScore

Specificity

The description says 'scaffolding a new Terraform provider' but does not list any concrete actions (e.g., generating resource schemas, creating provider configuration, setting up acceptance tests). It names the domain but provides no detail about what the skill actually does.

1 / 3

Completeness

It answers 'when' ('when scaffolding a new Terraform provider') but completely fails to answer 'what does this do' — there is no description of the skill's capabilities or actions. The 'what' is essentially missing.

1 / 3

Trigger Term Quality

It includes 'Terraform provider' and 'scaffolding' which are relevant keywords a user might say, but misses common variations like 'terraform plugin', 'provider boilerplate', 'new provider project', 'terraform-plugin-sdk', or 'terraform-plugin-framework'.

2 / 3

Distinctiveness Conflict Risk

'Terraform provider' is a fairly specific niche, which helps distinctiveness, but the vague 'scaffolding' term could overlap with general project scaffolding or Terraform module creation skills. More specificity about provider-specific actions would reduce conflict risk.

2 / 3

Total

6

/

12

Passed

Implementation

72%

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

This is a concise, well-structured scaffolding skill with a clear step sequence and good use of an external asset for the example file. Its main weaknesses are missing specific commands for some steps (e.g., 'go mod init') and lacking explicit error recovery/feedback loops after the build and test steps.

Suggestions

Replace 'Initialize a new Go module' with the specific command: `go mod init github.com/<org>/terraform-provider-<name>`

Add feedback loops after steps 8 and 9: e.g., 'If build fails, review errors, fix, and re-run' to improve workflow clarity

Fix the typo in step 3 (double period at end)

DimensionReasoningScore

Conciseness

The content is lean and efficient. Every line is a concrete step with no unnecessary explanation of what Terraform or Go modules are. No wasted tokens.

3 / 3

Actionability

Steps include specific commands (go get, go build, go test), but the main.go content is delegated to an asset file reference rather than shown inline. The instruction 'Write a main.go file that follows the example' is somewhat vague without seeing the asset. Step 3 'Initialize a new Go module' lacks the specific command (go mod init).

2 / 3

Workflow Clarity

Steps are clearly sequenced and include build/test validation at the end. However, there are no explicit error recovery steps—if 'go build' or 'go test' fails, there's no feedback loop for fixing and retrying. For a scaffolding workflow that involves code generation, this gap is notable.

2 / 3

Progressive Disclosure

The skill is concise and appropriately delegates the main.go example to an asset file rather than inlining it. The reference is one level deep and clearly signaled. For a simple skill under 50 lines, this is well-organized.

3 / 3

Total

10

/

12

Passed

Validation

100%

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

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
hashicorp/agent-skills
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.