Content
80%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is an exceptionally lean, actionable set of aesthetic DO/DON'T guidance with well-signaled reference pointers. Its main weaknesses are a soft rather than explicit validation workflow and reference links that point to files not present in the bundle.
Suggestions
Ship the referenced reference files (typography.md, color-and-contrast.md, spatial-design.md, motion-design.md, interaction-design.md, responsive-design.md, ux-writing.md) under reference/ so the progressive-disclosure links resolve.
Make the build-and-review workflow explicit with sequenced steps and a hard checkpoint, e.g. 1) commit to a Design Direction, 2) implement, 3) run the AI Slop Test, 4) revise any failing DON'Ts before finalizing.
Reconcile the reference path convention (reference/ vs references/) with the bundle's actual directory name to avoid broken links.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, actionable DO/DON'T guidance with no padding or explanation of concepts Claude already knows; every guideline earns its place (e.g. "DON'T: Use pure black (#000) or pure white (#fff)—always tint"). | 3 / 3 |
Actionability | Despite being instruction-only with no code, the guidance is highly concrete and specific — named fonts to avoid, named CSS functions to use (oklch, color-mix, clamp, @container), and named anti-patterns — which the rubric rewards for actionable instruction-only skills. | 3 / 3 |
Workflow Clarity | A loose sequence exists (Design Direction → implement → AI Slop Test review) but it reads as a checklist rather than a tightly sequenced process, and the "AI Slop Test" checkpoint is soft rather than an explicit validate/fix/retry gate. | 2 / 3 |
Progressive Disclosure | Reference pointers are well-signaled and one-level-deep with a consistent format ("→ Consult [typography reference](reference/typography.md)"), but the referenced reference/ files do not exist in the bundle, so the disclosure path is broken and navigation cannot complete. | 2 / 3 |
Total | 10 / 12 Passed |