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 exemplary router-style skill: dense, opinionated, fully actionable rules with real commands and a clearly gated brief/build/subtract/verify workflow, delegating depth to a well-organized one-level reference library. The only cost is that extreme compression makes a few passages (the draft-guard stripe rules) harder to parse than their content warrants.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense instruction with zero explanation of concepts Claude already knows and no filler (e.g., "Touch layouts: at least 44x44 pt per interactive element, 8-12 pt between neighbours"). It loses the 5 only to minor trim opportunities: the Layer A skills are described both in the routing table and again in the reference-library table, and the first draft-guard bullet is a very long single sentence that restates the banned patterns in several notations. | 4 / 5 |
Actionability | Guidance is fully executable: copy-paste commands ("bun $SKILL_DIR/scripts/perfection/check-draft-guard.ts <changed files or dirs>", the lighthouse-audit.py and three search.py invocations with flags), exact file paths per request type in the routing table, and concrete numeric rules (44x44 pt hit targets, ~10px glyph padding, one icon set named: Lucide, Heroicons, Radix, Phosphor) with named anti-patterns ("border-l-4 border-indigo-500"). All referenced scripts and files exist in the bundle. | 5 / 5 |
Workflow Clarity | The flow is explicitly sequenced — brief -> build -> subtract -> verify as numbered sections — with validation checkpoints throughout: before-captures "BEFORE the first edit", "Lint before visual QA" with an explicit failure contract ("Exit 1 means a tell is in the draft: remove it"), the required-content reconciliation after subtraction, and the /visual-qa gate with a bounded review loop. This matches the 5 anchor's explicit validation and feedback-loop structure. | 5 / 5 |
Progressive Disclosure | The file is openly a router ("This file is a router over references/; the rules live there") with a request-to-file routing table, and the reference library (design/ Layer A + Layer B, perfection/, ui-ux-db/, designpowers/) is cataloged with _INDEX.md for discovery. Every referenced path I checked (design skills, perfection README and scripts, ui-ux-db search.py, designpowers lanes) exists and is one clearly-signaled level deep, matching the 5 anchor. | 5 / 5 |
Total | 19 / 20 Passed |