Agent-Skills.md

Agent Skills: Git Worktree

Create isolated git worktrees in ~/.claude-worktrees/. Use when user says "create an isolated copy", "worktree", "create worktree", "isolated workspace", or needs to work on a branch without affecting the main working directory.

UncategorizedID: kvnxiao/.dotfiles/git-worktree

Repository

kvnxiao/.dotfiles
kvnxiaoLicense: MIT

Install this agent skill to your local

pnpm dlx add-skill https://github.com/kvnxiao/.dotfiles/tree/HEAD/agent-configs/shared/skills/git-worktree

Skill Files

Browse the full folder contents for git-worktree.

Download Skill

Loading file tree…

agent-configs/shared/skills/git-worktree/SKILL.md

Skill Metadata

Name
git-worktree
Description
Create isolated git worktrees in ~/.claude-worktrees/. Use when user says "create an isolated copy", "worktree", "create worktree", "isolated workspace", or needs to work on a branch without affecting the main working directory.

Git Worktree

Create isolated git worktrees in ~/.claude-worktrees/<repo>/<branch>/.

Supports .worktreeinclude file for copying untracked files (e.g., .env.local) to new worktrees.

Usage

Create Worktree

BRANCH_NAME="feature/my-feature" ./scripts/create-worktree.sh
# Or with ticket URL for branch naming:
BRANCH_NAME="eng-123/fix-bug" TICKET_URL="https://linear.app/team/issue/ENG-123/fix-bug" ./scripts/create-worktree.sh
# Or with custom base branch:
BRANCH_NAME="feature/my-feature" BASE_BRANCH="develop" ./scripts/create-worktree.sh

Outputs (to stdout):

  • BRANCH_NAME=<branch> - The created branch name
  • WORKTREE_PATH=<path> - Absolute path to worktree
  • DEFAULT_BRANCH=<branch> - Repository's default branch

Remove Worktree

WORKTREE_PATH="$HOME/.claude-worktrees/my-repo/my-branch" ./scripts/remove-worktree.sh

.worktreeinclude

Create a .worktreeinclude file in your repo root to specify files that should be copied to new worktrees:

# Environment files
.env.local
.env.development

# Local config
config/local.json

Supports glob patterns via bash globbing (**/*.local).

Scripts

  • create-worktree.sh - Create worktree, copy includes
  • copy-worktree-includes.sh - Copy files from .worktreeinclude
  • remove-worktree.sh - Remove worktree and clean up