create-worktree-skill

Create isolated git worktrees with automatic port and environment configuration.

1.5k|387|Updated Jul 13, 2025
One-click install
npx skills add https://github.com/disler/claude-code-hooks-multi-agent-observability --skill create-worktree-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-worktree-skill
Source: https://github.com/disler/claude-code-hooks-multi-agent-observability/tree/main/.claude/skills/create-worktree-skill
Command: npx skills add https://github.com/disler/claude-code-hooks-multi-agent-observability --skill create-worktree-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers often need to work on multiple features or bug fixes simultaneously, requiring separate, isolated development environments. Manually setting these up (managing ports, dependencies, configs) is time-consuming and error-prone. This Skill automates that entire process, letting you focus on coding.

Core Features & Use Cases

  • Isolated Git Worktrees: Create new worktrees from any branch, ensuring a clean, independent workspace for parallel development.
  • Automatic Configuration: Handles unique port allocation, environment variables, and dependency installation for each new worktree.
  • Parallel Development: Run multiple project instances concurrently without conflicts, enabling seamless context switching.
  • Use Case: You're working on feature-A but need to quickly test a hotfix on main. Use this skill to spin up a main-hotfix worktree in seconds, test, and then remove it, all without interrupting your feature-A work.

Quick Start

Use a skill to create a worktree for the 'feature-auth' 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 let you work on multiple branches simultaneously in separate directories. This Skill automates worktree creation by setting up isolated environments with unique ports, dependencies, and configurations for each branch, enabling context-free parallel work without manual setup.

Can I run multiple project instances at the same time without port conflicts?

Yes. This Skill creates worktrees with automatic port-offset allocation and environment configuration, so each instance runs independently. You can spin up worktrees from different branches concurrently, each with its own ports and database setup, without conflicts.

What's the fastest way to test a hotfix while keeping feature work isolated?

Use this Skill to create a worktree from your hotfix branch in seconds. Your main feature worktree stays untouched with its own port and config, letting you test the hotfix independently and tear down the worktree when done—no context switching interruption.

Do I need to manually configure ports and environment variables for each worktree?

No. This Skill handles automatic configuration: it allocates unique ports via offset parameters, installs dependencies, generates environment files, and starts services for each worktree. You get access URLs and management instructions immediately after creation.

How do I remove a worktree once I'm finished with it?

This Skill provides management instructions after creating worktrees. You can remove isolated worktrees cleanly without affecting your main development environment or other active worktrees, since each is fully self-contained in its own directory.