Content
71%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 concise, well-structured overview that appropriately delegates implementation detail to a single real reference file. The body's main weakness is actionability: the Check/Fix sections stay at the directive level without surfacing even a minimal concrete check (e.g., a DevTools inspection step or a pointer to the reference's verification checklist), leaving the reader to discover the executable material on their own.
Suggestions
Surface one or two executable checks from references/rule.md in the body's Check section (e.g., confirm the image host is a CDN domain and inspect the Accept-header format negotiation in DevTools) so the core review action is actionable without opening the reference.
Link the reference's Verification checklist from the Check or Code Review section so the validation steps are discoverable from the body, strengthening workflow checkpoints.
Trim or merge the intro sentence and Quick Reference bullets, which both explain what image CDNs do — knowledge Claude already has.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and terse (Check/Fix/Explain/Code Review are each 1-2 sentences), but the intro sentence "Image CDNs automatically optimize, resize, and convert images on-the-fly..." explains a concept Claude already knows and partially duplicates the Quick Reference bullets. Minor over-explanation to trim keeps this at 4 rather than 5. | 4 / 5 |
Actionability | The body gives direction with some concrete anchors ("Configure an image CDN like Cloudinary, Imgix, or Cloudflare Images", "Flag exact files or components where format choice, sizing, or loading behavior violates the rule") but contains no code, commands, or concrete verification steps itself — the executable material is one reference hop away in references/rule.md. Some concrete guidance but missing key details matches anchor 3; it is not 2 because specific providers and review targets are named. | 3 / 5 |
Workflow Clarity | This is a simple, single-purpose review skill with an unambiguous action, and the Check -> Fix -> Explain -> Code Review sections present a clear sequence. It is not 5 because the verification checkpoints are implicit in the body (the actual 5-step verification checklist lives in references/rule.md and is not surfaced or linked from the Check section); it is above 3 because the sequence and deliverable are clear and the operation is non-destructive. | 4 / 5 |
Progressive Disclosure | A short, well-organized 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" — and that file exists, contains the implementation details (provider URL examples, Next.js config, responsive patterns, verification steps), and does not nest further references. Content is appropriately split and navigation is easy, matching anchor 5. | 5 / 5 |
Total | 16 / 20 Passed |