git-worktree-helper

Manage Git worktrees for parallel branch development with conflict reporting.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/henryzhuhr/iam --skill git-worktree-helper
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-worktree-helper
Source: https://github.com/henryzhuhr/iam/tree/main/.agents/skills/git-worktree-helper
Command: npx skills add https://github.com/henryzhuhr/iam --skill git-worktree-helper

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Git worktrees are a powerful but complex feature that can lead to tangled mappings and duplication when managing multiple feature branches. This skill provides a safe, repeatable workflow to inspect current worktrees, plan a clean layout, and create or verify worktrees in parallel without duplicating branches or creating conflicting paths.

Core Features & Use Cases

  • Batch-create worktrees for multiple branches while avoiding duplicates.
  • Visualize and verify branch-to-path mappings using git worktree list.
  • Safeguards and conflict reporting for path collisions and existing worktrees.
  • Supports a default repository-level layout with an optional base directory.

Quick Start

Provide the repository root, a target branch or pattern, and an optional base directory, then run this skill to batch-create and verify worktrees.

Frequently Asked Questions about git-worktree-helper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage Git worktrees for parallel branch development without creating path conflicts?

Batch-create Git worktrees by providing the repository root, target branches, and an optional base directory. The workflow enforces deterministic execution with standard Git commands to generate and verify worktrees in parallel.

How can I visualize and verify existing Git worktree mappings?

Visualize and verify existing Git worktree mappings by executing standard Git commands like `git worktree list`. This inspects current worktrees to ensure branch-to-path mappings are clean and untangled before planning new parallel layouts.

Can I batch-create worktrees for multiple branches at once?

Yes, you can batch-create worktrees for multiple branches simultaneously. The workflow processes target branch patterns while including safeguards and conflict reporting to avoid duplicates and path collisions across the repository.

What is the safest way to set up a Git worktree layout for multiple feature branches?

The safest way to set up a Git worktree layout is to plan a clean directory structure with an optional base directory, then validate existing worktrees. This repeatable workflow prevents tangled mappings and duplication when managing multiple feature branches.

Why do my Git worktrees get tangled when I switch between parallel branches?

Git worktrees get tangled due to complex path mappings and duplication when managing multiple feature branches manually. Using an automated workflow to inspect current worktrees and plan a clean layout resolves these mapping conflicts.