Content
65%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.
The body is a well-organized, token-efficient overview that correctly pushes implementation detail to a real one-level-deep reference file. Its weaknesses are in the body's own guidance: no executable command or code snippet inline, and no explicit measurement-verification checkpoint, leaving both actionability and workflow clarity at the mid anchor.
Suggestions
Inline one copy-paste-ready command in the Check section (e.g., `lighthouse https://example.com --chrome-flags="--headless"`) so the body is immediately actionable without opening the reference.
Add an explicit validation step after Fix, such as "Re-run the audit and confirm the targeted metric (LCP/CLS/INP) improves before considering the change done" — the verification content already exists in references/rule.md and should be signaled from the body.
Trim the Quick Reference bullets or merge them with the Check section to remove overlap with the intro and Fix sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 44-line body is lean and well-sectioned, with only minor trimmable redundancy: the intro sentence ("Static analysis alone cannot simulate...") and the Quick Reference bullets partially restate the Check/Fix sections. Efficient but not perfectly lean, matching anchor 4 over 5. | 4 / 5 |
Actionability | Concrete tool names (Lighthouse, Puppeteer, WebPageTest) and metrics (LCP, CLS, INP) appear, but the body contains no commands or code — "Integrate browser-based testing tools like Lighthouse or WebPageTest into the development workflow and CI/CD pipeline" is a high-level directive. This matches anchor 3 (some concrete guidance but incomplete); the executable steps exist only in references/rule.md. | 3 / 5 |
Workflow Clarity | Check → Fix → Explain → Code Review forms a recognizable sequence, but the body has no explicit validation checkpoint — the "confirm the targeted metric improves" step lives only in rule.md's Verification section and is not signaled from the body. Anchor 3 (steps listed, checkpoints implicit or missing) fits better than 4. | 3 / 5 |
Progressive Disclosure | A short overview with a clearly signaled one-level-deep reference — references/rule.md (verified to exist, containing the full implementation details, code, and verification steps, with no further nesting) — plus the source page URL. Well-organized sections under 50 lines, matching the top anchor and the simple-skill guidance. | 5 / 5 |
Total | 15 / 20 Passed |