Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is highly actionable with concrete CLI commands and a clear, well-sequenced workflow plus validation checklists. Its main weakness is conciseness and progressive disclosure: a large inline rule catalog and duplicated checklist sections pad the token budget and overlap, where the reference material could be deferred to the bundled data store.
Suggestions
Move the ~270-entry Quick Reference rule catalog (§1–§10) into the bundled data store / a references file and keep SKILL.md as an overview with a pointer, trimming the inline catalog to the highest-priority items only.
Remove the duplicate "Common Rules for Professional UI" section and the second "Pre-Delivery Checklist", consolidating them with the existing Quick Reference and checklist to avoid restating WCAG/touch-target/line-height basics Claude already knows.
Ensure the data/ CSV directory the scripts depend on is bundled (or document where it comes from), since the shipped scripts reference DATA_DIR = .../data but only scripts/ is present.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body inlines a large catalog (~270 one-line rules across Quick Reference §1–§10) restating UI/a11y knowledge Claude already has ("Minimum 4.5:1 ratio", "Min 44×44pt", "Line-height 1.5"), plus a duplicated "Common Rules for Professional UI" section and a second "Pre-Delivery Checklist" overlapping the first — mostly efficient but padded and could be tightened, matching score 2. It is not a 1 because there is no explainer-style fluff and the command guidance is dense and useful; it is not a 3 because the inline rule catalog and duplicated checklists are token-heavy reference material that could live in the bundled data store. | 2 / 3 |
Actionability | Concrete copy-paste commands appear throughout ("python3 skills/ui-ux-pro-max/scripts/search.py \"<query>\" --design-system -p \"Project Name\"") with --domain, --stack, design dials, --persist/--page, output-format flags, a full example workflow, and a problem→rule mapping table, matching the score-3 executable-commands anchor. It is not a 2 because the guidance is specific and copy-paste ready rather than pseudocode. | 3 / 3 |
Workflow Clarity | A clear 4-step sequence (Analyze → "Generate Design System (REQUIRED)" → Supplement → Stack Guidelines) with an example workflow and an explicit Pre-Delivery Checklist validation pass matches the score-3 anchor of a clear sequence with checklists. It is not a 2 because validation checkpoints ("Run --domain ux ... as a UX validation pass before implementation" plus the checklist) are present and explicit. | 3 / 3 |
Progressive Disclosure | Detail is deferred to the bundled CLI scripts (search.py/core.py/design_system.py) which is good, but the SKILL.md itself inlines the ~270-rule Quick Reference catalog and a redundant "Common Rules" section — content that should be separate is inline — and the referenced data/ directory is absent, matching the score-2 anchor. It is not a 3 because the bulk of reference content lives in the markdown body rather than in clearly signaled one-level-deep reference files. | 2 / 3 |
Total | 10 / 12 Passed |