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.
The body is a lean, well-structured instruction skill: concrete commands, explicit fallback logic, and clear output expectations with no token waste. The only real gap is minor — a few steps (PR number derivation, tmux attach criteria) rely on judgment rather than executable commands, and there are no explicit verification checkpoints.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~30-line body is lean and assumes competence: no background concepts are explained, and every line is instruction, command, or decision logic ('run `pnpm run docs:list` if present', 'trust the repo state and call out the mismatch'). This matches anchor 5 ('Lean and efficient; every token earns its place'); anchor 4 would require minor over-explanation to trim, which is absent. | 5 / 5 |
Actionability | Mostly executable, copy-paste-ready commands are given (`git status -sb`, `gh pr view <num> --comments --files`, `tmux capture-pane -p -J -t codex-shell:0.0 -S -200`), with specific handoff-note glob paths. Minor gaps keep it at anchor 4: `gh pr view <num>` needs a number and the fallback 'derive PR from branch' gives no command, and 'attach if needed' states no criterion. Not anchor 5 because guidance is not fully copy-paste ready across the common cases. | 4 / 5 |
Workflow Clarity | A clear numbered sequence (1-6) is preceded by a prioritized handoff-note step with explicit fallback paths ('If no handoff note exists, continue with the standard pickup steps'), and the Notes section adds an error-recovery rule for contradictions. This matches anchor 4 ('Clear sequence with most checkpoints present; minor validation gaps'); it is not 5 because there are no explicit validation/verification checkpoints after actions (e.g. what to do if the tmux attach fails or the PR number cannot be derived). No destructive or batch operations are involved, so the workflow cap of 3 does not apply. | 4 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent), and the skill is under 50 lines with well-organized sections (handoff-first, numbered steps, Output format, Notes) that need no external references. Per the rubric's simple-skill note, this earns anchor 5 ('well-organized sections' for a short skill with no need for external references). | 5 / 5 |
Total | 18 / 20 Passed |