using-git-worktrees

Create isolated git worktrees for feature development with safety checks.

3|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/martin-janci/claude-marketplace --skill using-git-worktrees-martin-janci
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/martin-janci/claude-marketplace/tree/main/plugins/dev-agents/skills/using-git-worktrees
Command: npx skills add https://github.com/martin-janci/claude-marketplace --skill using-git-worktrees-martin-janci

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Isolate feature work from the current workspace by creating deterministic git worktrees, allowing concurrent development without impacting the main branch.

Core Features & Use Cases

  • Create project-local or global worktrees that share the repository while tracking separate branches, enabling parallel feature development without frequent branch switches.
  • Respect CLAUDE.md preferences for worktree location when present; prompt only when the location is ambiguous.
  • Enforce safety checks before worktree creation, such as .gitignore verification and baseline setup, to prevent accidental inclusion of worktree data.

Quick Start

Create an isolated git worktree for your current feature branch with automatic project-name based path selection.

Frequently Asked Questions about using-git-worktrees

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I isolate feature development work from my main git workspace?

Git worktrees isolate feature development by creating separate working directories that share the repository while tracking distinct branches. This enables parallel development without frequent branch switches impacting the main workspace.

What's the best way to manage multiple feature branches without constantly switching contexts?

Git worktrees allow concurrent development across multiple branches by maintaining isolated working directories. Each worktree tracks a separate branch while sharing the underlying repository history, preventing disruptive context switches.

How does a git worktree handle existing local directories and project preferences?

Worktree creation applies priority rules to detect existing local directories and reads CLAUDE.md preferences for location guidance. It prompts for location only when the target path remains ambiguous after checking these sources.

Do I need to update .gitignore before creating a git worktree?

Yes, safety verification of .gitignore is enforced before worktree creation. This check prevents accidental inclusion of worktree directories into the repository, ensuring baseline setup remains clean across supported project types.

Can I use git worktrees for parallel feature development across different project types?

Git worktrees support parallel feature development across supported project types with automated creation and baseline setup. They share the repository while tracking separate branches, allowing concurrent work without interfering with the main workspace.