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 dense, highly actionable reference body: every principle carries exact values, properties, or tokens, and the review output format and checklist make the deliverable unambiguous. Its main weakness is progressive disclosure — the four clearly-signaled reference files do not exist in the bundle, so the detail they promise is unavailable — with minor redundancy between the Quick Reference, Common Mistakes, and Reference Files sections.
Suggestions
Ship the four referenced files (typography.md, surfaces.md, animations.md, performance.md) in the bundle, or inline their essential patterns (e.g., the Motion/CSS cross-fade) — as delivered, every reference link in the body dangles and the delegated detail is unreachable.
Drop the 'Reference Files' section: it repeats the Quick Reference table's four links verbatim, and merge any Common Mistakes rows that merely restate a core principle (concentric radius, tabular-nums, transition: all) into the principle itself to cut redundancy.
Add a short ordered 'how to run a review' sequence (scope the diff → check each principle → emit Before/After tables → confirm with the checklist) so the review workflow is explicitly sequenced rather than implied by section order.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean, principle-per-line format with no padding and no explanation of concepts Claude already knows; every principle carries actionable specifics. Anchor 4 rather than 5 because of minor redundancy that could be trimmed: the 'Reference Files' section duplicates the Quick Reference table's four links, and the 'Common Mistakes' table restates several core principles (concentric radius, tabular-nums, initial={false}, transition: all, will-change, hit areas). | 4 / 5 |
Actionability | Fully concrete, copy-paste-ready guidance throughout: exact values ('about 0.96-0.97', '~100ms delay', '40x40px', '1px low-opacity outline'), exact properties and tokens ('text-wrap: balance', 'font-variant-numeric: tabular-nums', 'transition-property: scale, opacity', 'outline-[var(--border)]', 'active:scale-[0.96] transition-transform'), plus worked Before/After examples that cite specific files and properties. Specific examples cover the common cases, matching the anchor-5 pattern. | 5 / 5 |
Workflow Clarity | The review workflow is coherent and well-supported: Quick Reference routes to topic areas, the Review Output Format section precisely specifies deliverable structure with a worked example, and the Review Checklist serves as an explicit coverage checkpoint. Anchor 4 rather than 5 because the process is never explicitly sequenced (no ordered steps for conducting a review) and there is no verify-after-apply feedback loop; not 3 because the checklist and output-format example provide real checkpoints. | 4 / 5 |
Progressive Disclosure | References are clearly signaled and one level deep (Quick Reference table, inline 'see animations.md'/'see surfaces.md'), which is good design. However, all four referenced files (typography.md, surfaces.md, animations.md, performance.md) are absent from the bundle — the links dangle, navigation breaks, and delegated detail such as the 'Motion and CSS cross-fade patterns' is unreachable. Missing reference targets are more than a minor organization gap, so this sits between anchors 3 and 4. | 3 / 5 |
Total | 16 / 20 Passed |