Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-architected routing skill: actionable CLI commands, a clearly sequenced workflow with explicit gates, and excellent progressive disclosure to real one-level-deep references. Its only weakness is conciseness — routing guidance is repeated across the Phase 0 and Quick routes tables, and a few rhetorical lines add length without information.
Suggestions
Collapse the overlap between the Phase 0 routing table and the Quick routes table so design+perfection-load-together and per-request file picks are stated once, cross-referencing instead of restating.
Trim rhetorical framing such as "The bar is not clean-and-correct — it is work a senior designer at Linear, Stripe, or Supabase would ship" to a shorter invariant so the body stays dense and directive.
Move the brand-name enumeration in the Layer B paragraph fully to _INDEX.md (keep one or two examples plus the pointer) to reduce inline list length.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and assumes competence, but the routing tables and the "Quick routes" table restate overlapping guidance (e.g., design+perfection-load-together is repeated) and rhetorical lines like "The bar is not clean-and-correct…" pad the text. | 2 / 3 |
Actionability | Provides concrete, executable commands (the lighthouse-audit.py and ui-ux-db search.py invocations, both verified to exist), explicit gating conditions, and per-branch deliverables — copy-paste ready. | 3 / 3 |
Workflow Clarity | Clear sequence (Phase 0 route → numbered design-system branches → rulesets → axioms) with explicit checkpoints: the Design System Gate, Primitive Showcase Gate, the "STOP and ask one focused question" branch, and the /visual-qa dual-oracle verification gate. | 3 / 3 |
Progressive Disclosure | The body is a router pointing to well-signaled one-level-deep references (verified to exist on disk), with _INDEX.md cataloging the 83 files and per-table read-when guidance; content is appropriately split across rulesets rather than inlined. | 3 / 3 |
Total | 11 / 12 Passed |