Does this skill work with multi-agent setups?

Yes, it is specifically designed to prevent state confusion when multiple AI agents or developers are working on different branches within the same repository using worktrees.

Can I use different names for the worktree directories?

Yes, the directory name on your filesystem can be anything (like a PR number or agent name); only the actual branch name inside the worktree must match the remote ref.

Why must the local branch name match the remote branch name exactly?

Matching names ensures Git's internal protection prevents the same branch from being checked out in multiple worktrees, which prevents conflicting pushes and lost work.

How does this skill help with Pull Requests?

It provides specific commands and logic for using the GitHub CLI (gh) to check out PRs into worktrees while maintaining correct naming conventions automatically.

Git Worktree Manager

Name: Git Worktree Manager
Author: nsheaps

bynsheaps

•

开发者工具

Optimizes Git worktree workflows by enforcing consistent branch naming and preventing remote branch conflicts.

This skill provides Claude with specialized guidance and best practices for managing Git worktrees, particularly during complex multi-agent or multi-branch development. It enforces a strict rule where local branch names must match remote branch names exactly, ensuring that Git's built-in protections prevent simultaneous checkouts of the same branch in different worktrees. By guiding the AI through proper checkout procedures and directory conventions, it eliminates risks like conflicting pushes, lost work, and state confusion in parallel development environments.

主要功能

01Enforces exact branch naming matches between local and remote repositories

021 GitHub stars

03Standardized workflows for checking out PRs using GitHub CLI

04Safe cleanup procedures to unblock branch checkouts

05Prevents conflicting pushes and data loss in multi-worktree setups

06Best practices for descriptive worktree directory naming

使用场景

01Managing long-running feature branches alongside urgent bug fixes in separate directories

02Reviewing multiple Pull Requests simultaneously without switching branches in the main clone

03Setting up isolated environments for multiple AI agents working on different features

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nsheaps/ai-mktpl git-worktree

For use in Claude.ai and ChatGPT