Content
86%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.
An exemplary instruction-skill body: copy-paste-ready commands for every input form, a tightly sequenced six-step workflow with explicit validation (self-check, guide validation, user-gated submission), and clean one-level progressive disclosure where each section defers detail to a real, verified reference file. The only notable deductions are minor redundancy (the tmp/ gitignore advice repeated, some page-UI mechanics inline) and the absence of an explicit failure-handling loop for the self-check.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense, imperative prose with no concept explanations and no padding — every section instructs rather than describes. Not a 5 because of minor redundancy: the tmp/review gitignore advice appears in both Usage and Gotchas, the feature-overview format is described in both Workflow step 3 and 'The overview' section, and some page-UI mechanics ('Inside a recommendation the reviewer can also accept, edit or dismiss each comment') could live in references/page.md. Not a 3 because there is no unnecessary explanation of things Claude already knows. | 4 / 5 |
Actionability | The 14-line usage block is copy-paste ready with concrete invocations for every input form (commit, range, PR, re-review, stdin), and the workflow names exact commands and paths: 'node $S/build-review.cjs <ref> --pr <N> --serve', 'node $S/pr-media.cjs --pr <N>', 'pbpaste | node $S/submit-review.cjs - [--dry-run]', '~/.claude/feature-review/preferences.md'. Specific examples cover the common cases, including edge handling like '-o path.html' for repos that don't gitignore tmp/. | 5 / 5 |
Workflow Clarity | Six clearly sequenced steps (Gather → Load preferences and rules → Read the change → Build → Open → Report) with real checkpoints: the build 'runs the self-check and guide validation', step 6 reports the self-check, first-use preferences are handled explicitly, and 'The server exits after a successful submit, which notifies you'. Not a 5 because the body never says what to do when the self-check or guide validation fails — no explicit fix-and-retry loop — and some checkpoints (CI, media capture failure) are only implied. Not a 3 because validation is explicit and the destructive-adjacent action (submitting) is gated: 'Never submit on the user's behalf from the terminal unless they ask.' | 4 / 5 |
Progressive Disclosure | The body is a true overview: each section summarizes its topic and defers full formats to a named, verified reference file ('Full format, guidance and examples: references/overview.md'; 'Format, the auto-review rules in full ... references/reading-guide.md'; 'recipes in references/gathering.md'), all 8 referenced files exist in the bundle, and the Files section lists every script and reference with a one-line description. References are one level deep — cross-links between overview.md and recommendations.md are peer links to files that contain their own content, not pointer chains. | 5 / 5 |
Total | 18 / 20 Passed |