Content
71%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, actionable overview with a clean one-level-deep reference and concrete check/fix steps. Its weakest point is redundancy: the Explain and Code Review sections restate material Claude already knows or that the description already covers, and a re-validation loop after fixes is only implicit.
Suggestions
Cut or shrink the 'Explain' section: it repeats the intro's 'renders nothing in browsers that don't support <picture> (IE11)' sentence verbatim and re-explains how <source> selection works, which Claude already knows.
Drop or merge the 'Code Review' section, which restates the description's scope; fold its one unique element (confirming fixes in DevTools) into a final verification step after 'Fix'.
Add an explicit re-check loop to 'Fix' — e.g. 'After applying fixes, re-run the Check list on each corrected <picture>' — to close the batch-review workflow's feedback gap.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short and mostly efficient, but the 'Explain' section repeats the intro's sentence verbatim ('A <picture> without an <img> fallback renders nothing in browsers that don't support <picture> (IE11)...') and re-explains how <picture> source selection works — a concept Claude already knows. The 'Code Review' section also largely restates the description. Not a 4 because there are two genuinely redundant sections, not just minor trimming. | 3 / 5 |
Actionability | The 'Check' section enumerates six concrete verifications (img as last child, alt, width/height, source ordering, srcset/media, type attributes) and 'Fix' gives exact remediation with concrete markup like 'add <img src="{fallback-url}" alt="{description}" width="{w}" height="{h}">' and 'type="image/avif"'. Not a 5 because the fix markup uses placeholders rather than a copy-paste-ready example, and no inline code snippet is shown (examples live only in the reference). | 4 / 5 |
Workflow Clarity | Clear Check → Fix → Code Review sequence with enumerated steps ('Scan all <picture> elements... Verify: 1)–6)') and a verification checkpoint ('describe how to confirm the fix in DevTools'). Not a 5 because there is no explicit re-check loop after fixes are applied (fix → re-scan), leaving the batch-review workflow's feedback loop implicit. | 4 / 5 |
Progressive Disclosure | The ~45-line body is well organized into Quick Reference / Check / Fix / Explain / Code Review sections and delegates full implementation detail via a single, clearly signaled one-level reference: 'see `references/rule.md`' — a file that exists in the bundle. No nested references and nothing inlined that belongs in a separate file. | 5 / 5 |
Total | 16 / 20 Passed |