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 mature, opinionated skill body that routes cleanly to real one-level-deep references and gives concrete, executable design rules with specific values. It is slightly long in its exception-handling prose and could make intermediate validation gates as explicit as the final aesthetic review.
Suggestions
Tighten the direction-lock clarification-round and exception prose (app-shell, native-app, data-dashboard) into terser rules to reclaim tokens.
Add an explicit mid-build validation checkpoint (not only the handoff aesthetic review) so drift is caught before the final pass.
Consolidate the two overlapping aesthetic-quality references into one canonical pointer to remove the compatibility-map caveat that currently consumes a line.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense and opinionated, assuming Claude's competence without explaining basics, but the elaborate exception mechanics (clarification rounds, app-shell/native-app/data-dashboard carve-outs) could be tightened in places. | 4 / 5 |
Actionability | Concrete and executable guidance throughout: named hard bans, specific direction dimensions, exact values to lift (hex codes, spacing scale, border radii) and a precise shadow/lightness minimum ("sidebar vs main >=4% lightness difference", "0 1px 3px rgba(0,0,0,0.10)"). | 4 / 5 |
Workflow Clarity | Clear sequence from preflight through mode pick, direction lock, thesis summary, build, and a handoff aesthetic-review checklist with fix-first feedback, though per-step validation gates are less explicit than the final review. | 4 / 5 |
Progressive Disclosure | SKILL.md is a well-signaled overview with a mode-picker routing table pointing to one-level-deep reference files (design-reference, mode-quick-fix, mode-screenshot-iteration, mode-generated-asset, etc.), all of which exist under references/. | 5 / 5 |
Total | 17 / 20 Passed |