create-worktree-skill

Create isolated git worktrees with configured ports and environment files.

2|Updated Nov 6, 2025
One-click install
npx skills add https://github.com/eduardoarantes/claude-code-plugin-marketplace --skill create-worktree-skill-eduardoarantes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-worktree-skill
Source: https://github.com/eduardoarantes/claude-code-plugin-marketplace/tree/main/git-worktree-complete/skills/create-worktree-skill
Command: npx skills add https://github.com/eduardoarantes/claude-code-plugin-marketplace --skill create-worktree-skill-eduardoarantes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the creation of fully configured git worktrees to enable parallel development with isolated ports, databases, and configuration, reducing setup time and conflicts.

Core Features & Use Cases

  • Automated worktree creation: Quickly provision a new worktree under trees/<branch-name> with its own environment.
  • Isolated environments: Separate ports, dependencies, and config per worktree to prevent cross-talk.
  • Real-world scenario: Create a worktree for the feature-auth branch and start its services without affecting the main repo.

Quick Start

Use the create-worktree-skill to invoke the worktree creation for a specific branch, for example: create a worktree for feature-auth by issuing the appropriate command.

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?

Create isolated git worktrees by specifying a branch name to automatically provision a new worktree under trees/<branch-name> with its own environment, ports, dependencies, and configuration. This enables concurrent development without conflicts between branches.

Can I run multiple branches simultaneously with separate ports and databases?

Yes, each worktree runs with isolated ports, databases, and environment files. Specify a port offset when creating the worktree, and services start independently without affecting other branches or the main repository.

What does the worktree creation process include?

Worktree creation extracts the branch name, applies port offset configuration, installs dependencies, starts both server and client services, and returns access URLs and management instructions for that isolated environment.

How much time does automated worktree setup save compared to manual setup?

Automated worktree creation eliminates manual environment configuration, dependency installation, and service startup for each branch. This reduces setup time and eliminates cross-talk conflicts from shared ports or configuration overlap.

Do I need to manage ports and configuration manually for each worktree?

No, the Skill handles port assignment through offset parameters and auto-configures isolated environment files per worktree. You specify the branch name and optional port offset; the Skill manages the rest.

What's the typical workflow for using worktrees in a multi-developer environment?

Invoke worktree creation for each feature branch to get an isolated environment. Services start automatically with unique ports. Once development completes, the worktree can be managed independently without impacting other branches or the main repository.

Related Skills