using-git-worktrees

Create isolated git worktrees with safety checks and auto-detection.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating isolated git worktrees helps teams work on features without disrupting the main workspace, preventing accidental commits to the wrong branch.

Core Features & Use Cases

  • Reuse existing worktree locations when available, preferring hidden directories (.worktrees) over public ones.
  • Verify that the chosen worktree path is ignored by git to prevent accidental inclusion in the repository.
  • Support both project-local and global worktree storage locations with automatic project-name detection.
  • Auto-detects the current repository context and prepares a clean baseline for feature development.

Quick Start

Create an isolated git worktree for a new feature branch and start coding.

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 branch work?

To create a git worktree, the system auto-detects your repository context, identifies the project name and branch, and sets up a clean baseline in an isolated directory for feature development.

Why use git worktrees instead of switching branches in my main workspace?

Git worktrees isolate feature work to prevent accidental commits to the wrong branch and minimize disruption to your active workspace, allowing you to maintain multiple branches checked out simultaneously.

Can I use a global directory for git worktree storage across multiple projects?

Yes, git worktree creation supports both project-local and global storage locations, automatically detecting the project name to organize worktrees consistently across different repositories.

How do I ensure my git worktree path is safely ignored by the repository?

The setup process performs safety verification by checking that the chosen worktree path is properly ignored by git, preventing accidental inclusion of worktree directories in your repository.

Does the worktree setup reuse existing worktree locations if they already exist?

Yes, the system detects existing worktree locations and reuses them, preferring hidden directories like .worktrees over public ones to maintain a clean project structure.

Can I configure worktree preferences using CLAUDE.md?

Yes, the worktree creation process respects user preferences defined in CLAUDE.md or prompts, ensuring the storage location and setup align with your project-specific configuration.