Content
31%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.
This is a well-organized UX textbook, not a skill: nearly all of it restates knowledge Claude already has, with almost no project-specific or executable guidance. The internal structure and occasional concrete specifics (formulas, ratios, code snippets) are its strengths, but it needs radical trimming and offloading to reference files.
Suggestions
Cut the explanations of universally known concepts (Nielsen's heuristics, Gestalt, Fitts's/Hick's/Miller's Laws, WCAG basics, SUS/NPS/CSAT definitions) and keep only non-obvious, project-specific guidance or decision rules.
Split the body into one-level-deep reference files (e.g. references/heuristics.md, references/accessibility.md, references/metrics.md, references/examples.md) and reduce SKILL.md to a short overview that links to them.
Replace the 15 generic product case studies with a few concrete, actionable patterns or checklists Claude can apply directly when the skill is invoked.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~1750-line body extensively explains standard concepts Claude already knows: Nielsen's 10 heuristics, Gestalt principles, Fitts's and Hick's Laws, Miller's Law, WCAG POUR, cognitive load theory, SUS/NPS/CSAT definitions, plus 15 product case studies with padded metrics. This matches anchor 1 ('Severely verbose; extensively explains concepts Claude already knows; heavily padded') and adds almost nothing Claude cannot already produce. | 1 / 5 |
Actionability | There are genuinely concrete details scattered throughout — the 4.5:1 contrast ratio, 44×44/48×48 touch targets, the SUS scoring formula and questionnaire, the ARIA landmarks code block, and participant-count guidance — but the bulk is descriptive principle explanation rather than executable instruction. This sits between anchor 2 (minimal concrete guidance) and anchor 4 (mostly executable guidance), landing at 3: some concrete guidance but incomplete as a working reference. | 3 / 5 |
Workflow Clarity | Several processes are clearly numbered (usability testing: planning → conducting → analysis → reporting; journey mapping's 8-step creation process; A/B testing best practices), giving a real sequence. However, checkpoints are implicit — e.g., tree testing says "test again until success rates acceptable" with no validate/fix/retry loop — matching anchor 3 ('Steps listed but validation gaps; checkpoints missing or implicit'). No destructive or batch operations are involved, so the cap does not apply. | 3 / 5 |
Progressive Disclosure | The entire skill is one monolithic 1750-line file with no bundle files in references/, scripts/, or assets/, and the body points to nothing external. Content that clearly belongs in separate files — the full heuristics reference, the WCAG details, the 15 examples, the metrics catalog — is all inlined, matching anchor 2 ('content that clearly belongs in separate files is inlined'). It avoids anchor 1 only because section headers provide navigable structure. | 2 / 5 |
Total | 9 / 20 Passed |