Content
57%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-structured, appropriately delegated overview: it is lean and points cleanly to a real, substantive reference file. Its main weakness is actionability — the body itself contains only high-level direction with no executable commands, and the workflow lacks explicit validation checkpoints after fixes.
Suggestions
Inline one or two executable commands in the Check section (e.g. `npm ls <package>` or `pnpm why <package>`) so the core loop is executable without opening the reference file.
Add a post-fix verification step (re-run the bundle analysis or Lighthouse audit to confirm the duplicates are gone) to create a feedback loop.
Remove the generic "Explain" section or fold it into the intro, since explaining what duplicate libraries are adds tokens without actionable guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short (~40 lines) and efficiently delegates detail to the reference file. Two minor over-explanations remain: the opening sentence about what duplicate libraries do (concepts Claude already knows) and the generic "Explain the risks..." section, which adds little actionable value. This matches anchor 4 (efficient with minor trims possible) rather than 5. | 4 / 5 |
Actionability | The Check/Fix sections give only high-level hints ("using Lighthouse or bundle analysis tools", "Consolidate dependencies to use a single version") with no commands or code, while the concrete executable guidance (npm ls, package.json overrides) lives only in references/rule.md. This matches anchor 2 (high-level hints missing the specific steps) better than anchor 3, since no concrete command or example appears in the body itself. | 2 / 5 |
Workflow Clarity | The Check → Fix → Explain → Code Review sections present a rough sequence, but there are no validation checkpoints (e.g. re-measure after consolidation to confirm the fix) — verification is only implied by "describe the measurement method used to confirm the issue". This fits anchor 3 (sequence present, checkpoints missing or implicit). | 3 / 5 |
Progressive Disclosure | The body is a lean overview that delegates all implementation detail via a clearly signaled, one-level-deep pointer to references/rule.md, which exists and contains the concrete commands and examples. This matches anchor 5 (clear overview with well-signaled single-level references and appropriate content split). | 5 / 5 |
Total | 14 / 20 Passed |