CtrlK
BlogDocsLog inGet started
Tessl Logo

provider-ephemeral-resources

Implement Terraform provider ephemeral resources with the Plugin Framework: the Open/Renew/Close lifecycle, ephemeral schema design, registration via EphemeralResources, renewal for expiring credentials, and how ephemeral values flow into write-only attributes and provider configuration. Use when adding an ephemeral resource, exposing secrets/tokens/certificates that must never persist in state or plan, deciding between an ephemeral resource and a data source, or wiring short-lived credentials from one provider into another.

74

Quality

91%

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

82%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 strong, dense implementation skill: complete executable Go for the full ephemeral lifecycle, correct design rules, and explicit testing gates. The main deductions are mild redundancy in the checklist and code that could be split into a reference file for progressive disclosure.

Suggestions

Cut or compress the final Checklist so it does not restate Design Rules, Testing, and Documentation verbatim — keep only the decisions a reader must confirm (e.g. the ephemeral-vs-data-source gate and the never-persist check).

Move the full Go implementation example into references/ (e.g. references/lifecycle-example.md) and keep a skeleton with the Open/Renew/Close signatures inline, improving progressive disclosure for the ~200-line body.

Add a short error-recovery note to the Testing section (what to inspect when echo-provider tests fail or Renew diagnostics fire) to close the workflow-clarity feedback loop.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — no Terraform or Go basics are explained, and the Renew-semantics and Private-key notes are genuinely non-obvious domain knowledge. It falls short of 5 because the closing Checklist largely restates the Design Rules, Testing, and Documentation sections, adding redundant tokens.

4 / 5

Actionability

The Implementation section is a complete, copy-paste-ready Go example covering Metadata, Schema, Open, Renew, and Close with correct diagnostics handling, plus a full registration snippet. Score 4 would require minor gaps, but the code covers the common case end-to-end and is executable as written (modulo the illustrative client).

5 / 5

Workflow Clarity

The section order (When to Use → Lifecycle → Implementation → Registration → Design Rules → Testing → Documentation → Checklist) forms a clear sequence, with an explicit verification gate (echo-provider tests gated to Terraform >= 1.10) and a closing checklist. It does not reach 5 because there is no error-recovery guidance for when tests or renewal fail.

4 / 5

Progressive Disclosure

Headers are clear and navigation is easy, with no nested references and sensible cross-links to sibling skills. It stays at 4 rather than 5 because the ~100-line implementation listing is inline in SKILL.md where a references/ split would fit, and the sibling-skill pointers are hedged with "(if available)" rather than resolved to concrete paths.

4 / 5

Total

17

/

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 exemplary description: concrete capability list, third-person voice, explicit and multi-trigger "Use when" clause, and natural keyword coverage including synonyms. It follows the strongest reference pattern without padding or over-claiming.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions — "the Open/Renew/Close lifecycle, ephemeral schema design, registration via EphemeralResources, renewal for expiring credentials, and how ephemeral values flow into write-only attributes and provider configuration" — matching the comprehensive multi-action anchor. Score 4 would require minor gaps in coverage, but every core capability of the skill is named.

5 / 5

Completeness

It explicitly answers both questions: the "what" is the implementation capability list, and the "when" is a concrete "Use when adding an ephemeral resource, exposing secrets... deciding between an ephemeral resource and a data source, or wiring short-lived credentials from one provider into another" clause. This mirrors the anchor-5 exemplar structure exactly; a 4 would need the when-clause to be less explicit or concrete.

5 / 5

Trigger Term Quality

Natural phrasing a user would actually say is well covered with synonyms: "adding an ephemeral resource", "exposing secrets/tokens/certificates that must never persist in state or plan", "deciding between an ephemeral resource and a data source", "wiring short-lived credentials". It falls short of the 5 anchor only in omitting a couple of looser variations (e.g. "dynamic credentials", "temporary password"), keeping it at the top anchor rather than above it.

5 / 5

Distinctiveness Conflict Risk

"Terraform provider ephemeral resources" is a narrow, well-defined niche, and the description even pre-empts the nearest collision by naming the "deciding between an ephemeral resource and a data source" case. It is clearly distinguishable from general Terraform provider/data-source skills, so the minimal-conflict anchor applies.

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.