using-git-worktrees

Create isolated Git worktrees for feature branches with automatic project setup.

7|1|Updated Feb 1, 2026
One-click install
npx skills add https://github.com/cloudfieldcz/cf-powers --skill using-git-worktrees-cloudfieldcz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/cloudfieldcz/cf-powers/tree/main/skills/using-git-worktrees
Command: npx skills add https://github.com/cloudfieldcz/cf-powers --skill using-git-worktrees-cloudfieldcz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Starting feature work often requires isolation from the current workspace to avoid disrupting the main branch; this skill automates creating isolated Git worktrees with safe directory selection and verification.

Core Features & Use Cases

  • Automated discovery of an appropriate worktree directory (.worktrees or worktrees) with optional CLAUDE.md preferences.
  • Safety verification to ensure the chosen directory is ignored by gitignore and to prevent accidental commits of worktree contents.
  • Guided creation of a worktree, followed by automatic project setup across common ecosystems (Node.js, Rust, Python, Go).
  • Use Case: A developer wants to begin feature development on a new branch without modifying the current workspace, then run project setup automatically.

Quick Start

Create a new isolated Git worktree for your feature branch and run the project setup commands.

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

To create a Git worktree safely, you need an isolated directory for your feature branch that leaves your current workspace untouched. The skill automates this by discovering a suitable directory, verifying it is gitignored, and setting up the project.

How does Git worktree isolation handle project setup for different programming languages?

Git worktree isolation handles project setup by automatically detecting and running configuration steps for common ecosystems like Node.js, Rust, Python, and Go. This ensures your isolated feature branch has its dependencies installed and is ready for development.

Why does my Git worktree directory need to be added to gitignore?

Your Git worktree directory must be added to gitignore to prevent accidental commits of the worktree contents into your main repository. The skill performs safety verification to ensure the chosen directory is properly ignored before proceeding.

Can I customize where my Git worktrees are stored using CLAUDE.md?

Yes, you can customize where Git worktrees are stored by defining directory preferences in your CLAUDE.md file. The skill checks existing directories, CLAUDE.md preferences, or requests user input to discover the correct location for your worktree.

What is the best way to verify a test baseline before starting feature work in a new Git worktree?

The best way to verify a test baseline is to let the skill create your Git worktree and run the automatic project setup. Upon completion, it reports the worktree location and provides a test baseline to ensure your isolated environment is functioning correctly.

Does Git worktree setup work with Go and Rust projects?

Yes, Git worktree setup works with Go and Rust projects. The skill auto-detects project setup steps across common ecosystems including Node.js, Rust, Python, and Go, automatically configuring the isolated worktree so you can start feature development immediately.