Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is actionable and well-structured with a clean single-level reference, but it spends tokens explaining compression fundamentals Claude already knows and omits an explicit validation/verification checkpoint for the batch re-encoding workflow it prescribes.
Suggestions
Trim the intro and "Explain" section to remove concept primers (DCT/quantisation, what EXIF is) that duplicate references/rule.md and assume Claude's knowledge.
Add a verification/feedback step in the Fix section — e.g. re-run Lighthouse or check Transfer Size in DevTools and re-encode if savings remain — so the batch operation has an explicit validate-then-retry loop.
Move or fold the duplicated "Why it matters" sizing example (8MB DSLR vs 200KB) into the reference rather than restating it in the overview body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient, but the intro and "Explain" section restate JPEG/PNG/DCT/EXIF mechanics Claude already knows (e.g. "JPEG compression works by converting pixel data to frequency components (DCT) and quantising..."), which is unnecessary padding also duplicated in references/rule.md. | 2 / 3 |
Actionability | It gives concrete, copy-paste-ready values for every format — mozjpeg quality 80 progressive=true, pngquant quality 65-80, oxipng, SVGO, WebP quality 80, AVIF quality 60 effort 6 — matching the fully-executable-guidance anchor. | 3 / 3 |
Workflow Clarity | The Check and Fix sections are numbered sequences, but auditing/re-encoding every image is a batch operation with no explicit validation or verify-and-retry checkpoint in the body itself (verification lives only in the reference), which caps workflow clarity at 2. | 2 / 3 |
Progressive Disclosure | The body is a clear overview with well-organized sections and a single well-signaled, one-level-deep pointer to references/rule.md, which exists as a real file holding the detailed implementation guidance. | 3 / 3 |
Total | 10 / 12 Passed |