using-git-worktrees

Create isolated git worktrees with automatic directory selection and safety verification.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/bjconlan/burndown --skill using-git-worktrees-bjconlan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/bjconlan/burndown/tree/main/.gemini/skills/using-git-worktrees
Command: npx skills add https://github.com/bjconlan/burndown --skill using-git-worktrees-bjconlan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Isolated git worktrees let you begin feature work in a separate workspace without disrupting the main development environment, reducing risk and context-switch costs by keeping changes contained and easy to review.

Core Features & Use Cases

  • Deterministic directory selection: prioritizes project-local '.worktrees' then 'worktrees', with a global option as a fallback.
  • Safety verification: ensures the chosen directory is ignored by git before creating the worktree.
  • Automatic setup and baseline validation: detects project type (Node, Rust, Python, Go) and runs appropriate setup and tests to confirm a clean baseline.
  • Flexible placement: supports per-project and global workspaces and automatic switch to preferred location when multiple exist.

Quick Start

Set up an isolated git worktree for the current project and verify it is ignored by git.

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 an isolated git worktree for feature development?

To create an isolated git worktree, use a guided workflow that automatically selects a local '.worktrees' or global directory, verifies it is git-ignored, and runs baseline tests to confirm readiness before you start feature development.

What is the best way to isolate git branches without disrupting my main workspace?

Isolating git branches is best achieved by creating worktrees in separate directories, which safely contains your feature work and reduces context-switching costs by keeping your main development environment completely undisrupted.

Does git worktree creation support automatic project setup for Node, Rust, and Python?

Yes, git worktree creation supports automatic environment-aware setup by detecting project types like Node, Rust, Python, and Go, then running appropriate configurations and baseline tests to validate a clean state.

How does git worktree safety verification prevent tracking issues?

Git worktree safety verification prevents tracking issues by checking that the chosen worktree directory, whether project-local or global, is properly added to your .gitignore file before the actual worktree creation process begins.

Can I use a global fallback directory for storing multiple git worktrees?

Yes, you can use a global fallback directory for storing git worktrees, and the system will automatically switch to this preferred location if multiple workspace directories exist or local options are unavailable.