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.
An impressively rigorous operational skill: exact commands, tool call syntax, and exhaustive error-recovery decision trees make it fully actionable with strong workflow clarity. The weaknesses are a dangling reference to a nonexistent rationale.md and heavy inline conditional detail that would benefit from progressive disclosure into a reference file.
Suggestions
The maintainer comment references "rationale.md (same directory)" but no such file exists in the bundle — either add that file or remove the pointer so the reference is not dangling.
Move the step-3 recovery branches (agent-pinned, unreachable worktree, denied entry) into a references/recovery.md and keep only the main path plus a clearly signaled one-level-deep pointer inline, reducing SKILL.md's inline load.
Trim justification clauses to the operative instruction where the why is not needed for the decision, e.g. reduce the CLAUDE.md/AGENTS.md loading explanation to just the instruction to read the new repo's root files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational with no padding about concepts Claude already knows, but contains minor instances of over-explanation that could be trimmed, e.g. "Claude Code keeps the launch repo's root instructions in context and loads only the new repo's nested ones, so the new repo's root files supersede the launch repo's for the rest of the session" where the operative instruction (read the new repo's root CLAUDE.md/AGENTS.md) would suffice, and the extended bare-name disambiguation prose. This matches the efficient-with-minor-trims anchor, not the lean every-token-earns-its-place anchor. | 4 / 5 |
Actionability | Fully executable guidance throughout: exact tool invocations ("EnterWorktree({name: \"<branch>\"})", "ExitWorktree({action: \"keep\"})"), a copy-paste-ready command ("wt -C <repo> switch --create <branch> --no-cd --format=json") with parsing instructions for its JSON output, concrete git stash commands, and four usage examples covering the common cases. Matches the fully-executable anchor. | 5 / 5 |
Workflow Clarity | A clear numbered sequence (pick branch, create-and-enter, wt-plus-enter-by-path) with explicit validation checkpoints and feedback loops: branch-exists error triggers a defined rerun, the step-3 failure mode names its error string, and EnterWorktree outcomes (Accepted / Tool error / Denied) each branch into concrete recovery steps with a testable check ("cd <path>" and look for "Shell cwd was reset"). Matches the explicit-validation-with-recovery anchor; no destructive/batch cap applies since worktree creation is non-destructive and removal is explicitly guarded ("Don't remove it unprompted"). | 5 / 5 |
Progressive Disclosure | Sections are well-organized for a single-file skill, but the only referenced path is a maintainer comment pointing to "rationale.md (same directory)", which does not exist in the bundle, and ~150 lines of inline conditional detail (argument disambiguation rules, mid-session stash carry, recovery branches for pinned/unreachable/denied entry) are content that could live in a separate reference. This sits between the some-structure and good-structure anchors: better organized than minimal, but the dangling reference and unsplit inline detail keep it below a 4. | 3 / 5 |
Total | 17 / 20 Passed |