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-organized and correctly defers detail to a real one-level reference, but it is light on executable guidance: it names tools and metrics without commands or code, presents categories instead of a sequenced workflow, and opens with conceptual explanation Claude already knows.
Suggestions
Add at least one concrete, runnable example in the body (e.g. an actual `lighthouse` CLI invocation or a Puppeteer snippet) instead of only naming the tools.
Convert the Check/Fix/Code Review sections into a short sequenced workflow with a validation checkpoint (e.g. run audit -> read LCP/CLS/INP -> confirm the bottleneck -> then recommend), rather than parallel topical categories.
Cut the opening paragraph explaining why static analysis cannot simulate browsers; Claude already knows this, and the Quick Reference already conveys the runtime-metric focus.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The opening sentence "Static analysis alone cannot simulate the complex rendering, script execution, and layout processes of modern web browsers..." explains a concept Claude already knows, and the "Explain" section repeats that rationale, so it is mostly efficient but carries unnecessary explanation that could be trimmed. | 2 / 3 |
Actionability | It names concrete tools and metrics (Lighthouse, Puppeteer, WebPageTest, LCP/CLS/INP) but provides no executable commands or code, and the Fix guidance "Integrate browser-based testing tools... into the development workflow and CI/CD pipeline" is vague direction that defers real examples to the reference file. | 2 / 3 |
Workflow Clarity | The Check/Fix/Explain/Code Review sections are topical categories rather than a sequenced workflow, and there are no explicit validation checkpoints; the Code Review section hints at a measurement method but no validate-then-fix loop is laid out. | 2 / 3 |
Progressive Disclosure | The body is a concise overview that signals a single one-level-deep reference — "see references/rule.md" for full implementation details and code examples — and that file exists, matching the "clear overview with well-signaled one-level-deep references" anchor. | 3 / 3 |
Total | 9 / 12 Passed |