Content
70%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-sequenced, highly actionable workflow with strong validation feedback loops, though it is somewhat verbose and monolithic. Its weakest point is progressive disclosure: substantial reference-grade detail is inlined rather than split into bundled reference files.
Suggestions
Move the Editor Selection Navigation Coverage matrix spec (command×direction×topology×starting-state rows) into a bundled reference doc and link to it one level deep, keeping only the decision rule inline.
Trim redundancy between the Hard Rules section and the Workflow steps so each rule is stated once in its authoritative location.
Replace the hardcoded `/Users/zbeyens/git/plate-2/.agents/skills/autoreview/scripts/autoreview` path with a checkout-relative invocation so the command is portable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence without explaining basics, but the Hard Rules section restates guidance elaborated later in the Workflow (reproduce-first, breaking changes), creating noticeable redundancy that could be tightened. | 3 / 5 |
Actionability | Concrete executable commands appear throughout (`pnpm bench:targets:check`, `bun check`, `rg`, the autoreview invocation), but the hardcoded `/Users/zbeyens/git/plate-2/...` path is environment-specific rather than copy-paste portable. | 4 / 5 |
Workflow Clarity | Eight numbered steps are clearly sequenced with explicit validation checkpoints — a failing red test, the keep/rework/escalate pressure verdict, verify gates, and a 'rerun until no findings' autoreview feedback loop — plus checklists for a complex process. | 5 / 5 |
Progressive Disclosure | Section headers give good internal structure and external doc paths are clearly signaled, but the monolithic body inlines reference-grade material (the command×direction×topology selection matrix, the bug-class taxonomy) with no bundled reference files to offload it to. | 3 / 5 |
Total | 15 / 20 Passed |