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 exceptionally well-crafted instruction skill: correct phase sequencing, pervasive validation checkpoints and feedback loops around destructive operations, precise inline commands, and a clean one-level reference split. The only weakness is minor over-explanation in the glossary and a few dense, hedged sentences.
Suggestions
Trim the glossary to only the convention-fixing notes (e.g., "Here, the noun checkout means this workspace" and "<primary-root> is the main worktree's directory regardless of branch name") and drop definitions of Git concepts Claude already knows, such as what a worktree, HEAD, or the staging area is.
Tighten the most lawyerly sentences (e.g., the opening "Apply only task-relevant phases and their safety checks; listing or repair alone does not require development, integration, or cleanup" and the long worktreeConfig safety bullet) — each currently restates constraints already enforced elsewhere, so they can be shortened without losing content.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and nearly every sentence carries operational constraints (e.g., "require exit 0", "Do not place a worktree inside another disposable worktree"), but the glossary explains concepts Claude already knows ("A directory of checked-out files with its own HEAD and index", "The main worktree is the original checkout; all others are linked"), and a few lawyerly sentences ("Apply only task-relevant phases and their safety checks...") could be tightened. This fits anchor 4 ('Efficient; minor instances of over-explanation that could be trimmed') — not 5, because those glossary definitions and redundant safety restatements don't earn their place, and not 3, since the padding is minor against overwhelmingly high-value content. | 4 / 5 |
Actionability | Guidance is concrete and executable throughout: exact commands with flags ("git worktree list --porcelain -z", "git rev-parse --path-format=absolute --git-path info/exclude", "git check-ignore -q ... with a trailing /"), exit-code requirements ("require exit 0"), concrete path conventions ("<primary-root>/.worktrees/<task>"), and the -b vs -B distinction, with full copy-paste-ready command sequences in the linked reference covering creation and cleanup. Common cases are covered specifically, matching anchor 5 ('Fully executable; copy-paste ready code or commands; specific examples cover the common cases'); it exceeds anchor 4, whose 'minor gaps' are absent here. | 5 / 5 |
Workflow Clarity | The phases are clearly sequenced (Choose the checkout → Choose the manager and location → Establish the starting state → Develop and integrate → Cleanup decision tree → Completion report → Safety constraints), each with explicit validation checkpoints: "Wait for creation to finish and verify the returned path and commit", "Re-list worktrees to verify the new registration", "Verify again after creation", and the numbered cleanup tree ending in "Verify the result. Re-list worktrees and check the removed path." Destructive operations have explicit feedback loops (dry-run before prune, repair-before-prune, re-validation after fixes), matching anchor 5 ('Clear sequence with explicit validation steps; feedback loops for error recovery'). | 5 / 5 |
Progressive Disclosure | The body is a well-organized overview/policy document that delegates full command sequences to one reference file exactly one level deep, clearly signaled at the point of need: "Before creating a worktree with raw Git, read [Creation commands](references/raw-git-commands.md#creation)" and "Before raw Git worktree removal... read [Cleanup commands](references/raw-git-commands.md#cleanup)". The referenced file exists and is well sectioned (Creation/Cleanup) matching the anchors. This matches anchor 5 ('Clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation') with no nesting or buried references. | 5 / 5 |
Total | 19 / 20 Passed |