Content
78%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.
A well-structured overview body: concrete thresholds, a clear Check→Fix→Explain sequence, and correct deferral of code examples to a real one-level-deep reference file. The main shortfalls are the absence of any executable command (e.g., a WebP/AVIF conversion CLI) and no explicit re-check loop after fixes.
Suggestions
Add one concrete conversion command (e.g., a cwebp/avifenc invocation with the 80%/60% quality flags) or a corrected <picture>+srcset snippet in the Fix section so guidance is copy-paste ready.
Close the loop after fixes with an explicit re-check step ('re-run the Check pass and confirm encoded size and layout shift in DevTools before reporting done').
Trim the Quick Reference bullets that duplicate Check/Fix items, and drop the opening page-weight sentence already repeated verbatim in references/rule.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient — numbered Check/Fix steps carry concrete thresholds ("< 200KB for photos, < 50KB for graphics", "> 100px wide", "400w, 800w, 1200w, 1600w variants") with no explanations of concepts Claude doesn't know. Minor trim opportunities remain: the Quick Reference bullets duplicate Check/Fix items, and the opening motivation sentence is repeated verbatim in references/rule.md, so anchor 4 fits better than 5's 'every token earns its place'. | 4 / 5 |
Actionability | Guidance is specific and executable in direction — exact size/quality thresholds, srcset variant widths, and per-issue fix steps — but the body contains no runnable commands or code: "Convert JPEG/PNG photos to WebP" lacks a conversion command, and the example markup lives only in references/rule.md. This matches anchor 4 ('mostly executable... minor gaps'); anchor 5 requires copy-paste-ready code or commands in the body itself. | 4 / 5 |
Workflow Clarity | A clear phased sequence (Check → Fix → Explain) with the Check phase serving as per-image validation ("Report issues grouped by severity with file paths") and post-fix verification guidance ("describe how to confirm the fix in DevTools"). The gap is that there is no explicit re-run/re-check loop after applying fixes, so anchor 4 fits rather than 5; the batch scan does include verification steps, so the batch-operation cap of 3 does not apply. | 4 / 5 |
Progressive Disclosure | A lean ~45-line overview body with a single, clearly signaled, one-level-deep reference: "For full implementation details, code examples, and framework-specific guidance, see `references/rule.md`" — verified to exist and to contain the deferred code examples and format comparison table. This matches anchor 5's clear overview with well-signaled one-level-deep references and easy navigation. | 5 / 5 |
Total | 17 / 20 Passed |