Content
88%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 exceptionally actionable, well-sequenced workflow skill: concrete commands at every step, upfront gate probes, and a genuine pre-implementation validation gate with feedback loops. Its only costs are length-adjacent — a few trimmable asides and a Step 2 checklist that pushes against what belongs inline versus in a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence — it never explains known concepts, and every aside carries non-inferable repo-specific rationale (e.g. why the refspec is explicit for a bare clone). A few long parentheticals and philosophical asides ("that is a real value and usually the honest one") could be trimmed, landing it just below the lean anchor. | 4 / 5 |
Actionability | Guidance is copy-paste ready throughout: the exact probe snippet (`command -v gh ...`, `echo PERSONAL || echo REMOTE`), `gh issue view` with `--json` fields, `git worktree add ... -b <branch> refs/remotes/origin/main`, the exact `NEW-FEAT.md` opening format, and the designated `-B` idempotent checkout — parameters are real placeholders, not pseudocode. | 5 / 5 |
Workflow Clarity | The sequence is explicit ("Four things, in this order — each depends on the one before"), gates are probed once before Step 0, the branch name is checked for collisions before cutting, and Step 3 is a full validation feedback loop (fix, reject-with-named-fact, or escalate before any code) — checkpoints and error-recovery paths are explicit, including the "When a gate cannot run" fallbacks. | 5 / 5 |
Progressive Disclosure | Structure is good: the one bundle reference (`references/skills-routing.md`) is clearly signaled in Step 4, verified to exist, and one level deep, and wiki/skill pointers are consistently cited. The very long Step 2 plan checklist and the dense stacked-PR paragraph are borderline content that could partly live in reference files, keeping it below the cleanly-split anchor. | 4 / 5 |
Total | 18 / 20 Passed |