Content
71%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 dense, professional orchestration skill: nearly every line states a concrete rule, command, or validation condition, with strong artifact-based checks, bounded feedback loops, and a well-organized script/reference structure. The main weaknesses are the many unresolvable link targets (workflows/, schemas/, cross-skill paths) and a few over-compressed multi-clause passages that bury distinct rules in single bullets.
Suggestions
Ship the workflows/ and schemas/ files that the Commands table and script notes link to (or repoint/remove those links) so every route in the Commands table resolves within the bundle.
Move the long prose rule clusters ('The overseer reads results', 'Item work stays in lanes') into the already-existing references files, keeping one-line rules inline in SKILL.md.
Add brief inline usage examples for the highest-traffic scripts (pr-order order rules, queue-wait verdicts) instead of deferring entirely to --help.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is hyper-telegraphic and assumes competence throughout — no concept explanations or filler; representative lines like 'A round closes on a validated on-disk artifact plus git/tracker state, never on a return message' carry a full rule in one sentence. It is not 5 because several bullets ('The overseer reads results', 'Item work stays in lanes') are giant multi-clause rule clusters and a version pin ('Requires kendex 1.20.0 or newer') could be trimmed or relocated; not 3 because almost every token carries a rule with no unnecessary explanation. | 4 / 5 |
Actionability | Concrete, executable guidance is dense: exact commands ('git -C [WT_PATH] rev-parse --verify HEAD'), exit-code contracts ('status=no_pr exits 0', 'exit 3 when none qualifies'), explicit flags ('workflow-state post-pr-stop record', '--check-live-round pushes nothing'), a full script inventory, and a stated invocation path. Not 5 because some behaviors defer to --help (e.g., 'pr-order --help' owns publication order) and the Commands table routes to workflow files not present in the bundle, leaving those routes unexecutable as written. | 4 / 5 |
Workflow Clarity | The Cycle states an explicit sequence (Get the issue → dev implements → publication, review and fixes → required CI and review gate → merge) with explicit validation checkpoints ('Acceptance is artifact-based', base-freshness gating, approval-wait/ci-wait/queue-wait) and feedback loops (bounded fix rounds, 'two consecutive rounds with no new blocker end the review', stall recovery via round-recover, re-read-after-rebase rules). Not 5 because the per-command step sequences live in referenced workflow files, several of which are absent from the bundle, so the end-to-end flow cannot be followed from this body alone. | 4 / 5 |
Progressive Disclosure | Links are clearly signaled and one level deep, and every referenced references/ and scripts/ file verified as present (skill-rules.md, gates.md, codex-runtime.md, waiter-launch.md, all script table entries). However, a large fraction of the body's link targets do not resolve in the provided bundle: the entire workflows/ tree that the Commands table routes to (workflows/start.md, review-pr.md, micro.md, ...), schemas/*.md (workflow-state.md, lane-host.md, ...), README.md, and cross-skill paths like ../reviewer/SKILL.md. This sits between anchors 3 and 4; the missing routing targets are more than 'minor organization gaps', so 3. | 3 / 5 |
Total | 15 / 20 Passed |