worktree-manager-skill

Create, list, and remove git worktrees with automatic port allocation.

Updated Jan 19, 2026
One-click install
npx skills add https://github.com/larus-peritus/pel_web --skill worktree-manager-skill-larus-peritus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktree-manager-skill
Source: https://github.com/larus-peritus/pel_web/tree/main/.claude/skills/worktree-manager-skill
Command: npx skills add https://github.com/larus-peritus/pel_web --skill worktree-manager-skill-larus-peritus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill simplifies managing multiple git worktrees by providing automated creation, listing, and removal of isolated development environments for parallel branches.

Core Features & Use Cases

  • Create: Provision a new worktree for a specific branch with automatic port allocation and environment setup.
  • List: Display all worktrees with status, ports, and access URLs for quick oversight.
  • Remove: Safely stop services, prune the worktree, and remove the git worktree from the repository.
  • Use Case: Work on several features in parallel without port conflicts or configuration bleed between environments.

Quick Start

Use the slash command /create_worktree <branch-name> to create a new worktree. Example: /create_worktree feature-auth

Frequently Asked Questions about worktree-manager-skill

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

FAQPage Schema
How do I automate git worktree creation for parallel development?

Automate git worktree creation by using the /create_worktree slash command with your branch name. This provisions an isolated environment with automatic port allocation and configuration setup for parallel branch work.

How can I prevent port conflicts when working with multiple git worktrees?

Prevent port conflicts during parallel development through deterministic port calculation. The skill automatically assigns dedicated ports to each worktree, ensuring isolated configurations and eliminating network collisions across branches.

What is the best way to list all active git worktrees and their ports?

List all active git worktrees using the built-in list command. This displays each worktree's status, allocated ports, and access URLs, providing quick oversight for managing parallel development environments.

How do I safely remove a git worktree and stop its running services?

Safely remove a git worktree by triggering the automated removal process. This stops active services, prunes the worktree files, and cleanly removes the branch environment from your git repository.

Can I use this worktree manager without installing external dependencies?

Yes, you can use this skill without external dependencies. It operates independently through slash commands to enforce deterministic provisioning, handling worktree lifecycles without requiring additional packages or tools.

Why does configuration bleed happen between parallel git branches?

Configuration bleed happens when branches share the same working directory and environment files. Using isolated git worktrees with dedicated ports and configurations prevents this cross-branch interference during parallel development.