Content
71%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-sequenced, highly actionable design-instruction skill with concrete numeric guidance and a verification checklist, held back by moderate token redundancy and a monolithic single-file structure that inlines six detailed tactic sections rather than splitting them into reference files.
Suggestions
Split the detailed per-dimension tactic lists (typography, color, spatial, effects, motion, composition) into one-level-deep reference files (e.g., references/typography.md), keeping a concise overview in SKILL.md.
Deduplicate the repeated 'AI slop' / purple-gradient warnings into a single anti-patterns note to reclaim tokens.
Add one concrete before/after example (e.g., a timid vs. amplified heading/hero treatment) to anchor the abstract tactics in real output.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with actionable specifics ("3x-5x differences, not 1.5x", "900 weights with 200 weights", "100-200px gaps, not 20-40px") and wastes no tokens explaining concepts Claude already knows. It falls short of lean-perfection because the "bold means distinctive, not 'more effects'" point is stated twice (the AI SLOP TRAP warning and the closing test) and the purple-gradient warning is repeated across sections, plus a motivational closing paragraph that could be trimmed. | 4 / 5 |
Actionability | Concrete, executable parameters appear throughout ("60% of the design", "50-100ms delays", "ease-out-quart/quint/expo", "70/30, 80/20 splits") — specific guidance far beyond high-level hints, and the code-absence is acceptable for an instruction-only design skill. Minor gaps keep it from 5: no worked before/after example of applying tactics to real code, and font choices are deferred to "see frontend-design skill for inspiration" without a bundled reference. | 4 / 5 |
Workflow Clarity | A clear sequence is present (MANDATORY PREPARATION → Assess Current State → Plan Amplification → Amplify the Design → Verify Quality) with an explicit verification checklist ("Still functional", "NOT AI slop... If yes, start over") and an AskUserQuestion checkpoint for missing context. Not a 5 because the recovery path is only 'start over' rather than a targeted fix-and-recheck loop, and verification criteria are subjective rather than checkable. | 4 / 5 |
Progressive Disclosure | Sections are well organized with clear headers, but all ~110 lines of per-dimension tactic lists (typography, color, spatial, effects, motion, composition) are inlined in SKILL.md with no reference files at all (no references/, scripts/, or assets/ exist). The detailed tactic checklists could be split into one-level-deep reference files; this is above the 'minimal structure' anchor but does not reach 'good structure with content appropriately placed' since nothing is offloaded and the body exceeds the under-50-line simple-skill case. | 3 / 5 |
Total | 15 / 20 Passed |