create-worktree

Create git worktrees with automatically generated branches for parallel development.

Updated May 4, 2025
One-click install
npx skills add https://github.com/vnatarajan4061/phoenix --skill create-worktree-vnatarajan4061
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-worktree
Source: https://github.com/vnatarajan4061/phoenix/tree/main/.claude/skills/create-worktree
Command: npx skills add https://github.com/vnatarajan4061/phoenix --skill create-worktree-vnatarajan4061

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The need for a streamlined process to create separate git worktrees for parallel development, allowing for concurrent work on multiple branches.

Core Features & Use Cases

  • Parallel Branching: Enables working on multiple branches simultaneously without conflicts.
  • Worktree Creation: Automates the creation of a new worktree at ../bluebasin-{description}.
  • Branch Naming: Dynamically generates branch names using user initials, description, and optional ticket ID.

Quick Start

Use the /create-worktree command to initiate a new worktree with a description, such as '/create-worktree fix provider ingestion DTA-3775'.

Frequently Asked Questions about create-worktree

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

FAQPage Schema
How do I create a git worktree for parallel development?

To create a git worktree, run the /create-worktree command with a description and optional ticket ID. The script automatically generates a new branch and sets up the worktree at ../bluebasin-{description} for concurrent work.

What is the best way to manage parallel git branches without conflicts?

Using git worktrees is the best way to manage parallel git branches without conflicts. This skill automates branch creation and worktree setup, allowing you to work on multiple branches simultaneously in separate directories.

Do I need Python to automate git branch creation?

Yes, you need Python installed in your environment to execute the branch management commands. The script relies on Python to dynamically generate branch names using your initials, description, and optional ticket ID.

Can I automatically generate branch names from a ticket ID?

Yes, you can automatically generate branch names from a ticket ID by including it in the command. The script dynamically constructs the branch name by combining your user initials, the provided description, and the optional ticket ID.

How does git worktree branching work for concurrent development?

Git worktree branching allows concurrent development by linking a new working directory to a newly created branch. This lets you switch contexts instantly without stashing changes or cloning the repository again.

Are there limitations to using git worktrees for parallel development?

Git worktrees require an existing git repository and a Python environment to execute the creation script. They are created at ../bluebasin-{description}, so you must ensure appropriate file system permissions and directory space for concurrent branches.