How do I install the Worktree skill?

Run npx skillmds@latest add abhattacherjee/worktree in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Worktree safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Worktree?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Worktree free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Worktree?

abhattacherjee (@abhattacherjee) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Worktree by abhattacherjee — Agent Skill

Name: Worktree
Rating: 4.5 (4 reviews)
Author: abhattacherjee

Worktree

Creates isolated git worktrees for parallel Claude Code sessions, each on its own branch. Use when: (1) /worktree command, (2) user wants to work on multiple branches simultaneously, (3) user has multiple Claude Code sessions conflicting on the same branch, (4) user asks to set up parallel development.

File contents

Git Worktree for Parallel Sessions

Problem

Multiple Claude Code sessions sharing one working directory fight over the same branch. Git worktrees give each session its own directory and branch while sharing the same repo.

Quick Reference

# From the repo root:
~/.claude/skills/worktree/scripts/setup-worktree.sh list                                  # Show worktrees + branches
~/.claude/skills/worktree/scripts/setup-worktree.sh create feature/story-10.11             # Existing branch
~/.claude/skills/worktree/scripts/setup-worktree.sh create --new story-10.12-new-feature   # New branch from develop
~/.claude/skills/worktree/scripts/setup-worktree.sh remove feature/story-10.11             # Clean up
~/.claude/skills/worktree/scripts/setup-worktree.sh --help                                 # Full usage

Workflow

When invoked, follow these steps:

Step 1: Show current state

Run the list command to show existing worktrees and available branches.

Step 2: Ask the user what they want

Use AskUserQuestion with options based on what list returned:

Create worktree for an existing feature branch
Create a new feature branch + worktree
Remove an existing worktree

Step 3: Execute

Run the appropriate script command. The script handles:

Creating the worktree directory as a sibling (e.g., ../repo-name--branch-suffix/)
Fetching from remote if needed
Running npm install in backend/frontend/mcp-events-server if node_modules is missing

Step 4: Tell the user what to do next

The script outputs the exact cd + claude command. Relay this clearly.

Naming Convention

Worktree directories are created as siblings of the repo root:

parent-dir/
  repo-name/                          # Main working directory
  repo-name--story-10.11-view/        # Worktree for feature/story-10.11-view
  repo-name--story-10.12-new/         # Worktree for feature/story-10.12-new

Notes

Each worktree has its own node_modules — the script installs them automatically
A branch checked out in one worktree CANNOT be checked out in another (git enforces this)
Worktrees share the same .git history — commits are visible across all worktrees
Use git worktree remove (or the script's remove command) to clean up when done

---name: worktreedescription: Creates isolated git worktrees for parallel Claude Code sessions, each on its own branch. Use when: (1) /worktree command, (2) user wants to work on multiple branches simultaneously, (3) user has multiple Claude Code sessions conflicting on the same branch, (4) user asks to set up parallel development.---# Git Worktree for Parallel Sessions## ProblemMultiple Claude Code sessions sharing one working directory fight over the same branch. Git worktrees give each session its own directory and branch while sharing the same repo.## Quick Reference```bash# From the repo root:~/.claude/skills/worktree/scripts/setup-worktree.sh list # Show worktrees + branches~/.claude/skills/worktree/scripts/setup-worktree.sh create feature/story-10.11 # Existing branch~/.claude/skills/worktree/scripts/setup-worktree.sh create --new story-10.12-new-feature # New branch from develop~/.claude/skills/worktree/scripts/setup-worktree.sh remove feature/story-10.11 # Clean up~/.claude/skills/worktree/scripts/setup-worktree.sh --help # Full usage```## WorkflowWhen invoked, follow these steps:### Step 1: Show current stateRun the `list` command to show existing worktrees and available branches.### Step 2: Ask the user what they wantUse AskUserQuestion with options based on what `list` returned:- Create worktree for an existing feature branch- Create a new feature branch + worktree- Remove an existing worktree### Step 3: ExecuteRun the appropriate script command. The script handles:- Creating the worktree directory as a sibling (e.g., `../repo-name--branch-suffix/`)- Fetching from remote if needed- Running `npm install` in backend/frontend/mcp-events-server if node_modules is missing### Step 4: Tell the user what to do nextThe script outputs the exact `cd` + `claude` command. Relay this clearly.## Naming ConventionWorktree directories are created as siblings of the repo root:```parent-dir/ repo-name/ # Main working directory repo-name--story-10.11-view/ # Worktree for feature/story-10.11-view repo-name--story-10.12-new/ # Worktree for feature/story-10.12-new```## Notes- Each worktree has its own `node_modules` — the script installs them automatically- A branch checked out in one worktree CANNOT be checked out in another (git enforces this)- Worktrees share the same `.git` history — commits are visible across all worktrees- Use `git worktree remove` (or the script's `remove` command) to clean up when done## See Also- **GitHub**: https://github.com/abhattacherjee/worktree — install instructions, changelog, license

Frequently asked questions