Content
77%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 content is a strong, highly actionable workflow document: an eight-stage pipeline with genuine validation feedback loops, copy-paste commands, and explicit ownership rules. Its weaknesses are structural — a Hard Rules section that duplicates the workflow, a machine-specific absolute path, and a coverage matrix inlined in SKILL.md despite the skill itself stating such expectations belong in a reference doc.
Suggestions
Move the Editor Selection Navigation Coverage matrix detail (lines 200-231) into docs/slate-v2/selection-navigation-coverage.md and keep only the pointer plus the 'name command/direction/topology/state' summary inline, per the skill's own rule that oversized expectations go to a reference doc.
Deduplicate Hard Rules against the workflow sections — keep Hard Rules to true invariants and let the Architecture Pressure Review and Benchmark Target Handoff sections own their details, cutting roughly 30-40 lines.
Replace the machine-specific absolute path '/Users/zbeyens/git/plate-2/.agents/skills/autoreview/scripts/autoreview' with a checkout-relative invocation so the command is executable on any machine.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, imperative, and almost entirely project-specific with no explanations of concepts Claude already knows, but the 'Hard Rules' section substantially duplicates the workflow sections (architecture pressure, benchmark handoff, and autoreview rules each appear twice across ~370 lines), leaving trimmable repetition that keeps it below the 'every token earns its place' anchor. | 4 / 5 |
Actionability | Concrete commands ('pnpm bench:targets:check', 'pnpm bench:targets:dry-run -- <target-id>', the autoreview invocation with cwd), explicit file paths, a red-test taxonomy, and an explicit verdict enum make the guidance mostly executable; the machine-specific absolute path '/Users/zbeyens/git/plate-2/...' and a few abstract directives ('review it like a harsh Slate maintainer') are the minor gaps. | 4 / 5 |
Workflow Clarity | Eight clearly sequenced workflow stages each carry explicit validation checkpoints and feedback loops: rework-before-verify on a weak pressure review, an explicit keep/rework/escalate verdict, verify gates with unrelated-debt recording, and 'rerun focused proof and autoreview until no accepted/actionable findings remain'. | 5 / 5 |
Progressive Disclosure | No bundle files (references/, scripts/, assets/) exist, and the body inlines a detailed selection-navigation coverage matrix whose authoritative version is stated to live in 'docs/slate-v2/selection-navigation-coverage.md' — content that should be separate is inline — though section headers are well organized and the external references are named explicitly rather than buried. | 3 / 5 |
Total | 16 / 20 Passed |