Content
92%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 instruction-style skill body: a clearly sequenced phase workflow with explicit validation and self-audit checkpoints, fully executable gh/git commands, and clean progressive disclosure into 12 real one-level-deep reference files. The only trimmable fat is a small amount of universally known material (Conventional Commits cheat sheet, --force-with-lease mechanics, the structural rationale intro).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely non-obvious, operational guidance (PR-size baseline via gh pr list --jq, scope contracts, fixup/autosquash, bot-reply via gh api in_reply_to, force-with-lease) with little padding, so it sits above the anchor-3 'could be tightened'. But a few sections re-explain what Claude already knows — the Conventional Commits cheat sheet (feat/fix/docs/chore...), the mechanics of --force-with-lease, and the multi-sentence intro justifying the phase structure — matching anchor 4 ('efficient; minor instances of over-explanation that could be trimmed'), not anchor 5. | 4 / 5 |
Actionability | Nearly every phase carries copy-paste-ready commands — 'gh pr list --repo <owner>/<repo> --state merged --limit 10 --json ... --jq ...', 'git switch -c feat/short-descriptive-name origin/main', 'git -c sequence.editor=: rebase -i --autosquash origin/main', 'gh api .../pulls/<pr>/comments -X POST -F in_reply_to=...' — plus a complete PR-body skeleton, disclosure template, and a concrete test-coverage-matrix example. This matches anchor 5 ('fully executable; copy-paste ready; specific examples cover the common cases') rather than anchor 4, where commands would be sketchier or key cases missing. | 5 / 5 |
Workflow Clarity | The five-phase sequence (discovery → implementation → quality gates → description → post-submission) is clearly numbered with explicit validation checkpoints and feedback loops: 'If any check fails, fix it before continuing', the Step 3.3 self-audit ('What's my evidence?'), the Step 3.4 push-time checklist with mergeability verification, and rebase-conflict recovery with 'git -c sequence.editor=: rebase --continue'. This is a clear anchor-5 match; anchor 4 would require missing checkpoints or weaker error-recovery guidance. | 5 / 5 |
Progressive Disclosure | The SKILL.md body is a well-signaled overview that pushes detail to 12 one-level-deep reference files — all of which exist on disk — linked both at point of use ('See references/phase1_discovery.md for the baseline rubric') and in a Reference Files table with per-file 'Use for' descriptions. It matches anchor 5 ('clear overview with well-signaled one-level-deep references; content appropriately split'); anchor 4 would apply if references were buried or bulk detail were inlined — the inlined material (commands, skeletons) is what the executor needs at decision time, not displaced reference content. | 5 / 5 |
Total | 19 / 20 Passed |