worktree-setup

Automate Claude Code worktree initialization and maintenance with generated hooks.

7|Updated May 28, 2026
One-click install
npx skills add https://github.com/zcaceres/skills --skill worktree-setup-zcaceres
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktree-setup
Source: https://github.com/zcaceres/skills/tree/main/plugins/quality/skills/worktree-setup
Command: npx skills add https://github.com/zcaceres/skills --skill worktree-setup-zcaceres

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, and includes references (resource) and assets (resource) components.

What problem does it solve?

This skill solves the friction of setting up new development worktrees by automating the discovery and configuration of gitignored files, environment variables, dependencies, and port assignments.

Core Features & Use Cases

  • Automated Bootstrap: Automatically detects and configures missing gitignored files and install steps for new worktrees.
  • Environment Consistency: Ensures per-worktree ports and shared caches are correctly wired to prevent collisions and save time.
  • Verification: Includes a built-in smoke test to validate that the worktree is fully functional before you start coding.

Quick Start

Run the worktree-setup skill to bootstrap the current repository for automatic worktree configuration.

Frequently Asked Questions about worktree-setup

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

FAQPage Schema
How do I automate git worktree setup for multi-branch development?

Automating git worktree setup involves discovering repository-specific requirements and generating hooks to configure dependencies and ports. This skill standardizes Claude Code worktrees by detecting missing gitignored files and wiring environment variables for multi-branch workflows.

How does worktree environment consistency prevent port collisions?

Worktree environment consistency prevents port collisions by assigning per-worktree ports and correctly wiring shared caches during setup. This ensures multiple branches run simultaneously without overlapping network configurations or competing for resources.

Do I need jq to configure Claude Code dev environments?

Yes, you need jq installed to configure Claude Code dev environments using this skill. Jq is a required dependency for parsing repository requirements and generating the automated hooks needed for non-destructive file merging and setup.

Can I verify a new development worktree is functional before coding?

Yes, you can verify a new development worktree is functional by running a built-in smoke test. This validation checks that environment setup, dependency installation, and port management are correctly configured before you start coding.

What's the best way to bootstrap idempotent configuration for git worktrees?

The best way to bootstrap idempotent configuration for git worktrees is to automate the discovery of repository requirements while applying non-destructive file merging. This ensures repeated setup runs produce consistent environments without overwriting existing local changes.