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 a well-structured, token-efficient overview with exemplary progressive disclosure to a real one-level reference file. Its main gaps are instructional: it relies on the reference file for all executable detail (no inline snippet of hint syntax) and its Check/Fix flow lacks a post-fix verification step.
Suggestions
Inline one minimal copy-paste example (e.g. a `<link rel="preload" href="/fonts/inter-latin.woff2" as="font" type="font/woff2" crossorigin>` snippet) so the Fix section is actionable without opening the reference file.
Add an explicit post-fix validation step, such as re-running Lighthouse or checking the Network/Waterfall panel to confirm the hint fires and LCP improves.
Drop or compress the "Explain" section, which asks Claude to describe differences it already knows, into a one-line pointer to the reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~33-line body is lean: a Quick Reference of four one-line hint mappings, short Check/Fix sections, and a pointer to the reference file, with no tutorial padding about what resource hints are. Not a 5 because sections like "Explain the differences between preload, prefetch, preconnect, and dns-prefetch" restate knowledge Claude already has and the "Check" line duplicates the title's instruction. | 4 / 5 |
Actionability | The Quick Reference gives concrete mappings ("Use preload for critical above-the-fold resources (fonts, hero images)", "Use preconnect for third-party origins") but the body contains no executable code or syntax — e.g. "Add appropriate resource hints (preload, prefetch, preconnect) for critical assets" is a high-level instruction, with the actual HTML examples deferred entirely to references/rule.md. This sits between anchors 2 and 4: useful concrete guidance, but incomplete on its own. | 3 / 5 |
Workflow Clarity | A rough sequence exists via the Check → Fix → Explain → Code Review sections, and the Code Review section asks to "describe the measurement method used to confirm the issue". But validation checkpoints are implicit: there is no verify-after-fix step (e.g. re-measure LCP or confirm hints render in the Network panel), matching anchor 3 rather than 4. | 3 / 5 |
Progressive Disclosure | The body is a concise overview that defers full implementation details, code examples, and framework guidance to a single clearly signaled one-level-deep reference ("see `references/rule.md`"), and that file exists and contains the promised code examples. This matches the anchor for a clear overview with well-signaled, appropriately split content. | 5 / 5 |
Total | 15 / 20 Passed |