Content
88%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.
A well-structured, actionable body that assumes Claude's competence and gives executable guidance with clear workflows and validation. Its main weakness is that the in-skill references point to a reference/ bundle that is not actually present.
Suggestions
Ship the referenced reference/*.md bundle files (config.md, hook.md, switch.md, extending.md, llm-commits.md, tips-patterns.md, shell-integration.md, troubleshooting.md, step.md) so the in-skill navigation links resolve to real content.
Trim a few explanatory parenthetical asides (e.g. 'which marker still rejects, since it keys state by branch name') to tighten conciseness without losing the wt-specific guidance.
Verify each reference/ path cited in the 'Common tasks reference' section exists with the named anchor (e.g. extending.md#aliases, step.md#wt-step-for-each) so deep links are not broken.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense, competence-assuming prose with no tutorial padding about git/worktrees; mostly efficient, though a few explanatory asides (e.g. the marker branch-keying note) could be trimmed. | 4 / 5 |
Actionability | Provides concrete, copy-paste-ready commands and examples across the common cases — wt config/switch/step commands, TOML hook pipelines, and tmux/Zellij/parallel-sub-agent spawn patterns. | 5 / 5 |
Workflow Clarity | Multi-step workflows are explicitly sequenced with validation checkpoints (detect-tools→propose→approve→dry-run verify; derive-commands→verify-they-run→test-hooks), and the hook-approval escalation gives a clear feedback loop for a destructive/security-sensitive operation. | 5 / 5 |
Progressive Disclosure | References to reference/*.md files are well-signaled, one level deep, and organized via a documentation listing and a task-to-reference map, but the referenced reference/ bundle directory is absent on disk, so the navigation points to missing files. | 4 / 5 |
Total | 18 / 20 Passed |