git-worktrees

Create an isolated Git worktree workspace with baseline tests.

47|12|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/btseytlin/ultrapack --skill git-worktrees-btseytlin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-worktrees
Source: https://github.com/btseytlin/ultrapack/tree/main/plugins/up/skills/git-worktrees
Command: npx skills add https://github.com/btseytlin/ultrapack --skill git-worktrees-btseytlin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill prevents messy local changes by creating an isolated Git worktree so you can run setup and tests without interfering with your current workspace.

Core Features & Use Cases

  • Worktree directory selection by priority: Uses a deterministic preference order, including .worktrees/, worktrees/, and a configurable project setting via CLAUDE.md.
  • Safety guardrails for project-local directories: Verifies that project-local worktree directories are gitignored before creating them, and updates .gitignore if they are not.
  • Baseline environment parity and verification: Shares the main workspace environment into the new worktree (when applicable) and runs detected baseline test/build steps to confirm the starting state.

Quick Start

Use git-worktrees when you need to isolate a feature branch and run baseline tests in a clean worktree without disrupting your current workspace.

Frequently Asked Questions about git-worktrees

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

FAQPage Schema
How do I isolate feature development from my current Git working directory?

Git worktrees isolate feature development by creating a separate working directory linked to your repository, enabling setup and tests without modifying your current workspace state.

What is the best way to run baseline tests in a clean Git environment?

Running baseline tests in a clean Git worktree environment shares the main workspace configuration, auto-detects setup steps, and verifies tests pass before you proceed with further changes.

How do I set up parallel subagent execution without local Git branch conflicts?

Setting up parallel subagent execution requires isolated Git worktrees that provide deterministic path selection and clean baseline environments, preventing branch conflicts across concurrent tasks.

Does creating a Git worktree automatically update .gitignore for project-local directories?

Creating a Git worktree validates gitignore status for project-local directories and automatically updates your .gitignore file to ensure worktree directories are properly excluded from version control.

Can I configure the worktree directory path preference for my project?

You can configure worktree directory path preferences using a deterministic priority order that checks .worktrees/, worktrees/, and custom project settings defined within your CLAUDE.md file.