Content
82%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-organized, actionable body with concrete code, a format table, named tools, and a clear multi-step workflow plus a data-availability rule. The main gaps are minor verbosity on near-basic concepts and missing explicit feedback loops for the destructive migration/cleanup operations.
Suggestions
Trim near-basic explanations (e.g., the CDN and shared-folder asides) to tighten conciseness toward a lean 5.
Add an explicit validate-then-proceed feedback loop for destructive/batch steps like media migration and unused-asset cleanup (e.g., verify a sample after migration, confirm deletion candidates before lifecycle deletion).
Consider moving the full inline <img>/<picture> HTML patterns into references/responsive-image-patterns.md and keeping only one representative snippet inline, to sharpen progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and assumes Claude's competence, with copy-paste HTML and a tight format table, but includes a few explanations of near-basics ('CDN: required for any non-trivial volume. Edge caching, global distribution.', 'A simple shared folder works at low scale') that could be trimmed. | 4 / 5 |
Actionability | Fully executable guidance: copy-paste-ready <img>/<picture> HTML patterns, a concrete format reference table, named tools (Lighthouse, WebPageTest), and named services (Cloudinary, imgix, Cloudflare Images, Bunny) covering the common cases. | 5 / 5 |
Workflow Clarity | A clearly sequenced 8-step workflow with an explicit audit checkpoint (Step 2) and a sanctioned 'If required data is unavailable' gap rule, but the destructive/batch operations (media migration, unused-asset cleanup, lifecycle policies) lack explicit validate-then-proceed feedback loops, leaving minor validation gaps. | 4 / 5 |
Progressive Disclosure | Good structure with a well-signaled, single-level reference to the verified references/responsive-image-patterns.md file in a dedicated 'Reference files' section; a few inline HTML patterns could arguably live in the reference, but organization is mostly appropriate. | 4 / 5 |
Total | 17 / 20 Passed |