Content
78%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 well-organized, actionable design-standards skill that uses concrete numbers throughout and cleanly separates overview from one-level-deep references. It could tighten a few basic-principle explanations and add explicit retry loops to its validation steps.
Suggestions
Trim the visual-hierarchy primer ('Size. The largest element gets noticed first', 'Bold beats regular at the same size') — Claude knows these; keep only the design-specific 'Common failures' that add value.
Add an explicit feedback loop to the Workflow validation steps, e.g. after 'Run contrast checks': 'If any combination fails AA, adjust the token and re-check before proceeding.'
Collapse redundant 'Common failures' bullets that merely restate the preceding rule (e.g., touch-target and spacing failure bullets duplicate their standards).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with concrete tables and bullet rules, but a few spots over-explain basics Claude already knows (e.g., 'Size. The largest element gets noticed first. Weight. Bold beats regular at the same size.') and some 'Common failures' items restate the preceding rule. | 4 / 5 |
Actionability | Highly concrete numerical guidance (4.5:1 contrast, 44x44 touch targets, 64px/48px section padding, 375-390px viewport, 16px input text), but it is intentionally stack-agnostic with code deferred to references, leaving a few statements principle-level ('Apply hierarchy intentionally'). | 4 / 5 |
Workflow Clarity | The 7-step Workflow is clearly sequenced with validation checkpoints (run contrast checks, test viewport breakpoints, run the pre-ship checklist), but lacks explicit failure feedback loops ('if it fails, fix and re-check'); not a destructive/batch skill so no cap applies. | 4 / 5 |
Progressive Disclosure | SKILL.md is a well-structured overview that points to three real one-level-deep reference files (design-tokens-template.md, preship-checklist.md, tailwind-patterns.md), each clearly signaled via markdown links and a dedicated 'Reference files' section, with content appropriately split. | 5 / 5 |
Total | 17 / 20 Passed |