using-git-worktrees

Create and manage isolated git worktrees for parallel feature development.

4|Updated Jan 10, 2026
One-click install
npx skills add https://github.com/atxinsky/skills --skill using-git-worktrees-atxinsky
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/atxinsky/skills/tree/main/using-git-worktrees
Command: npx skills add https://github.com/atxinsky/skills --skill using-git-worktrees-atxinsky

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill streamlines starting feature work by creating isolated git worktrees, keeping your current workspace clean and preventing cross-branch pollution.

Core Features & Use Cases

  • Directory selection with a defined priority (existing local worktree directories, CLAUDE.md preferences, or user prompt).
  • Safety verification to ensure the selected directory is ignored by git and won't leak the worktree contents.
  • Automated creation of a worktree tied to a new or existing feature branch, plus automatic project setup (dependency installation or build steps) when applicable.
  • Clear reporting of worktree location and readiness to start implementation.

Quick Start

Ask me to set up an isolated workspace for a feature, for example: "/using-git-worktrees feature/awesome-auth"

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 branches to prevent cross-branch pollution in git?

Git worktrees isolate feature branches by creating separate working directories, keeping your current workspace clean and preventing cross-branch pollution. This enables safe parallel development across multiple tasks without stashing incomplete changes.

How do I create a git worktree for a new feature branch?

To create a git worktree, the skill selects an isolated directory, verifies it is git-ignored to prevent leaks, ties the worktree to a new or existing feature branch, and runs initial project setup commands. It then reports the worktree location and readiness for implementation.

What is the best way to manage parallel development across multiple git branches?

Git worktrees provide the best way to manage parallel development by assigning separate working directories to each task. This workflow automation isolates branch management tasks, allowing you to switch contexts instantly without changing your current repository state.

How does git worktree safety verification prevent directory leaks?

Git worktree safety verification checks the selected directory's ignore status to ensure it is properly git-ignored. This prevents the worktree contents from being accidentally tracked or leaked into the main repository, keeping branch isolation secure.

Do I need to manually run build commands after setting up a git worktree?

No, you do not need to manually run build commands. The worktree creation process includes automated project setup, which executes dependency installation and initial build steps automatically when applicable, reporting readiness upon completion.