Skills
.Work. You
Rest

kata-git-worktree

Official

Move tasks into isolated Git worktrees.

Software Engineering#git#worktrees#cleanup#pull requests#branch workflow#issue-based development
Authorguardiatechnology
Version1.0.0
Installs0

System Documentation

What problem does it solve?

It prevents branch-based work from contaminating your main working tree by isolating each issue’s changes inside its own Git worktree and ensuring consistent creation, usage, PR opening, and cleanup.

Core Features & Use Cases

  • Issue-first branch scoping: Forces you to use an existing GitHub issue number in the branch and directory naming scheme (e.g., feat/42-scheduled-payments-api and .worktrees/42-scheduled-payments-api).
  • Safe worktree lifecycle: Verifies whether the branch or directory already exists before creating a new worktree, then enters the worktree to implement and commit changes.
  • End-to-end PR workflow: Pushes the branch, opens a PR that closes the issue, and removes both the worktree and local branch after merge.
  • Use Case: When implementing a feature for a specific ticket (like “Add scheduled payments API”), create an isolated worktree, implement the changes there, and then open a PR without risking other local work.

Quick Start

Ask the AI to create and manage a worktree for issue #42 using type feat and slug scheduled-payments-api, then open the PR and clean up after it’s merged.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: kata-git-worktree
Download link: https://github.com/guardiatechnology/design-system/archive/main.zip#kata-git-worktree

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.