home-modules/shared/skills/git-worktree/SKILL.md
Do work in an isolated git worktree instead of switching branches. Use when creating a branch and opening a PR so the user's working directory is never disturbed. Triggers: 'create a branch', 'open a PR', 'make a change on a new branch'.
npx skillsauth add mccurdyc/nixos-config git-worktreeInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Use git worktrees to isolate branch work from the user's current checkout. This avoids disrupting uncommitted changes or the user's active branch.
gw <name> [base] — create worktree at .git-worktrees/<name> branching
from base (default: origin/main). Copies .envrc and shares direnv cache.gwl — list active worktrees.gwd <name> — cd into an existing worktree.gw-clean — remove merged worktrees.Create the worktree from origin/main (unless told otherwise):
git fetch origin main
gw <branch-name>
This creates .git-worktrees/<branch-name> with a new branch of the same name.
Change into the worktree directory:
cd .git-worktrees/<branch-name>
Do all work inside the worktree — edits, commits, pushes, PR creation all happen in this directory. The user's main checkout is untouched.
After the PR is opened, return to the original directory:
cd -
The worktree stays on disk for future updates. Tell the user they can
clean it up later with gw-clean or manually remove it.
development
Search the web, fetch web page content, or search GitHub issues/PRs/repos. Use when you need current information not available locally.
tools
Start an interactive questionnaire when there are more than 5 options or bullet points that need to be addressed. Uses the ask_user tool to walk through selections interactively instead of dumping a wall of text.
tools
Browse the web headlessly using Chrome DevTools Protocol. Use when you need to interact with web pages - click buttons, fill forms, navigate, take screenshots, or extract dynamic content that requires JavaScript.
tools
Show git diff output inline in the conversation without opening a browser. Covers staged, unstaged, and untracked files.