worktrees

Automate Git worktree management for isolated task development.

8|2|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/srstomp/pokayokay --skill worktrees-srstomp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktrees
Source: https://github.com/srstomp/pokayokay/tree/main/plugins/pokayokay/skills/worktrees
Command: npx skills add https://github.com/srstomp/pokayokay --skill worktrees-srstomp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Git worktrees enable isolated task development and parallel experimentation, reducing merge conflicts and branch clutter.

Core Features & Use Cases

  • Story-based reuse: Tasks within the same story share a worktree for related changes.
  • Auto dependency install: Dependencies install automatically on worktree creation.
  • Clean completion: Choose merge, PR, keep, or discard when done.
  • Isolation: All worktrees live under .worktrees/ and are auto-ignored by Git.

Quick Start

Run the worktrees workflow to create and reuse task worktrees as you progress through stories.

Frequently Asked Questions about worktrees

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

FAQPage Schema
What are Git worktrees used for in software development?

Git worktrees provide isolated task development and parallel experimentation, reducing merge conflicts and branch clutter by maintaining separate working directories for each story.

How do I set up Git worktrees for story-based task management?

Run the worktrees workflow to create and reuse task worktrees as you progress through stories. Dependencies install automatically on worktree creation, storing everything under a `.worktrees/` directory.

Can multiple related tasks share the same Git worktree?

Yes, tasks within the same story share a worktree for related changes. This story-based reuse keeps related task development isolated while preventing duplicate working directories.

What is the best way to manage Git branches for parallel development?

Using Git worktrees under a `.worktrees/` directory is an effective approach for parallel development. The directory is auto-ignored by Git, providing clean isolation for concurrent story-driven work.

How do I complete a task after working in an isolated Git worktree?

When done, choose to merge, PR, keep, or discard the worktree. These clear completion options allow you to cleanly integrate or remove isolated task changes from your repository.