One-click install
npx skills add https://github.com/shenxingy/Clade --skill worktree-shenxingy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktree
Source: https://github.com/shenxingy/Clade/tree/main/configs/skills/worktree
Command: npx skills add https://github.com/shenxingy/Clade --skill worktree-shenxingy

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Creating parallel coding tasks in the same Git repo often leads to file conflicts and messy context switching, so this Skill sets up isolated worktrees that let you run multiple Claude Code sessions safely.

Core Features & Use Cases

  • Create isolated worktrees: Generates a sibling directory with a dedicated branch and a TASK.md that a new session will auto-read.
  • List, merge, and clean up: Shows active worktrees, merges a worktree branch back into your current branch, and removes merged worktrees while handling safety prompts for conflicts or uncommitted changes.
  • Use case: When you need to tackle two fixes at once—like updating UI spacing and adjusting API rate limiting—create two worktrees so both changes can proceed without stepping on each other.

Quick Start

Open a terminal in your repo and run /worktree "Fix padding issues in settings pages" to create the worktree, branch, and TASK.md, then start a parallel Claude Code session in the new directory.

Frequently Asked Questions about worktree

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

FAQPage Schema
How do I run parallel Claude Code sessions in the same Git repo without file conflicts?

To run parallel Claude Code sessions safely, you create isolated Git worktrees with dedicated branches. This allows concurrent feature work or bugfix branches to proceed without stepping on each other, preserving a clean main workflow.

What is the best way to manage multiple concurrent feature branches for parallel development?

The best way to manage concurrent feature branches is using isolated Git worktrees. This approach creates sibling directories with dedicated branches and auto-generated task files, enabling multiple sessions to work simultaneously without messy context switching.

How do I merge a worktree branch back into my current branch and clean up?

You can merge a worktree branch back into your current branch and trigger cleanup through a dedicated merge workflow. The process safely removes merged worktrees and branches while prompting you to resolve any conflicts or uncommitted changes.

Can I use Git worktree to handle concurrent bugfix branches and iterative refactors?

Yes, Git worktree is designed specifically for concurrent bugfix branches and iterative refactors. It sets up isolated sibling directories so multiple tasks can proceed in parallel, automatically generating a TASK.md with branch context for each new session.

Does creating a Git worktree for parallel runs require manual branch setup?

No, creating a Git worktree for parallel runs does not require manual branch setup. The process automatically generates the worktree directory, creates the dedicated branch, and produces a TASK.md file that new Claude Code sessions will auto-read.

How do I list active Git worktrees to track parallel development sessions?

You can list active Git worktrees to track parallel development sessions using the built-in list feature. This provides a clear view of all active isolated worktrees, ensuring you can safely monitor and manage concurrent tasks before merging.