Content
77%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 unusually actionable instruction skill: concrete tokens, values, and decision rules throughout, with a clear and consistently modeled diagnostic workflow. Its weaknesses are length and layout — significant rhetorical repetition and reference material (phrasebook, feedback protocol, worked examples) inlined in SKILL.md rather than split into one-level-deep reference files.
Suggestions
Consolidate the 'lead with the feeling, not the pixel' guidance, which is repeated in the intro, 'How to read this', the Moves preamble, and the feedback section, into a single statement, and trim the 'Why these four?' rationale section to a few lines — a 30-40% length reduction is achievable without losing instruction value.
Move the phrasebook table, the worked examples, and the 'Giving and receiving feedback' protocol into references/ files (e.g., PHRASEBOOK.md, FEEDBACK.md), keeping SKILL.md as the Values→Principles→Moves overview with clearly signaled one-level-deep pointers.
Make the external detail self-contained or explicitly marked: either bundle the design-token reference as a references/ file inside the skill, or state in SKILL.md that paths like baseSizes.ts and design-tokens.instructions.md live in the repository outside the skill bundle, so navigation does not depend on unverifiable relative paths.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient — no filler explaining basics Claude already knows — but the core 'lead with the feeling, not the pixel' message is restated four times (intro, 'How to read this', the Moves preamble, and the feedback section), and the ~25-line 'Why these four?' section is essayistic rationale rather than instruction. Fits 'mostly efficient but includes some unnecessary explanation or could be tightened' better than 'minor instances that could be trimmed' (4), since a 30-40% cut is achievable without losing guidance. | 3 / 5 |
Actionability | Fully concrete for an instruction-only skill: named tokens (`--vscode-cornerRadius-small/medium/large/circle`, `--vscode-strokeThickness`), exact values (4/6/8px tiers, the enumerated spacing ramp, 16/12px icon sizes, 400/600 weights, `heading1-3`/`body1-2`/`label1-3` roles), a per-move decision rule, and a do/don't phrasebook covering the common cases. Every move tells the reader exactly which value to pick and how to phrase the bug. | 5 / 5 |
Workflow Clarity | The diagnostic sequence is explicit and repeated consistently: 'name the feeling, find the principle, then reach for the move' (bottom-up reading), a numbered 5-step feedback order (feeling → surface → principle → move → number), five worked examples modeling the sequence end-to-end, and an explicit conflict-resolution rule for the sentence-case/title-case contradiction. There are no validation checkpoints because nothing destructive or batch is performed, so the rubric's validation cap does not apply. | 5 / 5 |
Progressive Disclosure | Internal structure is good (clear sections, anchor links from principles to moves), but everything — the phrasebook table, the feedback protocol, and the worked examples — is inlined in a ~320-line single-file skill with no bundled reference files, and the only external pointers (`baseSizes.ts`, `design-tokens.instructions.md`) are repo-relative paths outside the bundle that cannot be verified from the skill itself. This fits 'some structure but content that should be separate is inline' rather than 'most content appropriately placed' (4). | 3 / 5 |
Total | 16 / 20 Passed |