Content
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is well-structured with a clean overview and a properly signaled one-level reference, but it pads the Explain section with redundant concept teaching, promises a before/after HTML example it never shows, and lacks an explicit verification checkpoint in the workflow.
Suggestions
Trim the 'Explain' section to stop re-teaching the bandwidth/pixel-count concept and remove the repeated wastage-ratio examples already covered in the intro and Quick Reference.
Replace the 'Show complete before/after HTML' directive with an actual <img srcset="..." sizes="..."> before/after code block so the guidance is copy-paste ready.
Add an explicit numbered verify step (e.g., '6) Re-run Lighthouse and confirm Properly size images reports 0 KiB savings') to close the workflow with a validation checkpoint.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 'Explain' section re-teaches a concept Claude already knows ('bandwidth scales with pixel count, not linear dimensions') and wastage ratios repeat across the intro, Quick Reference, and Explain (16x / 4x / 25x); the Check/Fix sections are tight, so it is mostly efficient with some unnecessary explanation. | 2 / 3 |
Actionability | Offers concrete guidance ('Generate multiple size variants: 400w, 800w, 1200w, 1600w (use Sharp or Squoosh)' and a real sizes="..." example) but instructs itself to 'Show complete before/after HTML' without ever delivering an actual <img srcset> markup example, leaving key details missing. | 2 / 3 |
Workflow Clarity | Check (1-4) and Fix (1-5) are clearly sequenced and verification signals appear (Lighthouse audit as primary signal, 'confirm the fix in DevTools'), but there is no explicit numbered verify-checkpoint or fix->retry feedback loop in the sequence. | 2 / 3 |
Progressive Disclosure | A well-organized overview (Quick Reference, Check, Fix, Explain, Code Review) with a clearly signaled one-level-deep reference ('see references/rule.md', which exists) — content is appropriately split and easy to navigate. | 3 / 3 |
Total | 9 / 12 Passed |