Content
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured overview that uses progressive disclosure effectively by deferring code to references/rule.md, but the body itself trades some token efficiency for motivational explanation and lacks executable examples or explicit validation checkpoints. Tightening the intro and adding a concrete size-limit/Lighthouse CI snippet would lift the weaker dimensions.
Suggestions
Trim the motivational opening paragraph and remove overlap between Check/Fix/Explain/Code Review so every token earns its place.
Add one copy-paste-ready example in the Fix section (e.g., a minimal size-limit package.json block or a Lighthouse CI assertion snippet) instead of deferring all code to the reference.
Add an explicit validation checkpoint to the workflow (e.g., 'After adding budgets, confirm CI fails on a deliberately oversized PR before merging').
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The Quick Reference and sectioned guidance are mostly efficient, but the motivational intro ('performance degrades gradually…now takes 5', 'far cheaper than debugging a slow production site') explains concepts Claude already knows and the Check/Fix/Explain/Code Review sections overlap. | 2 / 3 |
Actionability | It names concrete tools and thresholds ('size-limit', 'Lighthouse CI assertions', 'max LCP time') but provides no executable code or commands in the body, deferring all implementation to the reference file. | 2 / 3 |
Workflow Clarity | A Check→Fix→Code Review sequence and a flagging checklist are present, but there are no explicit validation/feedback checkpoints and the sections read as partly redundant categorized tasks rather than a tightly sequenced workflow. | 2 / 3 |
Progressive Disclosure | The body is a well-organized overview (Quick Reference, Check, Fix, Explain, Code Review) with a clearly signaled one-level-deep pointer to references/rule.md for full implementation details, and that file exists. | 3 / 3 |
Total | 9 / 12 Passed |