using-git-worktrees

Create isolated Git worktrees for branch-specific development with dependency and baseline checks.

Updated Dec 22, 2025
One-click install
npx skills add https://github.com/acho1833/spreadline2 --skill using-git-worktrees-acho1833
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/acho1833/spreadline2/tree/main/.claude/commands/using-git-worktrees
Command: npx skills add https://github.com/acho1833/spreadline2 --skill using-git-worktrees-acho1833

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you start feature work in an isolated git workspace so you can avoid disrupting your current branch, reduce merge confusion, and keep implementation work cleanly separated.

Core Features & Use Cases

  • Workspace Isolation: Creates a separate worktree for branch-specific development without switching away from the current checkout.
  • Safe Directory Selection: Follows a priority order for choosing .worktrees, worktrees, or a global location, with prompts when no preference exists.
  • Guardrail Checks: Verifies project-local worktree directories are ignored before creating them, preventing accidental commits of workspace files.
  • Use Case: Start a new feature, bug fix, or implementation plan in a fresh worktree while preserving your main workspace exactly as-is.

Quick Start

Use the using-git-worktrees skill to set up an isolated git worktree for my current 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 create an isolated git workspace without switching my current branch?

Git worktrees create isolated workspaces for branch-specific development without disrupting your current checkout. This Skill automates worktree creation, directory preference detection, and safety verification to keep your main workspace exactly as-is.

What is the best way to manage multiple feature branches in one git repository?

Managing multiple feature branches in one git repository is streamlined by using worktrees. This Skill sets up branch isolation by creating separate worktree directories, verifying gitignore safety, and running baseline test checks before reporting readiness.

How do I prevent accidentally committing worktree directories to my git repository?

To prevent accidentally committing worktree directories, this Skill verifies project-local worktree directories are properly ignored in gitignore before creating them. This guardrail check ensures workspace files remain safely separated from your main repository.

Can I use git worktrees for implementation plans that require branch-specific development?

Yes, git worktrees are designed for implementation plans and branch-specific development. This Skill applies to multi-task repository work by detecting directory preferences, setting up dependencies, and performing baseline test checks to ensure safe workspace isolation.

Where should I put my git worktrees to keep my repository clean?

Git worktrees should be placed in designated directories to keep your repository clean. This Skill follows a priority order for safe directory selection, checking for `.worktrees`, `worktrees`, or a global location, and prompts you when no preference exists.