CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

record-migration-baseline

Use when recording or reviewing a handwritten Terraform resource's protocol golden baseline before generator migration. Check schema, writes, reads, and omitted fields.

Quality

89%

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

88%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 dense, expert-level workflow: it prescribes a precise recording procedure with explicit validation gates, a coverage checklist, and error-recovery branches, all without padding. The main gaps are the absence of any executable command or template example and a single external reference that points outside the skill bundle.

Suggestions

Add one concrete executable anchor for actionability: the actual command used to run or record the baseline goldens, and/or a small coverage-matrix template (rows = fields, columns = create/refresh/update/delete/import), so step 2 and step 5 are copy-paste ready rather than descriptive.

Fix the migration review rubric reference for progressive disclosure: "../../../docs/generator-migration-review-rubric.md" leaves the skill bundle and cannot be verified here — either ship it as a bundled reference file (e.g., references/generator-migration-review-rubric.md) or summarize the applicable review criteria inline.

DimensionReasoningScore

Conciseness

The body assumes Claude's competence — it invokes protobuf, OpenAPI, plan modifiers, and framework schema maps without explaining them — and nearly every clause encodes a distinct requirement ("test both mismatch directions and null members separately", "including values named `empty` or `unknown`"). It fits anchor 5's lean, every-token-earns-its-place standard rather than anchor 4, since there is no over-explanation to trim.

5 / 5

Actionability

Guidance is highly concrete and executable in substance — "If omitted Create fails, first create a valid resource, then remove the field on Update and record the next refresh and plan", "Sort recorded validation diagnostics before comparing them" — but there are no commands or templates: no example test command, no coverage-matrix format, no golden-file example. This matches anchor 4's mostly executable guidance with minor gaps rather than anchor 5's copy-paste-ready coverage, and exceeds anchor 3's pseudocode-level guidance.

4 / 5

Workflow Clarity

A clear five-step sequence (read schema → build coverage matrix → trace omissions → record and compare → verify and open PR) with explicit validation checkpoints ("Compare the coverage matrix with the golden file list. Resolve every missing cell or state why it does not apply"; "Run the baseline tests and review the final diff and fixture content before opening the PR"), a built-in checklist (the coverage matrix), and a conditional recovery path. This matches anchor 5 rather than anchor 4 because the checkpoints and error-recovery branches are explicit, not merely implied.

5 / 5

Progressive Disclosure

The short (~20-line) body is well organized into Trigger, Fix, numbered steps, Diagnostic order, and Why, with one clearly signaled one-level reference. However, that sole reference escapes the skill bundle ("../../../docs/generator-migration-review-rubric.md") and no bundle files exist to verify it against — a minor organization gap that keeps it at anchor 4 rather than anchor 5's clean, well-signaled navigation.

4 / 5

Total

18

/

20

Passed

Description

87%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: it names a precise, distinctive niche, gives an explicit and highly specific trigger condition, and summarizes the concrete checks. Its only weakness is that the action summary compresses coverage (writes/reads) and omits a few operations the body actually governs.

DimensionReasoningScore

Specificity

Lists several concrete actions — "recording or reviewing" a resource's baseline and "Check schema, writes, reads, and omitted fields" — matching anchor 4's several specific actions with minor gaps; it stops short of anchor 5's comprehensive coverage because the body's import, data-source, and diagnostics checks are absent from the description.

4 / 5

Completeness

Both parts are explicit: the when is "Use when recording or reviewing a handwritten Terraform resource's protocol golden baseline before generator migration" and the what is "Check schema, writes, reads, and omitted fields", with concrete trigger phrases throughout. It is not anchor 4 because the when could not reasonably be more explicit or specific.

5 / 5

Trigger Term Quality

"handwritten Terraform resource", "protocol golden baseline", and "generator migration" are exactly the phrases a practitioner would say, giving good keyword coverage; a few natural variants (e.g., "golden files", "acceptance tests", "provider") are missing, so it fits anchor 4 rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The trigger scenario — protocol goldens for a handwritten Terraform resource before generator migration — is a clear niche with distinct terms that would not fire unrelated skills, giving minimal conflict risk as in anchor 5. It is not anchor 4 because there is no realistic overlap with closely related skills given this specificity.

5 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

coralogix/terraform-provider-coralogix

Path

.claude/skills/record-migration-baseline/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.