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 well structured with a clean Check/Fix split and proper use of a single reference file, and its thresholds are concrete and executable. It is held back by repeated explanations across sections and the absence of an explicit post-fix validation step for a batch operation.
Suggestions
Deduplicate the content: state the sizes-attribute/100vw behavior and bandwidth rationale once instead of repeating them across the intro, Quick Reference, and Explain sections.
Add an explicit verification step after Fix, e.g. "Re-run the Lighthouse 'Properly size images' audit and confirm the flagged images no longer appear" instead of the vague DevTools mention.
Inline one complete before/after <img> example (or clearly label the reference as containing them) so the Fix section does not rely on the instruction "Show complete before/after HTML".
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The sizes/100vw point appears in both Quick Reference and Explain, the bandwidth-waste rationale is repeated between the intro and Explain, and the Lighthouse audit is named four times — the content is mostly efficient but noticeably redundant and could be tightened. | 3 / 5 |
Actionability | Concrete thresholds ("more than 2x the rendered width", "images over 200px wide"), a specific variant set (400w/800w/1200w/1600w), a working sizes example, and named tools (Sharp, Squoosh) make the guidance mostly executable; the gap is that "Show complete before/after HTML" instructs rather than shows, deferring actual markup to the reference. | 4 / 5 |
Workflow Clarity | The Check → Fix → Explain → Code Review sequence is clearly ordered, but for a batch audit-and-fix operation the only verification is the vague "describe how to confirm the fix in DevTools" — no explicit validation checkpoint, capping this at 3. | 3 / 5 |
Progressive Disclosure | A short overview body defers full implementation details to a single, clearly signaled, one-level-deep reference (`references/rule.md`, which exists), with well-organized sections making navigation easy. | 5 / 5 |
Total | 15 / 20 Passed |