create-worktree-skill

Create isolated Git worktrees with per-worktree ports and database configuration.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing multiple Git branches simultaneously often leads to environment conflicts (ports, dependencies). This Skill automates the creation of isolated development environments, eliminating conflicts and saving setup time.

Core Features & Use Cases

  • Isolated Git Worktrees: Create separate, fully configured Git worktrees for parallel development.
  • Automatic Port & DB Configuration: Each worktree gets unique ports and database settings to prevent conflicts.
  • Use Case: Develop a new feature on feature-x while simultaneously debugging a hotfix on hotfix-y, each running independently without manual port juggling.

Quick Start

Use a skill to create a worktree for the feature-auth branch. Invoke the worktree skill for branch hotfix-security with port offset 5.

Frequently Asked Questions about create-worktree-skill

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

FAQPage Schema
How do I manage multiple Git branches simultaneously without port and database conflicts?

Git worktrees create isolated development environments for parallel branches. This Skill automates worktree setup, automatically assigning unique ports and database configurations to each branch so you can develop feature-x and hotfix-y side by side without manual conflict resolution.

Can I run multiple branches of the same project at the same time?

Yes. Git worktrees let you check out multiple branches in separate directories within the same repository. This Skill creates and configures each worktree with isolated ports, dependencies, and services so multiple branches run independently without interference.

How do I set up isolated testing environments for different Git branches?

Create a worktree for each branch you need to test. This Skill provisions each worktree with its own port offset and database settings, installs dependencies, starts services, and returns access URLs—enabling parallel testing without manual environment juggling.

What's the best way to avoid port conflicts when developing multiple features?

Isolated Git worktrees with per-worktree port configuration prevent conflicts. Specify a port offset when creating a worktree; this Skill automatically applies unique ports and database settings so each branch runs on its own isolated stack.

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

No. This Skill automates port and database configuration for each worktree based on branch name and optional port offset, eliminating manual setup and reducing environment conflicts across parallel development branches.

Can worktrees share the same Git repository?

Yes. Worktrees are branches of the same repository checked out in separate directories. This Skill creates multiple worktrees from a single repo, configuring each with isolated ports and services while maintaining a shared Git history.