git-worktrees
Git worktrees for isolated parallel development on multiple branches simultaneously.
Installation
Details
Usage
After installing, this skill will be available to your AI coding assistant.
Verify installation:
skills listSkill Instructions
name: git-worktrees description: Git worktrees for isolated parallel development on multiple branches simultaneously.
Git Worktrees
Source: travisvn/awesome-claude-skills
Overview
Git worktrees allow working on multiple branches simultaneously without switching.
Basic Commands
# Create worktree for existing branch
git worktree add ../feature-x feature-x
# Create worktree with new branch
git worktree add -b feature-y ../feature-y
# List worktrees
git worktree list
# Remove worktree
git worktree remove ../feature-x
# Prune stale worktrees
git worktree prune
Directory Structure
project/ # Main worktree (main branch)
project-feature-x/ # Worktree for feature-x branch
project-hotfix/ # Worktree for hotfix branch
Use Cases
1. Parallel Feature Development
# Work on feature while keeping main clean
git worktree add ../project-feature features/new-feature
cd ../project-feature
# Work here without affecting main
2. Quick Hotfix
# Urgent fix without stashing current work
git worktree add ../project-hotfix hotfix/critical-bug
cd ../project-hotfix
# Fix, commit, push
3. Code Review
# Check PR without affecting your work
git worktree add ../project-review pr-branch
cd ../project-review
# Review, test, then remove
Best Practices
- Naming convention:
../project-feature-name(keep outside main repo) - Shared Build Cache: Use shared caches (e.g., Turborepo/Nx) outside worktrees to prevent redundant builds.
- Dependency Management: Use pnpm/Yarn Berry with content-addressable storage to save disk space.
- Cleanup: Always
git worktree removeto prevent stale references.
Workflow Example
# You're on main, need to check a bug
git worktree add -b investigate ../project-investigate
# Go there
cd ../project-investigate
# Investigate, fix if small
# ...
# Done, clean up
cd ../project
git worktree remove ../project-investigate
AI-Automated Workflow (2025)
Agents can use worktrees to safely test multiple implementations:
git worktree add ../temp-poc poc-branch- Run automated tests in
temp-poc. - If tests pass, merge and
git worktree remove ../temp-poc.
Gotchas
- Can't check out same branch in two worktrees
- Each worktree has its own working directory
- node_modules not shared (run npm install in each)
More by xenitV1
View allAPI design principles and decision-making. REST vs GraphQL vs tRPC selection, response formats, versioning, pagination. Teaches thinking, not fixed patterns.
Defines different operational modes for AI behavior. Each mode optimizes for specific scenarios like brainstorming, implementation, or debugging.
Database design principles and decision-making. Schema design, indexing strategy, ORM selection, serverless databases. Teaches thinking, not fixed SQL.
Mobile-first design thinking and decision-making for iOS and Android apps. Touch interaction, performance patterns, platform conventions. Teaches principles, not fixed values. Use when building React Native, Flutter, or native mobile apps.