Content
85%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.
A well-structured, actionable instruction skill with a clear sequenced workflow, explicit idempotency validation, a hard-nevers checklist, and clean one-level-deep progressive disclosure. The only gaps are minor verbosity in the rationale section and command detail living in references rather than inline.
Suggestions
Tighten the 'one-way model (read this first)' section to its load-bearing consequences, trimming the philosophical framing.
Consider inlining the one or two most-used gh commands (e.g., listing unresolved reviewer findings) so the core pass is executable without opening the reference.
Dedupe the never-silence / skip / no-refactor rules between the body sections and 'Hard nevers' so the checklist stays the single source.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and assumes Claude's competence — no generic explanation of PRs or code review — with deliberate checklist reinforcement in 'Hard nevers'; not a 5 because the 'one-way model' rationale section and repeated rule statements could be trimmed further. | 4 / 5 |
Actionability | Gives concrete per-bucket actions and enumerates specific forbidden patterns (eslint-disable*, @ts-ignore, .skip, xfail, etc.); not a 5 because the exact executable gh/GraphQL commands are deferred to the reference file rather than present inline. | 4 / 5 |
Workflow Clarity | Clear numbered sequence (re-derive → triage → act → exit) with explicit validation checkpoints (reply-idempotency, fix-idempotency), a feedback loop (re-derive failures from the worktree → no diff → no commit), and a 'Hard nevers' checklist for the destructive push/reply operations. | 5 / 5 |
Progressive Disclosure | Overview body offloads fiddly detail to two clearly signaled, one-level-deep, verified files — `references/gh-mechanics.md` for commands and `references/triage.md` for the taxonomy — with no nested references and easy navigation. | 5 / 5 |
Total | 18 / 20 Passed |