CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

switch-resource-to-generated

Use when a handwritten resource that users already have becomes generated code (tools/iac-codegen existing-resource mode). Record a baseline first, then compare. Do NOT use for a new resource.

Quality

86%

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

92%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 dense recipe: hard-won operational specifics, explicit golden-diff validation gates around a destructive code-deletion step, and a well-sequenced eight-step workflow with zero padding. The only gaps are minor executability details — a sample behavior-overrides.yaml line and the mechanism for recording real API answers.

Suggestions

Add one example line of behavior-overrides.yaml (e.g. a field line with unwrap: true) so step 3 is copy-paste executable rather than inferential.

Name the tool or command used to 'record real answers with a recorder that stays outside the repo' in step 2, the least executable instruction in the recipe.

DimensionReasoningScore

Conciseness

Lean and dense with operational knowledge Claude would not already know ('Record the raw request bodies, not parsed ones: alertUniqueIds: {} and {"value": []} parse alike but are different requests', 'Plan the applied config again after each refresh'). Every token earns its place with no padding or generic explanation.

5 / 5

Actionability

Mostly executable: concrete commands ('tfgen check --overrides', 'tfgen generate --resource <Name> --out <dir>'), real file paths ('internal/provider/global_router_baseline_*_test.go', 'behavior-overrides.yaml'), and named test procedures. Not 5 because a couple of steps lack executable detail — no example line of an overrides file, and 'Record real answers with a recorder that stays outside the repo' names no tool or command.

4 / 5

Workflow Clarity

Eight clearly sequenced steps with explicit validation checkpoints guarding the destructive step (delete handwritten code): 'The golden diff must show only wording of messages', 'The diff must be empty', 'Do not keep a bug with an override line', and 'Keep the hand test until the generated one has passed on a tenant' — feedback loops and error-recovery gates are all present.

5 / 5

Progressive Disclosure

A ~20-line skill with well-organized sections (Trigger, Recipe, Why) and no bundle files; all detail is appropriately inline for this length, so the simple-skill exception applies and organization is clean.

5 / 5

Total

19

/

20

Passed

Description

73%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 tight, well-scoped description with an explicit trigger, a concrete exclusion, and natural trigger phrases, held back only by a thin statement of what the skill actually does beyond baseline-and-compare and by missing migration synonyms. Third-person voice is correct and there is no fluff.

Suggestions

Expand the 'what' to name the skill's full scope, e.g. 'Record golden baselines, write behavior-overrides.yaml, generate the resource, and add generated acceptance tests' — this would raise specificity and completeness.

Add natural synonyms users might say, such as 'migrate', 'switch', or 'convert' a handwritten Terraform resource to generated code, to improve trigger term coverage.

DimensionReasoningScore

Specificity

Names the domain ('tools/iac-codegen existing-resource mode') and two concrete actions ('Record a baseline first, then compare'), but does not enumerate the skill's fuller action set (overrides, generation, acceptance tests), matching the 'domain and 1-2 concrete actions' anchor rather than the 'several specific actions' level.

3 / 5

Completeness

Both parts are present: an explicit 'Use when a handwritten resource that users already have becomes generated code' trigger (plus the exclusion 'Do NOT use for a new resource') and a what ('Record a baseline first, then compare'). The when is concrete, but the what is thin — only two actions — so it falls short of the anchor-5 'clearly and explicitly answers both with concrete trigger phrases' for the what side.

4 / 5

Trigger Term Quality

Natural phrases users would actually say are present — 'handwritten resource', 'generated code', 'existing-resource', 'new resource' — giving good keyword coverage. Not 5 because common synonyms like 'migrate', 'convert', 'switch', or 'Terraform provider' are missing; not 3 because the terms directly mirror natural user phrasing rather than only loosely relevant keywords.

4 / 5

Distinctiveness Conflict Risk

Highly niche ('tools/iac-codegen existing-resource mode') with a clear distinct trigger and an explicit negative trigger ('Do NOT use for a new resource') that separates it from the nearest competing use case, giving minimal conflict risk.

5 / 5

Total

16

/

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/switch-resource-to-generated/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.