using-git-worktrees

Create isolated git worktrees for feature branches with dependency setup and baseline testing.

1|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/synqing/Lightwave-Ledstrip --skill using-git-worktrees-synqing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/synqing/Lightwave-Ledstrip/tree/main/.claude/skills/using-git-worktrees
Command: npx skills add https://github.com/synqing/Lightwave-Ledstrip --skill using-git-worktrees-synqing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When starting feature work, this skill creates isolated git worktrees to keep changes separate from the main workspace, with smart directory selection and safety checks.

Core Features & Use Cases

  • Directory choice: Prefers .worktrees, then worktrees, or asks for location.
  • Safety checks: Verifies .gitignore before creating local worktrees and updates it if needed.
  • Global option: Supports a global location for worktrees outside the project.

Quick Start

Start by choosing a worktree location when prompted, then run project setup (e.g., install dependencies) in the new workspace and begin your feature work.

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 work in Git without affecting my main branch?

Git worktrees create isolated development workspaces with separate branches, keeping your feature work completely isolated from the main repository. Each worktree has its own directory and branch, so you can work on multiple features simultaneously without conflicts.

What's the best way to set up multiple feature branches locally?

Use git worktrees to provision separate workspaces for each feature branch. The Skill automatically detects your project, selects a worktree directory, creates a new branch, installs dependencies for Node.js, Rust, Python, and Go, and runs baseline tests before you start work.

Can I create worktrees in a custom directory outside my project?

Yes, git worktrees support a global location option for storing worktrees outside your main repository. You can choose between local directories like .worktrees or worktrees, or specify a custom global path when prompted.

Do I need to manually manage .gitignore when creating local worktrees?

No, the Skill verifies your .gitignore before creating local worktrees and updates it automatically if needed, ensuring safety checks protect your repository configuration.

How does git worktree setup handle project dependencies?

After provisioning a worktree with a new branch, the Skill auto-installs dependencies for Node.js, Rust, Python, and Go projects, then runs baseline tests to confirm the workspace is ready for development.