Content
81%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-structured, opinionated instruction skill: the workflow is explicitly sequenced with real validation checkpoints and recovery loops, and detail is correctly pushed into a complete, well-signaled reference bundle. The remaining costs are duplicated mode-routing prose, a few non-earning tokens, and rule text that occasionally stays at judgment level without worked examples.
Suggestions
Deduplicate the mode-routing logic between the Chinese gut-feel complaints paragraph and the Mode Picker section so each routing rule is stated once.
Number the main path steps explicitly (preflight, mode pick, direction lock, build, aesthetic review, handoff) so the base sequence stays legible under the many exception branches.
Trim low-earning tokens (e.g. the 🥷 prefix instruction) and split the longest compound sentences to lift token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with novel, opinionated rules and never explains concepts Claude already knows, so it is clearly above anchor 3. It is not anchor 5 because some redundancy and padding could be trimmed: mode-routing logic is stated twice (the Chinese gut-feel paragraph and the Mode Picker paragraph both route generated-asset vs screenshot-iteration), the 'Prefix your first line with 🥷' line is a non-earning quirk token, and several very long compound sentences could be split. | 4 / 5 |
Actionability | As an instruction-only skill it carries no code, which the scoring notes say is not penalized if guidance is actionable, and much of it is: concrete file names to grep (theme.ts, tokens.css, _variables.scss), a five-item direction checklist, a routing table with file paths, a gotchas table, and a fixed handoff output format. It stops short of anchor 5 because several rules remain judgment-level ('take colour, type, width, and voice from the current product's tokens first') without worked examples, and the anchor-5 bar of copy-paste-ready guidance covering common cases is only partially met. | 4 / 5 |
Workflow Clarity | The flow is clearly sequenced (preflight, mode pick, direction lock, thesis summary, build, aesthetic review, handoff) with explicit validation steps: 'Do not write code until all five are resolved', the Aesthetic Review and AI Slop Test checks, and mandated viewport rendering with 'if any check fails, fix first'. Feedback loops exist (a contradictory answer reopens only the affected dimension; gotchas give recovery rules), matching anchor 5. Anchor 4's 'minor validation gaps' do not apply, though the many exception branches (app shell, dashboard, native app, document route-out) add reading overhead the sequence itself absorbs. | 5 / 5 |
Progressive Disclosure | Scored against the actual bundle: every referenced file (durable-context.md, mode-quick-fix.md, mode-screenshot-iteration.md, mode-generated-asset.md, design-reference.md, design-native-motion.md, design-data-viz.md) exists, and the Mode Picker table signals when to load each. This is good structure per anchor 4, not anchor 5, because the body inlines a substantial amount of dense rule content beyond a pure overview, and bundle files cross-link each other (mode-quick-fix and mode-screenshot-iteration both point onward to design-reference.md), creating mild two-hop chains even though all files are also directly reachable from SKILL.md. | 4 / 5 |
Total | 17 / 20 Passed |