Content
96%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 exemplary workflow body: concrete executable commands, a strictly ordered four-step pipeline with validation checkpoints and error-recovery paths, and dense project-specific knowledge with no filler. Its only structural weakness is that substantial checklist detail lives inline in SKILL.md rather than split into reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Nearly every sentence carries non-inferable project facts ('The refspec is explicit because a bare clone maps no remote-tracking refs'; 'Session-metrics cards join transcripts by branch name alone'), with no explanation of concepts Claude already knows. The prose is compressed and information-dense, matching the lean top anchor rather than the 4 anchor's 'minor instances of over-explanation'. | 5 / 5 |
Actionability | Copy-paste-ready commands with placeholders for every path: 'gh issue view 412 --repo …', 'git worktree add /Users/ac/.work/osn.git/<dir> -b <branch> origin/main', the name-taken check (cat-file -e plus gh api 'pulls?state=all&head=…'), and 'bun install --frozen-lockfile'. It covers the common cases — PERSONAL vs REMOTE, existing issue vs new, no network, no gh — with concrete fallback behavior for each. | 5 / 5 |
Workflow Clarity | Four explicitly ordered steps ('each depends on the one before'), a preflight gate probe ('Find out once, before Step 0'), validation before risky operations (check the branch name is free before cutting; 'Cut once'; idempotent '-B makes a re-run idempotent… switch without resetting'), and a feedback loop in Step 3 (every stress-plan finding fixed, rejected in writing, or escalated before implementation starts). Honesty checkpoints like 'Never describe an issue as opened… when the command could not run' round out the top anchor. | 5 / 5 |
Progressive Disclosure | The one bundle reference ('The routing table is references/skills-routing.md') is real, clearly signaled, and one level deep, and the skill delegates heavily to other skills and wiki pages rather than inlining them. However, the ~145-line body carries dense inline checklists (Step 2's plan requirements, the complexity-rating rules) that could partly live in reference files, which fits anchor 4 ('minor organization gaps') rather than 5. | 4 / 5 |
Total | 19 / 20 Passed |