using-git-worktrees

Create isolated git worktrees for feature development across Node.js, Rust, Python, and Go projects.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill creates and manages isolated git worktrees to enable parallel feature work without polluting the main workspace.

Core Features & Use Cases

  • Smart directory selection: prefers .worktrees if present, then worktrees.
  • CLAUDE.md preferences: respects documented worktree preferences when available.
  • Safety checks: verifies .gitignore includes worktree directories and ensures clean baselines.

Quick Start

Create and switch to an isolated worktree for a new feature branch.

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 without affecting my main workspace?

Git worktrees create isolated workspaces for parallel feature development. Each worktree is a linked checkout of your repository at a different branch, letting you work on multiple features simultaneously without switching branches or stashing changes in your main workspace.

What's the best way to set up worktrees for a new feature?

Create a worktree by running a command that generates an isolated workspace, verifies your `.gitignore` includes the worktree directory, and ensures a clean baseline through tests. The Skill automates directory selection, preferring `.worktrees` if present, then `worktrees`, and respects any `CLAUDE.md` preferences.

Can I use git worktrees across Node.js, Python, Rust, and Go projects?

Yes, git worktrees work across Node.js, Rust, Python, and Go projects. The Skill includes per-project setup automation that adapts to each language's build and test conventions, ensuring each worktree maintains a clean baseline.

When should I not use git worktrees?

Avoid worktrees for quick fixes or temporary changes to the current workspace. Worktrees are designed for sustained feature development requiring isolation and clean baselines. For brief edits, branch switching is more appropriate.

How do worktrees handle .gitignore safety?

The Skill verifies that `.gitignore` includes worktree directories before creating them, preventing accidental commits of isolated workspace artifacts and ensuring repository cleanliness across all linked checkouts.

Do I need to manually select a worktree directory location?

No, the Skill uses smart directory selection, automatically preferring `.worktrees` if it exists, then `worktrees`, and respecting documented preferences in `CLAUDE.md` for hands-off setup.