Content
57%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 has a clear structure, concrete fix steps, and exemplary progressive disclosure to a single real reference file. Its main weaknesses are redundant conceptual padding (the Explain section and intro re-teach CLS basics) and a verification step that is gestured at but never made concrete.
Suggestions
Delete the 'Explain' section and the CLS-threshold intro paragraph; Claude already knows why missing dimensions cause layout shift — keep only any non-obvious specifics (e.g., browser aspect-ratio derivation) as one line in Quick Reference.
Replace 'describe how to confirm the fix in DevTools' with a concrete verification checkpoint, e.g., 'Verify: in DevTools' Elements panel the computed aspect-ratio matches the attribute ratio, or the Performance panel's CLS contribution drops to 0 for the fixed image'.
Merge the 'Quick Reference' bullets into Check/Fix to remove duplication of 'Always set width and height' and 'Missing dimensions are the leading cause of CLS', which repeat other sections verbatim.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The intro paragraph and the entire 'Explain' section re-teach CLS basics Claude already knows ('a Core Web Vitals metric', 'Browsers derive aspect-ratio from these attributes'), and the 'Quick Reference' bullets plus the 'Code Review' section largely duplicate the Check/Fix content. There are several unnecessary explanation and padded sections, matching anchor 2 rather than anchor 3's mostly-efficient-with-minor-excess profile. | 2 / 5 |
Actionability | The Fix section gives numbered, executable steps with concrete values ('width="800" height="450"', 'CSS max-width: 100% and height: auto', 'CSS aspect-ratio property as a fallback') and Check specifies scanning <img> and <picture>/<source> with file-path-and-line reporting. Minor gaps: no before/after HTML snippet inline (deferred to references/rule.md) and no DevTools verification command, so it stops short of fully copy-paste-ready coverage. | 4 / 5 |
Workflow Clarity | The Check-then-Fix sequence is clearly ordered with exemption criteria and skip conditions, but validation is only vaguely referenced ('describe how to confirm the fix in DevTools') with no concrete checkpoint such as re-measuring CLS or inspecting the reserved aspect-ratio. This matches anchor 3: steps present but verification checkpoints missing or implicit, not anchor 4's mostly-present checkpoints. | 3 / 5 |
Progressive Disclosure | The ~35-line body is cleanly sectioned (Quick Reference, Check, Fix, Explain, Code Review) and ends with a single clearly-signaled, one-level-deep pointer ('see references/rule.md') that resolves to a real 193-line reference file. Per the simple-skill guidance, this is well-organized with easy navigation, matching anchor 5. | 5 / 5 |
Total | 14 / 20 Passed |