Content
86%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, action-oriented body: executable HTML examples for the common gallery shapes, concrete option-boundary rules, red flags, and a verification checklist, with detailed material correctly split into a one-level-deep reference that exists in the bundle. Weaknesses are minor — a duplicated doc URL list and absent error-recovery feedback loops in the workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence (no explanation of what galleries or lazy loading are), but the 7-line docs.sirv.com URL list duplicates the 'Official Docs Map' in references/implementation.md verbatim, and 'Red Flags'/'Verification' overlap workflow steps 6-8 (lazy/LCP, reserving space, data-alt, CSP) — minor trims available. | 4 / 5 |
Actionability | Three complete, copy-paste-ready HTML blocks cover the common markup shapes (mixed child-item gallery with preconnect/script, smart .view gallery, single-div comma-separated gallery), and concrete attribute-level guidance follows ('autostart:created', 'thumbnails.position:bottom', 'itemsOrder:spin, zoom, video, model, image'). | 5 / 5 |
Workflow Clarity | The 8-step Default Workflow is clearly sequenced from media identification through real-browser verification, and the Verification section is an explicit checklist, but there are no error-recovery feedback loops (e.g., what to do when a data-src 404s or CSP blocks a resource), matching anchor 4's 'minor validation gaps'. | 4 / 5 |
Progressive Disclosure | Clear overview structure with a well-signaled, one-level-deep reference: 'Read [implementation.md](references/implementation.md) when writing or reviewing viewer markup, script loading, options, breakpoints, smart galleries, API/events, or CSP' — the file exists and the body appropriately keeps only overview patterns inline. | 5 / 5 |
Total | 18 / 20 Passed |