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 unusually rigorous operational skill: complete phase workflow with validation checkpoints, safety constraints covering genuine Git worktree pitfalls, and a clean one-level-deep command reference. The minor deductions come from triple-stating the repair rule and leaving a few operations at the level of conditions rather than executable commands.
Suggestions
State the repair rule once (e.g. in the opening section) and reference it from 'Choose the manager and location' and the safety constraints instead of restating it, saving tokens without losing the safety net.
Move a few condition-only operations (e.g. branch deletion verification) into the existing cleanup reference as concrete command snippets like the merge-base check, so every destructive action has a copy-paste verification step.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious, edge-case guidance that assumes Git competence (per-worktree refs, gc.worktreePruneExpire, extensions.worktreeConfig migration) with no padding, but the repair rule is restated three times (opening paragraph, 'Choose the manager and location', safety constraints) and a few sentences over-compress into cryptic phrasing. This fits the 4 anchor ('efficient; minor instances that could be trimmed') better than 5's every-token-earns-its-place. | 4 / 5 |
Actionability | Concrete commands appear in the body (git worktree list --porcelain -z, git check-ignore -q, git worktree lock --reason, git worktree add -b) with clearly defined placeholders, and the complete command set is copy-paste ready in the one-level-deep reference. It is not 5 because some guidance remains workflow-abstract ('Use the repository's merge, rebase, squash, or PR workflow') and a few operations are described only as conditions rather than commands. | 4 / 5 |
Workflow Clarity | The skill is sequenced in clear phases (choose checkout, choose manager/location, establish starting state, develop and integrate, cleanup decision tree, completion report) with explicit validation checkpoints at every risky step: verify returned path and commit, require check-ignore exit 0, review every prune dry-run entry, verify integration via ancestry, and a final 'Verify the result' re-listing step. This matches the 5 anchor including feedback loops for destructive and batch operations. | 5 / 5 |
Progressive Disclosure | The SKILL.md is a well-organized overview and the single reference (references/raw-git-commands.md) is one level deep, real, clearly signaled, and linked at the point of need with anchored sections (#creation, #cleanup, #registration). This matches the 5 anchor: clear overview with well-signaled one-level-deep references and appropriate content split. | 5 / 5 |
Total | 18 / 20 Passed |