add-worktree

Create a Git worktree for a GitHub issue with branch naming checks.

1|1|Updated Jan 16, 2026
One-click install
npx skills add https://github.com/drillan/mixseek-plus --skill add-worktree
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-worktree
Source: https://github.com/drillan/mixseek-plus/tree/main/.claude/skills/add-worktree
Command: npx skills add https://github.com/drillan/mixseek-plus --skill add-worktree

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the manual setup work required to start issue-based development in a clean, isolated Git worktree. It helps you avoid branch naming mistakes, duplicate worktree creation, and inconsistent local project setup.

Core Features & Use Cases

  • Issue-to-Worktree Automation: Reads a GitHub issue, validates that it is open, and turns it into a new branch plus worktree.
  • Branch Naming and Safety Checks: Chooses a branch prefix from labels or keywords, then checks whether the branch or worktree already exists before creating anything.
  • Project-Specific Setup Preservation: Copies repository-specific .hachimoku configuration into the new worktree when needed so custom agent and review settings stay intact.
  • Use Case: A developer wants to start work on issue #200 without disturbing the main checkout, so this Skill creates a dedicated branch and directory ready for implementation.

Quick Start

Ask the assistant to create a new worktree for the specified GitHub issue number and set it up with the repository’s existing configuration.

Frequently Asked Questions about add-worktree

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

FAQPage Schema
How do I create a Git worktree for a GitHub issue?

To create a Git worktree for a GitHub issue, the Skill reads the issue, validates it is open, and automatically generates an isolated local checkout directory with a consistently named branch for implementation work.

How does branch naming work when creating a worktree from an issue?

Branch naming for a worktree is determined by detecting branch-type prefixes from the GitHub issue's labels or keywords, ensuring consistent naming conventions while checking for existing branches to prevent duplication.

Can I copy repository configuration into a new Git worktree automatically?

Yes, you can copy repository-specific configuration into a new Git worktree. The Skill optionally duplicates your existing .hachimoku configuration into the new directory to preserve custom agent and review settings.

What happens if a branch or worktree already exists for an issue?

If a branch or worktree already exists for an issue, the Skill performs safety checks before creating anything. It validates existing branches and local checkout directories to prevent duplicate worktree creation and avoid overwriting files.

Do I need to manually check if a GitHub issue is open before creating a branch?

No, you do not need to manually check if a GitHub issue is open. The Skill handles issue lookup internally and validates that the issue is open before initiating the branch and worktree creation process.

What is the best way to isolate development work for a specific GitHub issue?

The best way to isolate development work is using a Git worktree. This approach creates a dedicated local checkout directory and branch for the issue, preventing disturbances to your main project workspace during implementation.