create-worktree-skill

Create isolated Git worktrees with separate ports and configurations.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/kenbanks-peng/dotfiles --skill create-worktree-skill-kenbanks-peng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-worktree-skill
Source: https://github.com/kenbanks-peng/dotfiles/tree/main/claude/skills/create-worktree-skill
Command: npx skills add https://github.com/kenbanks-peng/dotfiles --skill create-worktree-skill-kenbanks-peng

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bun.

What problem does it solve?

Managing multiple Git branches for parallel development often leads to context switching, port conflicts, and complex setup. This Skill automates the creation of isolated development environments, letting you focus on coding.

Core Features & Use Cases

  • Isolated Worktrees: Create separate Git worktrees with unique ports and configurations.
  • Parallel Development: Run multiple feature branches simultaneously without conflicts.
  • Use Case: Develop a new feature on feature-branch-A while simultaneously hot-fixing a bug on hotfix-branch-B, each running on its own set of ports and isolated configurations.

Quick Start

Use the create-worktree-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?

Creating isolated Git worktrees lets you run multiple branches simultaneously without port conflicts. This Skill automates worktree setup with separate ports, databases, and configurations for each branch, enabling concurrent feature and hotfix development.

What problem does Git worktree automation solve for branch management?

Git worktree automation eliminates manual context switching, port conflicts, and repetitive environment configuration when managing multiple branches. It creates fully isolated development environments where each worktree has its own ports and settings.

Can I run multiple feature branches at the same time without conflicts?

Yes. Worktree isolation enables parallel development by assigning unique ports and separate configurations to each branch. You can develop on feature-branch-A while simultaneously hotfixing on hotfix-branch-B without interference.

How does automatic port isolation work in worktree creation?

The Skill accepts an optional port-offset parameter to assign unique ports to each worktree. This prevents port binding conflicts, letting multiple services run concurrently across isolated development environments.

What setup does the Skill handle automatically for each worktree?

The Skill configures environment files, installs dependencies using Bun, and auto-starts services for each worktree. It organizes worktrees under a trees/ directory structure with branch-specific configurations and isolated database setups.