using-git-worktrees

Create isolated Git worktrees with safety checks and project auto-setup.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/park-kyungchan/palantir --skill using-git-worktrees-park-kyungchan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/park-kyungchan/palantir/tree/main/.claude/plugins/cache/claude-plugins-official/superpowers/4.2.0/skills/using-git-worktrees
Command: npx skills add https://github.com/park-kyungchan/palantir --skill using-git-worktrees-park-kyungchan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides safe isolation for feature work by creating and managing Git worktrees, avoiding disruption to the current workspace and enabling parallel development.

Core Features & Use Cases

  • Directory-aware isolation: automatically chooses a worktree location (.worktrees, worktrees, or a user-specified path) with safety checks.
  • Safety verification: ensures the chosen worktree path is ignored by git to prevent accidental commits of worktree contents.
  • Auto-setup per project: detects common project setups (package.json, Cargo.toml, pyproject.toml) and installs/builds accordingly.
  • Use Case: start a feature on a new branch without changing the main working directory, then switch back when done.

Quick Start

Use the using-git-worktrees skill to set up an isolated workspace for a new feature branch, verify the directory is ignored, and run the appropriate setup commands for the project.

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, this skill automatically discovers your project, prioritizes a directory location like .worktrees, and verifies the path is git-ignored before creating the workspace. This preserves your current directory while enabling safe parallel branch work.

Does git worktree setup work with Node, Rust, Python, and Go projects?

Git worktree setup works with Node, Rust, Python, and Go projects by automatically detecting configuration files like package.json, Cargo.toml, and pyproject.toml. It then runs the appropriate installation and build commands to prepare the isolated environment.

Why do I need to ensure my git worktree directory is ignored?

You need to ensure your git worktree directory is ignored to prevent accidental commits of worktree contents into your main repository. This skill performs safety verification to guarantee the chosen worktree path is properly excluded from git tracking.

What is the best way to experiment safely with a new branch without disrupting my current workspace?

The best way to experiment safely is using git worktrees to create an isolated workspace on a new branch. This skill handles project discovery, directory prioritization, and environment auto-setup, allowing you to switch back to your main directory when done.

Can I specify a custom path for my git worktree instead of the default directory?

You can specify a custom path for your git worktree, or let the skill automatically choose between default locations like .worktrees or worktrees. It applies safety checks to verify the chosen location is ignored by git before creating the isolated feature development environment.

When should I use git worktrees for feature development instead of simply switching branches?

You should use git worktrees for feature development when you require parallel branch work or safe experimentation without disrupting your current workspace. This approach avoids stashing changes and allows immediate switching between isolated development environments.