Content
100%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-only skill body: dense, executable, and repository-specific where it matters, with a validated workflow (skip conditions, expected outputs, conflict recovery, baseline verification) and disciplined 'Never' constraints. It delegates mechanics to the git-worktree sub-skill instead of duplicating them, keeping the single file appropriately scoped.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes git competence, spending tokens only on non-obvious operational facts ('Stash-then-pop is the only safe cross-worktree move', 'The stash list is shared by every worktree of the repo, so it may not be stash@{0}', "`wt switch` has no base option"). Nothing explains concepts Claude already knows, so it fits the 'every token earns its place' anchor rather than the minor-trimmings anchor at 4. | 5 / 5 |
Actionability | Fully executable throughout: concrete commands (`git stash push -u -m "wip: <plan-slug>"`, `wt switch <branch>`, `git stash pop stash@{n}`, `just check` / `wt verify <branch>`) and a copy-paste-ready Phase 0 template with placeholder substitution and expected outputs. It covers the common cases (dirty tree, clean tree, untracked plan file, existing branch), matching the top anchor rather than the minor-gaps anchor at 4. | 5 / 5 |
Workflow Clarity | The sequence (read plan → assess WIP state → insert Phase 0 → report) is explicit with an idempotency check, conditional branches, expected outputs, and a verify-baseline step; the risky stash-pop even has error recovery ('Only if the pop stops on a conflict: resolve it, then run `git stash drop stash@{n}`'). This matches the validation-with-feedback-loops anchor rather than the minor-gaps anchor at 4. | 5 / 5 |
Progressive Disclosure | This is a single-file skill (no references/, scripts/, or assets/ exist) whose ~90 lines are all one coherent procedure, so nothing belongs in a separate file. Mechanics are cleanly delegated to the git-worktree skill with a clearly signaled 'REQUIRED SUB-SKILL' marker, and sections are well organized with no nested references — matching the well-organized single-purpose structure rather than the minor-organization-gaps anchor at 4. | 5 / 5 |
Total | 20 / 20 Passed |