CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

generator-key-needs-golden

Use when adding a generator key or branch in tools/iac-codegen. Cover it with a golden fixture. Do NOT use for a resource-only override line.

Quality

93%

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

100%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.

An exemplarily lean, fully actionable skill body: it names the exact fixtures and keys to extend, the exact test command to run, and the explicit verification step (second run without -update must pass). Organization into Trigger/Fix/Why is ideal for a skill of this size with no bundle files.

DimensionReasoningScore

Conciseness

The 13-line body has zero padding and assumes competence with go test, fixtures, and goldens; the dense enumeration of what each fixture covers is actionable detail, not filler. Matches the anchor 'Lean and efficient; assumes Claude's competence; every token earns its place.'

5 / 5

Actionability

Gives the exact fixture directory (internal/generator/testdata), four named example fixtures with the specific keys each covers (customthing, sharedthing, thing, legacything), and the copy-paste-ready command 'go test ./internal/generator -run TestGoldenOutput<Name> -update'. Fully executable guidance matching the top anchor.

5 / 5

Workflow Clarity

The single task is unambiguous (extend fixture, update golden, commit) and includes an explicit validation checkpoint: 'A second run without -update must pass.' The simple-skill exception applies and the operation is neither destructive nor batch, so no cap applies.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent) and the skill is under 50 lines with no need for external references. The well-organized Trigger/Fix/Why sections satisfy the rubric's simple-skill allowance for a top score.

5 / 5

Total

20

/

20

Passed

Description

82%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.

A strong description with explicit what/when triggers and excellent distinctiveness thanks to the specific tool path and negative trigger. Its only weakness is thin action coverage and trigger-term breadth in the description itself.

Suggestions

Include the concrete branch variations from the body (a field line, an enum line, or a convert or schema branch) in the description to broaden natural trigger-term coverage.

Add where the golden lives (internal/generator/testdata) or the test name pattern to the description to sharpen the 'what' beyond the single phrase 'Cover it with a golden fixture'.

DimensionReasoningScore

Specificity

Names the domain ('adding a generator key or branch in tools/iac-codegen') and one concrete action ('Cover it with a golden fixture'), matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive.' Not 4 because only a single action phrase is given rather than several specific actions.

3 / 5

Completeness

Explicitly answers both what ('Cover it with a golden fixture') and when ('Use when adding a generator key or branch in tools/iac-codegen') with concrete trigger phrases, and adds an explicit negative trigger ('Do NOT use for a resource-only override line'). Matches the top anchor.

5 / 5

Trigger Term Quality

'Generator key', 'branch', 'tools/iac-codegen', and 'golden fixture' are natural terms a developer on this codebase would say, giving good keyword coverage. Not 5 because the variations the body lists (field line, enum line, convert/schema branch) and related terms like testdata/TestGoldenOutput are missing from the description.

4 / 5

Distinctiveness Conflict Risk

Pins a specific tool path and concept with an explicit exclusion clause, giving a clear niche with minimal conflict risk against any other skill. Matches the top anchor.

5 / 5

Total

17

/

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

coralogix/terraform-provider-coralogix

Path

.claude/skills/generator-key-needs-golden/SKILL.md

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.