Content
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is well-structured with a clean one-level-deep reference to a real rule.md, but it spends tokens re-explaining CLS concepts, keeps full executable code examples in the referenced file rather than inline, and treats fix verification only implicitly.
Suggestions
Trim the duplicated CLS mechanism explanation between the intro and the Explain section, trusting Claude's existing knowledge of Core Web Vitals.
Add at least one complete inline before/after HTML code block in the Fix section so the guidance is copy-paste ready without opening rule.md.
Make the verification step explicit in the workflow — e.g., a numbered 'Confirm in DevTools that no layout shift remains' checkpoint after fixing.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The opening paragraph and the Explain section both re-explain the CLS mechanism and Core Web Vitals background Claude already knows ('a Core Web Vitals metric', 'users accidentally click the wrong element'), so it is mostly efficient but could be tightened. | 2 / 3 |
Actionability | Concrete inline guidance exists (e.g., width="800" height="450", 'CSS max-width: 100% and height: auto'), but the full executable before/after HTML blocks are deferred to references/rule.md rather than provided inline, fitting 'some concrete guidance but incomplete'. | 2 / 3 |
Workflow Clarity | Check/Fix/Explain/Code Review sections with numbered Fix steps give a clear sequence, but the only verification ('describe how to confirm the fix in DevTools') is implicit rather than an explicit validation checkpoint in the workflow. | 2 / 3 |
Progressive Disclosure | The body is organized into clear sections (Quick Reference, Check, Fix, Explain, Code Review) and points to a single, clearly signaled one-level-deep reference — 'see references/rule.md' — which exists as a real file, matching 'clear overview with well-signaled one-level-deep references'. | 3 / 3 |
Total | 9 / 12 Passed |