using-git-worktrees

Create isolated git worktrees with gitignore verification and automatic path calculation.

16|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/Marwan78888/Neuron-Cli --skill using-git-worktrees-marwan78888
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/Marwan78888/Neuron-Cli/tree/main/scratch/superpowers-main/skills/using-git-worktrees
Command: npx skills add https://github.com/Marwan78888/Neuron-Cli --skill using-git-worktrees-marwan78888

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables the safe creation of isolated git workspaces to allow feature work without impacting the main branch.

Core Features & Use Cases

  • Directory discovery and preferred location handling (.worktrees, worktrees, and global/global hints via CLAUDE.md)
  • Safety verification to ensure the selected directory is ignored by gitignore before proceeding
  • Automatic worktree creation with proper path resolution based on the chosen location
  • Per-project setup: auto-detect project type (Node.js, Rust, Python, etc.) and run initial installs/builds
  • Ready-state reporting to verify readiness for feature implementation

Quick Start

Create a new isolated git worktree for your feature branch and verify it is ignored by .gitignore before starting project setup.

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 isolated git worktrees for feature branches without affecting the main branch?

To create isolated git worktrees, the skill automates directory discovery, verifies the target path is ignored by gitignore, and sets up a separate workspace. This allows safe feature development without impacting your main branch.

How does git worktree path resolution work with local and global configurations?

Git worktree path resolution checks preferred locations like .worktrees or worktrees, and reads global hints from CLAUDE.md. It calculates the automatic path based on your chosen directory and local or global project configurations.

Do I need to verify gitignore before setting up a git worktree?

Yes, you need gitignore verification before setting up a git worktree to ensure the selected directory is safely ignored. The skill performs safety checks to confirm your worktree path is properly excluded from version control.

Can I run automatic project setup for Node.js, Rust, or Python after creating a git worktree?

Yes, you can run automatic project setup after creating a git worktree. The skill auto-detects project types like Node.js, Rust, or Python and executes initial installs and builds to report a ready state for feature implementation.

What is the best way to manage multi-branch git workflows safely?

The best way to manage multi-branch git workflows is by creating isolated git workspaces. This approach applies safety checks and directory isolation, allowing you to handle multiple branches simultaneously without risking main branch instability.

Why should I use directory isolation for git feature work instead of cloning repositories?

Directory isolation via git worktrees saves disk space and sharing overhead compared to cloning. It provides a lightweight, linked workspace for your feature branch while maintaining strict separation from the main branch through verified gitignore rules.