Content
100%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
An exemplary minimal skill body: every line is repo-specific and actionable, the command is copy-paste ready, and the workflow includes an explicit verification step (re-run without -update). The named reference fixture 'customthing' grounds the abstract instruction in a concrete, existing example.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~13-line body is lean and dense: Trigger, Fix, and Why each carry only non-obvious, repo-specific information ("a field line, an enum line, or a convert or schema branch"; "customthing covers custom methods, root and nested requestValue..."). Nothing explains concepts Claude already knows, so every token earns its place — a direct match for the level-5 anchor, and clearly above level 4 where trimming would still be possible. | 5 / 5 |
Actionability | The guidance is fully executable: a copy-paste command ("go test ./internal/generator -run TestGoldenOutput<Name> -update"), a specific fixture directory ("internal/generator/testdata"), and a named model fixture ("customthing") that covers the common cases (requestValue, readNullAs, readEmptyAs, requireOne, readRejected, unwrap, default-missing enum). This matches the level-5 anchor — executable commands plus a concrete example covering common cases — with nothing reduced to pseudocode. | 5 / 5 |
Workflow Clarity | The sequence is clear and unambiguous — add/extend the fixture, run the test with -update, commit the golden — and it ends with an explicit validation checkpoint ("A second run without -update must pass"). This is a simple single-purpose skill under 50 lines whose action is unambiguous, and validation is explicitly present, so the level-5 anchor applies; level 4 would require missing checkpoints, which is not the case. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines, has no need for external references (none exist in the bundle), and is organized into clear, well-signaled sections (Trigger / Fix / Why). Per the rubric's guidance for short reference-free skills, this matches the level-5 anchor; there is no inlined content that belongs in a separate file. | 5 / 5 |
Total | 20 / 20 Passed |