CtrlK
BlogDocsLog inGet started
Tessl Logo

new-terraform-provider

Use this when scaffolding a new Terraform provider with the Plugin Framework: workspace layout, go module setup, provider server main.go, and a provider.go with schema and Configure. Also use when a user wants to start building a provider for a new API or asks how to begin a terraform-provider-* project.

77

Quality

96%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

93%Weight 40%Scale 1-5

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

A tight, command-driven scaffold workflow that delegates code to genuine example files and uses build/test as validation gates. The only real gap is the absence of an explicit failure-handling loop and the literal `go mod init` command in the module-setup step.

Suggestions

Add a brief error-recovery step after the build/test steps (e.g., "If build or tests fail, address the reported errors and re-run") to close the feedback loop in workflow_clarity.

Replace "Initialize a new Go module" with the concrete command, e.g. `go mod init github.com/<org>/terraform-provider-<name>`, so every step is copy-paste ready.

DimensionReasoningScore

Conciseness

Every step is a bare instruction — "Initialize a new Go module", "Run `go mod tidy`", "Remove TODO comments" — with zero explanation of concepts Claude already knows. Lean throughout; the closing credential note adds non-obvious information, not padding, so it does not fall to 4.

5 / 5

Actionability

Concrete commands (`go get -u ...@latest`, `go mod tidy`, `go build -o /dev/null`, `go test ./...`) plus two complete, executable example files (assets/main.go, assets/provider.go) and specific rename instructions ("demo", "DEMO_*", auth attributes). Fully executable guidance; no pseudocode, so it does not sit at 4.

5 / 5

Workflow Clarity

Clear 10-step sequence with an explicit conditional checkpoint (step 1) and terminal validation steps (`go build -o /dev/null`, `go test ./...`). It stops short of the top anchor because there is no error-recovery loop (e.g., what to do if build/test fails) and `go mod init` in step 3 lacks the actual command — minor validation gaps, matching anchor 4 rather than 5.

4 / 5

Progressive Disclosure

~40-line body with code templates appropriately split into two real, well-signaled one-level-deep references ("follows [the example](assets/main.go)") and clear pointers to sibling skills for next steps. Matches the anchor for a clear overview with easy navigation; the lack of section headers is immaterial at this length.

5 / 5

Total

19

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An excellent description: concrete artifact-level capabilities, explicit double trigger clauses in third person, and a tightly scoped niche. It follows the strongest reference examples' pattern without padding.

DimensionReasoningScore

Specificity

Enumerates concrete deliverables — "workspace layout, go module setup, provider server main.go, and a provider.go with schema and Configure" — matching exactly what the skill's steps produce. This fits the anchor for multiple specific concrete actions with comprehensive coverage; score 4 would require minor gaps, and none exist.

5 / 5

Completeness

Explicitly answers what (scaffolding with Plugin Framework, listing the artifacts) and when, twice: "Use this when scaffolding a new Terraform provider" and "Also use when a user wants to start building a provider... or asks how to begin". Matches the top anchor with concrete trigger phrases.

5 / 5

Trigger Term Quality

Covers natural phrasings users would say: "scaffolding", "start building a provider for a new API", "asks how to begin a terraform-provider-* project" — synonyms (scaffold/build/begin) plus the repo naming convention, the domain equivalent of file extensions. Not 4, since no obviously missing natural term for this niche.

5 / 5

Distinctiveness Conflict Risk

Clear niche — scaffolding a *new* Terraform provider with the Plugin Framework — with distinct triggers unlikely to fire for provider-extension or SDKv2 skills. Minimal conflict risk; not 4, since the new-provider scope is unambiguous.

5 / 5

Total

20

/

20

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.

Validation — 16 / 16 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.