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 compact, well-structured overview with excellent progressive disclosure into a real reference file, but its own guidance stays at the advisory level: no executable commands in the body and no post-fix verification step, leaving the workflow's checkpoints implicit.
Suggestions
Add one concrete measurement command to the Check section (e.g. how to view gzipped size or the DevTools Coverage tab) so the >50KB threshold is actionable without opening the reference.
Surface the post-fix verification loop from references/rule.md (re-run Lighthouse/PageSpeed and confirm the metric improves) as an explicit final step in the body.
Trim the opening sentence about CSSOM construction and render-blocking, which restates knowledge Claude already has.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~30-line body is lean and directive, with only minor trimmable content: the opening sentence "Large CSS files block rendering and increase the time it takes for the browser to construct the CSSOM" explains a rendering-path concept Claude already knows. | 4 / 5 |
Actionability | The body offers some concrete anchors ("> 50KB gzipped" threshold, "PurgeCSS", "DevTools, Lighthouse, or field data", page-specific splitting) but no executable commands or code in the body itself — e.g. how to measure gzipped size or invoke a minifier — which are deferred to references/rule.md without signposting which tool to run. | 3 / 5 |
Workflow Clarity | The Check → Fix → Explain → Code Review sequence is present and the Check step ("Audit the size of CSS files and identify those exceeding recommended limits") acts as an implicit measurement checkpoint, but there is no post-fix validation step in the body; the Verification guidance exists only in references/rule.md and is not surfaced. | 3 / 5 |
Progressive Disclosure | The short body is cleanly sectioned and ends with a clearly signaled, one-level-deep reference ("For full implementation details, code examples, and framework-specific guidance, see references/rule.md") that exists and does contain those implementation details, so navigation is easy and content is appropriately split. | 5 / 5 |
Total | 15 / 20 Passed |