create-worktree-skill

Create isolated Git worktrees with independent ports and configuration.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the hassle of managing multiple Git branches for parallel development, which often leads to context switching, merge conflicts, and port clashes. It automates the setup of isolated development environments.

Core Features & Use Cases

  • Isolated Environments: Creates fully configured Git worktrees with unique ports, databases, and environment files.
  • Parallel Development: Enables simultaneous work on multiple branches without conflicts, boosting productivity.
  • Automated Setup: Handles all configuration, dependency installation, and service startup automatically via a simple slash command.
  • Use Case: If you need to work on a hotfix while developing a new feature, use this skill to quickly spin up a separate, isolated environment for the hotfix branch.

Quick Start

Use a skill to create a worktree for the 'feature-new-dashboard' branch.

Frequently Asked Questions about create-worktree-skill

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

FAQPage Schema
How do I create isolated Git worktrees for parallel development?

Git worktrees enable parallel development by creating isolated branch environments with independent ports, databases, and configurations. Use the /create_worktree_prompt command with a branch name to instantly set up a separate worktree under trees/<branch-name>, configure services, and receive access URLs—eliminating context switching and merge conflicts.

Can I work on multiple Git branches simultaneously without port conflicts?

Yes. Worktrees automatically assign unique ports and isolated environments to each branch, preventing port clashes. Each worktree maintains separate databases and configuration files, allowing you to run multiple instances concurrently and test features independently without affecting other branches.

What's the fastest way to set up a development environment for a hotfix while working on a feature?

Create a worktree for your hotfix branch using a simple slash command with the branch name and optional port offset. The Skill automates dependency installation, service startup, and environment configuration, returning ready-to-use access URLs—no manual setup required.

Do I need to manually configure ports and databases for each Git branch?

No. Worktree creation handles all configuration automatically: unique ports are assigned via port-offset, environment files are generated per worktree, and database instances are isolated. You provide only the branch name; the rest is automated.

What happens after a Git worktree is created?

After creation, the worktree is fully configured with installed dependencies, running services, and isolated databases. You receive management instructions and access URLs to immediately begin development. The worktree persists under trees/<branch-name> until manually removed.