using-git-worktrees

Create isolated git worktrees for parallel feature development.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Isolate feature work by creating isolated git worktrees that share the same repository, enabling parallel development without polluting your main workspace.

Core Features & Use Cases

  • Priority-based directory selection: uses existing local worktree directories, CLAUDE.md hints, or prompts for a location.
  • Safety verification: verifies that the target directory is ignored by git to prevent accidental commits of worktree contents.
  • Automated setup & verification: automatically runs project setup steps and confirms a clean baseline before starting work.
  • General applicability: supports common stacks (Node, Python, Go, etc.) with auto-detection for dependencies and test commands.

Quick Start

Create a new isolated git worktree for your feature branch and run the project setup to establish a clean baseline.

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 parallel feature development?

To create an isolated git worktree, the system uses priority-based directory selection from existing local worktrees, CLAUDE.md hints, or user prompts, then automatically runs project setup steps to establish a clean baseline for parallel feature development.

What is git worktree isolation and when do I need it?

Git worktree isolation creates separate working directories sharing the same repository, enabling parallel development without polluting your main workspace. You need it when working on multiple feature branches simultaneously or requiring safe directory separation.

Does git worktree setup support Node, Python, and Go project tooling?

Yes, git worktree setup supports common stacks including Node, Python, and Go with auto-detection for dependencies and test commands. It automatically identifies project tooling to run appropriate setup steps and baseline checks.

Why does git worktree creation verify that the target directory is ignored?

Git worktree creation verifies the target directory is ignored to prevent accidental commits of worktree contents into the main repository. This safety verification ensures isolated worktree files remain separate from your primary project history.

Can I use CLAUDE.md to configure git worktree directory locations?

Yes, you can use CLAUDE.md to configure git worktree directory locations. The system uses priority-based selection that checks CLAUDE.md hints, existing local worktree directories, or prompts for a location if no preference is found.