Content
61%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-organized, actionable overview that delegates detail to one reference file, but it carries redundancy with that reference and lacks an explicit verification checkpoint for what is fundamentally a batch audit workflow.
Suggestions
Add a 'Verify' step after Fix (e.g., re-run the Lighthouse 'Properly size images' audit or the DevTools console check from references/rule.md) so the batch workflow has an explicit validation checkpoint.
De-duplicate the body: remove the repeated hero-image megabytes sentence from the intro or Quick Reference, and tighten the intro since the same framing appears in references/rule.md.
Inline at least one minimal before/after <img> with srcset/sizes in the Fix section (or fix the unterminated quote in the inline sizes example) so the body is self-contained without requiring the reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient but contains redundancy — the hero-image megabytes sentence is repeated between the intro and Quick Reference, and the Quick Reference overlaps with the Check section; the intro paragraph could be trimmed since it reappears in references/rule.md. | 3 / 5 |
Actionability | Check and Fix give concrete, thresholded guidance (flag >2x intrinsic vs rendered, 200px srcset cutoff, generate 400w/800w/1200w/1600w with Sharp/Squoosh, a sizes example), but the body's promised 'complete before/after HTML' and full code live in the reference rather than inline. | 4 / 5 |
Workflow Clarity | Numbered sequences exist for Check (1-4) and Fix (1-5), but this is a batch/audit operation across all images with no explicit validation or verify-the-fix checkpoint in the body — the cap for batch operations without validation applies. | 3 / 5 |
Progressive Disclosure | Clear sectioned overview (Quick Reference, Check, Fix, Explain, Code Review) with a single well-signaled one-level-deep pointer to references/rule.md; the detailed Check/Fix steps are arguably content that could live in the reference, a minor organization gap. | 4 / 5 |
Total | 14 / 20 Passed |