Content
65%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.
The body is a well-structured, token-efficient overview that delegates implementation detail to a real, clearly signaled one-level-deep reference. Its weaknesses are the absence of any executable specifics or concrete values in the body itself and a missing validation loop — nothing instructs re-measuring CLS after fixes to confirm the improvement.
Suggestions
Add a closing verification step to the workflow, e.g. 'After applying fixes, re-run Lighthouse and confirm CLS is below 0.1; if not, use a PerformanceObserver layout-shift entry to identify the remaining shifting elements.'
Make the Fix section slightly more concrete in-body (name 'font-display: swap' and 'aspect-ratio' rather than 'font-display strategies' and 'dimensions'), even while keeping code in the reference.
Drop or fold the 'Explain' section — its content duplicates the intro and instructs Claude to explain a concept it already knows.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with tight sections (Quick Reference, Check, Fix, Explain, Code Review) and no tutorial-style padding. It loses a point because the 'Explain' section re-states the intro's content ('accidental clicks, reading disruption, and user frustration') and directs Claude to explain a concept it already knows, which could be trimmed. | 4 / 5 |
Actionability | The Fix section names concrete strategies ('Reserve space for images/embeds with dimensions, use font-display strategies, and avoid injecting content above existing content') and Check names real tools (Lighthouse, PageSpeed Insights), but the body contains no commands, code, or specific values — 'use font-display strategies' leaves which strategy unspecified, and all executable detail is delegated to the reference. This matches the some-concrete-guidance-but-incomplete anchor. | 3 / 5 |
Workflow Clarity | A rough sequence is present (Check → Fix → Explain → Code Review), but there is no validation checkpoint closing the loop — nothing says to re-measure CLS after applying fixes to confirm the score dropped below 0.1, and no guidance on interpreting the measurement before choosing a fix. The verification loop is only implicit, matching the steps-listed-but-checkpoints-missing anchor. | 3 / 5 |
Progressive Disclosure | The body is under 50 lines, clearly sectioned, and appropriately splits content: it keeps a concise overview inline and delegates all code examples and framework-specific guidance to references/rule.md (verified as a real file) with a clear, well-signaled, one-level-deep pointer ('For full implementation details, code examples, and framework-specific guidance, see references/rule.md'). Navigation is easy and the split is clean. | 5 / 5 |
Total | 15 / 20 Passed |