git-worktree

Create an isolated git worktree with naming, base-ref selection, and .worktreeinclude copying.

1|Updated Jan 4, 2026
One-click install
npx skills add https://github.com/bossjones/boss-skills --skill git-worktree-bossjones
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-worktree
Source: https://github.com/bossjones/boss-skills/tree/main/plugins/boss-dev/agent-harness/skills/git-worktree
Command: npx skills add https://github.com/bossjones/boss-skills --skill git-worktree-bossjones

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill creates an isolated git worktree for feature development, ensuring a clean environment without branching.

Core Features & Use Cases

  • Isolated Worktree: Create a separate git worktree for each feature or experiment, avoiding branch conflicts.
  • Language-Specific Setup: Offers setup pointers for various programming languages.
  • Use Case: When starting a new feature, use this Skill to create a dedicated worktree with all necessary configurations.

Quick Start

Create a new worktree for the 'feature-x' branch.

Frequently Asked Questions about git-worktree

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

FAQPage Schema
How do I isolate feature development with git worktrees?

To isolate feature development with git worktrees, you can use a dedicated skill that automatically handles worktree naming, base-ref selection, and .worktreeinclude file copying. This creates a clean, separate environment for each feature without branching conflicts.

What is a git worktree and when should I use it for programming?

A git worktree is a linked working tree that allows you to check out multiple branches simultaneously in separate directories. Use it for feature development when you need an isolated environment to experiment without affecting your main working directory.

Do I need uv and Git 2.5.0 to create an isolated worktree?

Yes, you need Git 2.5.0 or higher and uv installed to use this worktree creation skill. These dependencies are required to successfully handle the base-ref selection and file copying processes for your development environment.

Can I use this git worktree setup for various programming languages?

Yes, the worktree creation skill supports various programming languages and provides specific setup pointers for each. This ensures your isolated development environment is correctly configured regardless of your tech stack.

What's the best way to avoid branch conflicts when starting a new feature?

The best way to avoid branch conflicts is to create a separate git worktree for each feature or experiment. This isolates your development environment, ensuring a clean workspace without the overhead of traditional branch switching.

Why does creating a git worktree require copying a .worktreeinclude file?

Copying a .worktreeinclude file ensures your new isolated worktree retains all necessary configurations from the main repository. This automated copying process guarantees a clean environment with the required setup files for feature development.