---
name: git-worktrees
description: Creates git worktrees for parallel development. Use when creating a git worktree, setting up multiple working directories, or working on features in parallel.
title: git-worktrees
canonical_url: https://skilld.dev/gh/lexler/skill-factory/git-worktrees
last_updated: 2026-09-28T13:33:12.000Z
---

> **Skill from skilld.dev.** Follow the instructions below for this session. You do not need to install anything.
>
> If the user asked to install this Skill, run `npx skilld install lexler/skill-factory/git-worktrees`. Install writes the Skill files into the project, so every session loads them.

# Git Worktrees

## Directory Convention

Worktrees live in a sibling directory named `<project>_worktrees`:

```
parent/
├── myproject/              # main repo
└── myproject_worktrees/    # worktrees directory
    ├── feature_1/
    └── feature_2/
```

## Branch Naming

Use `<feature>_<N>` pattern when creating multiple worktrees:
- `auth-refactor_1`, `auth-refactor_2`
- `api-migration_1`, `api-migration_2`

## Workflow

1. Get project name from current directory
2. Create worktrees directory if needed: `../<project>_worktrees/`
3. Create worktree with new branch: `git worktree add <path> -b <branch>`

## Creating Multiple Worktrees

When asked for N worktrees for a feature:

```bash
PROJECT=$(basename "$PWD")
WORKTREES_DIR="../${PROJECT}_worktrees"
mkdir -p "$WORKTREES_DIR"

for i in $(seq 1 N); do
    git worktree add "${WORKTREES_DIR}/<feature>_${i}" -b "<feature>_${i}"
done
```

## Cleanup

Remove worktree and branch:
```bash
git worktree remove <path>
git branch -d <branch>
```

List all worktrees: `git worktree list`