Content
86%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.
A tight, domain-dense skill that teaches a project's icon construction system almost entirely through concrete rules, numeric constraints, and runnable commands. The only notable improvements are a worked example of a `DRAWINGS` entry and an explicit retry step after a failed preview check.
Suggestions
Add one short worked example of a `DRAWINGS` entry (e.g. the `Webhook` glyph's inner SVG markup) so the expected shape of a drawing — helper calls, class="b"/class="k" markers — is unambiguous before the reader writes their own.
Close the Loop with an explicit feedback step, e.g. 'If any of the four checks fails, fix the drawing and re-run --preview before regenerating', making the validate-fix-retry cycle explicit rather than implied.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every sentence carries project-specific information — grid bounds, k-value ranges, helper signatures, exact pnpm commands — with one-clause rationales ('a gap survives at 14px', 'the round cap pokes out if it runs past') and zero padding or explanation of concepts Claude already knows. | 5 / 5 |
Actionability | The loop gives copy-paste commands (`pnpm --filter @multica/ui icons --preview NewName Neighbour1 Neighbour2`, regenerate, test) and concrete helper signatures (`shape([[x, y, k], ...])`, `head(x, y, dir, depth, half)`, `tick(a, v, b)`, `dot(x, y, r)`), but no worked example of a `DRAWINGS` entry showing what a complete drawing's markup looks like. This is a minor gap, matching anchor 4 rather than 5. | 4 / 5 |
Workflow Clarity | The Loop is a clear numbered sequence with an explicit 4-point visual validation checklist (48px grid fit, 14px legibility, tinted-tile fill, neighbour distinctness) plus a test/typecheck gate, and 'icons.test.ts fails when they drift' supplies a drift signal. It falls short of anchor 5 only because no explicit fix-and-retry feedback loop is stated after a failed check. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines with no need for external reference files (none exist in the bundle), and its five `##` sections (Before drawing, Where things live, Construction, Body and details, Loop) are well-organized, which the simple-skill guideline scores as 5. | 5 / 5 |
Total | 18 / 20 Passed |