Content
85%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 an exemplary lean, executable routing skill with clear sequencing and a strong result/blocked contract. Its main weakness is progressive disclosure: the three referenced environment documents do not exist in the bundle, so the navigation it depends on cannot be validated.
Suggestions
Ship the referenced claude-code.md, harness-native.md, and git-only.md alongside SKILL.md so the one-level-deep routing it relies on is actually resolvable.
Add a brief validate-then-retry checkpoint (or note that validation lives in each environment doc) for the destructive checkout step, since Step 2 delegates creation to files that may not yet exist.
Mention the scripts/copy_worktreeinclude.py helper in the body or in the relevant environment doc, since it is part of the bundle but never referenced from SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean, dense, and assumes Claude's competence: it gives git rev-parse commands without explaining what a worktree is, with no padding or restatement of known concepts; every section earns its tokens. | 5 / 5 |
Actionability | Provides copy-paste-ready, executable bash commands (git rev-parse --absolute-git-dir, --show-superproject-working-tree, --show-toplevel, etc.) covering the detection and reuse cases, plus a concrete result-contract template. | 5 / 5 |
Workflow Clarity | A clear numbered Step 0→1→2 sequence with explicit decision branches and a blocked-state contract; however creation/destructive operations are routed to separate docs and the in-file steps include only detection validation, not a validate-then-retry loop for the actual destructive checkout. | 4 / 5 |
Progressive Disclosure | It routes to three one-level-deep references (claude-code.md, harness-native.md, git-only.md), but those referenced files are not present in the bundle, so the disclosure structure cannot be verified and the body inlines routing logic that depends on missing files. | 3 / 5 |
Total | 17 / 20 Passed |