Creates or removes a git worktree using the project scripts and shared config. Use when the user asks to create a worktree, add a worktree, remove a worktree, delete a worktree, or work on a parallel branch in a separate directory.
95
93%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description that clearly communicates what the skill does and when to use it. It provides specific actions (create/remove worktrees), mentions the mechanism (project scripts and shared config), and includes a comprehensive 'Use when...' clause with multiple natural trigger terms. The description is concise, uses third person voice, and occupies a clear niche that minimizes conflict risk.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists specific concrete actions: 'Creates or removes a git worktree using the project scripts and shared config.' This clearly names the domain (git worktrees) and the specific operations (create, remove) along with the mechanism (project scripts and shared config). | 3 / 3 |
Completeness | Clearly answers both 'what' (creates or removes a git worktree using project scripts and shared config) and 'when' (explicit 'Use when...' clause with multiple trigger scenarios including create, add, remove, delete, and parallel branch work). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms: 'create a worktree', 'add a worktree', 'remove a worktree', 'delete a worktree', 'parallel branch', 'separate directory'. These are terms users would naturally use when requesting this functionality. | 3 / 3 |
Distinctiveness Conflict Risk | Very distinct niche — git worktrees are a specific git feature, and the description ties it to project-specific scripts and shared config. Unlikely to conflict with general git skills or other file management skills due to the specificity of 'worktree' terminology. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted, concise skill that provides clear, actionable commands for both creating and removing worktrees. It correctly assumes Claude's intelligence and focuses on project-specific conventions. The main weakness is the lack of explicit validation/error-handling steps after worktree creation or removal.
Suggestions
Add a brief validation step after worktree creation (e.g., verify the directory exists or check `git worktree list`) and after the post-setup commands to confirm success.
Add brief guidance on what to do if the script fails (e.g., check if the branch already exists, or if the path is already in use).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every sentence carries actionable weight. No unnecessary explanations of what worktrees are or how git works. The content assumes Claude's competence and only provides project-specific commands and constraints. | 3 / 3 |
Actionability | Provides specific, copy-paste-ready commands for all scenarios (with args, without args, with --from flag, with --cd flag). Clearly states what NOT to do (no raw git worktree add) and what to do after success. | 3 / 3 |
Workflow Clarity | The create workflow has a clear sequence (run command → remind about setup steps), but the post-creation setup steps (yarn setup, git submodule update) lack validation checkpoints. There's no guidance on what to do if the script fails or how to verify success. | 2 / 3 |
Progressive Disclosure | Clean overview with create/remove sections, and a single well-signaled reference to the full worktree docs. Content is appropriately sized for inline presentation with deeper details linked out. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
bee9b14
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.