Content
81%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, actionable workflow with strong validation checkpoints, mutation confirmation gates, and a real, properly linked checklist asset. Its two weaker spots are token efficiency (duplicated trigger list between frontmatter and body) and disclosure structure (the dense low-token GitHub strategy could move to a reference file to slim the main body).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and imperative, assumes Claude's competence (never explains what worktrees or rate limits are), and every operational rule is project-specific knowledge Claude wouldn't have. Minor trimming opportunities remain — the 'When to use' trigger list restates the frontmatter description nearly verbatim, and a few sub-bullets in the low-token strategy could be consolidated — so it fits 'efficient; minor instances of over-explanation' rather than 'every token earns its place'. | 4 / 5 |
Actionability | Concrete, executable guidance throughout: exact draft file naming ('.tmp/pr-body-issue-123-scope-summary.md', not a shared '.tmp/pr-body.md'), a specific template source ('.github/pull_request_template.md'), and quantified API budgets (~20 MCP read calls, ~5 mutations, 5 secondary-limit points per mutation). Validation steps delegate to repo-specific commands by design but remain slightly abstract ('Run targeted checks first, then required project checks'), keeping it below fully copy-paste-ready. | 4 / 5 |
Workflow Clarity | A clear 10-step numbered sequence with an explicit validation checkpoint and feedback loop ('If checks fail, fix relevant issues and re-run before proceeding'), confirmation gates before every mutation ('Before any GitHub mutation... ask for explicit user confirmation'), and a checklist asset for the complex process. This matches the top anchor: explicit validation steps, error-recovery loops, and a checklist. | 5 / 5 |
Progressive Disclosure | The one bundle file (assets/issue-solving-checklist.md) exists, is one level deep, and is clearly signaled from a dedicated Assets section. Structure is good, but the ~120-line body keeps substantial operational detail inline — notably the eight-bullet low-token/rate-limit strategy — that would fit a reference file, matching 'good structure; most content appropriately placed; minor organization gaps' rather than the cleanest split. | 4 / 5 |
Total | 17 / 20 Passed |