using-git-worktrees

Creates Git worktrees for isolated feature development and manages them efficiently.

12|9|Updated Oct 23, 2025
One-click install
npx skills add https://github.com/jnealey88/designsetgo --skill using-git-worktrees-jnealey88
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/jnealey88/designsetgo/tree/main/.claude/skills/using-git-worktrees
Command: npx skills add https://github.com/jnealey88/designsetgo --skill using-git-worktrees-jnealey88

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Organize feature work by creating isolated Git worktrees, preventing changes in the main workspace and enabling parallel development without branch switching.

Core Features & Use Cases

  • Automatic directory selection: prefers project-local .worktrees or worktrees, with global fallback
  • Safety verification: ensures the chosen workspace is ignored by gitignore to prevent accidental commits
  • Flexible location: supports project-local and global worktree storage locations
  • Auto-setup and onboarding: detects project context and prepares the environment for feature work
  • Clear reporting: communicates the resulting worktree path and status for next steps

Quick Start

Create a new isolated git worktree for a feature branch and begin work in the dedicated directory.

Frequently Asked Questions about using-git-worktrees

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

FAQPage Schema
How do I create isolated git worktrees for parallel feature development?

Isolated git worktrees separate feature work from the main workspace, preventing accidental cross-branch changes. This Skill automates directory discovery in project-local or global locations, applies gitignore safety verification, and executes onboarding steps to prepare the environment for parallel branch work without switching contexts.

What is the best way to manage multiple git branches without stashing current changes?

Git worktrees allow you to manage multiple branches simultaneously by creating isolated working directories from a single repository. Each worktree maintains its own working directory state, enabling parallel development and experimentation without stashing or committing incomplete changes in your main workspace.

How does git worktree isolation prevent accidental commits of temporary directories?

Worktree isolation enforces safety by verifying the chosen storage directory is properly ignored by gitignore rules before creation. This prevents the version control system from tracking the worktree location as an untracked path, ensuring temporary or parallel development directories are never accidentally committed.

Can I configure git worktree storage locations using CLAUDE.md preferences?

Yes, git worktree storage locations can be configured using CLAUDE.md preferences. The automation prioritizes project-local directories like .worktrees, with a global fallback option, applying directory discovery logic to find existing worktree locations and matching them to your defined configuration preferences.

When should I use isolated git worktrees instead of cloning a repository for experimentation?

Isolated git worktrees are ideal for early feature development, experimentation, or parallel branch work on local or global locations. They share the same underlying repository history, avoiding the disk space overhead and remote synchronization required by a full repository clone for isolated feature work.