Content
92%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 well-engineered router: the body carries only the always-needed rules and gates, routes everything else to a real, well-indexed reference library, and backs every phase with runnable lint/detect/audit commands and explicit verification checkpoints. Its single weakness is density — several bullets over-enumerate variants and restate standards that could be tightened without losing meaning.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense rule-prose that teaches nothing Claude already knows, but a few passages over-enumerate: the ~200-word draft-guard bullet cataloguing every stripe variant ("border-left: 4px solid <accent> or border-l-4 border-indigo-500, a coloured ::before/::after bar inside it, an inset box-shadow stripe...") and restated WCAG ratios ("text 4.5:1 (large 3:1)") could be trimmed — anchor 4 ("efficient; minor instances of over-explanation that could be trimmed") rather than the every-token-earns-its-place bar of 5. | 4 / 5 |
Actionability | Copy-paste-ready commands with real flags cover the operational cases ("bun $SKILL_DIR/scripts/perfection/check-draft-guard.ts <changed files or dirs>", "detectPage({ kind: \"url\", url }, { reflow: true })", "python3 -B $SKILL_DIR/references/ui-ux-db/scripts/search.py \"<query>\" --design-system -p \"Project\"") plus exact thresholds (44x44 pt, 24x24 px, 65-75 characters per line, 1.25x heading steps) and named probes (read each control's getBoundingClientRect() in every state) — fully executable, anchor 5. | 5 / 5 |
Workflow Clarity | The flow "ground -> brief -> build -> subtract -> verify" is stated up front and sequenced as numbered sections 0-4 with explicit validation gates and error-recovery loops: "Exit 1 means a tell is in the draft: remove it, do not argue with the finding", "Fix every error and warning before /visual-qa", and a bounded /visual-qa review loop ("its Step 4 sets the budget") — matching anchor 5's checkpoints-and-feedback-loops pattern. | 5 / 5 |
Progressive Disclosure | The file declares itself "a router over references/" and delivers: a request-keyed routing table with a named reason per reference, Layer A/Layer B tables, and _INDEX.md ("catalogs all 83") over a verified one-level-deep bundle — every named file checked exists and holds real content (stylegallery.md, craft-floor.md, detect.md, check-draft-guard.ts, search.py, and the 12 taste skills / 70 brand files match the stated counts) — matching anchor 5's clear-overview-with-well-signaled-one-level-deep-references pattern. | 5 / 5 |
Total | 19 / 20 Passed |