Skills
.Work. You
Rest

worktrees

Community

Safely create isolated git worktrees.

Software Engineering#git#workflow#isolation#safety#branching#worktree
AuthorCastrozan
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This skill helps developers isolate feature work by creating and managing git worktrees to keep the main branch clean.

Core Features & Use Cases

  • Create isolated worktrees with predictable paths like .worktree/<branch>.
  • Enforce safe directory layouts and prevent nested directories that could cause data loss.
  • Real-world use: Start a new feature branch in a dedicated worktree while the main repo remains stable.

Quick Start

  • Ensure you are in the project root. Update the main branch with: git fetch origin && git checkout main && git pull.
  • Create a new worktree (for general repos): git worktree add .worktree/<branch> -b <branch>.
  • For the dotfiles repo, use the provided helper: ./bin/git-worktree-crypt <branch> (creates at .worktrees/<branch> and uses git-crypt).
  • After finishing, run /rebuild to test changes and open a PR using your preferred tool (gh pr create or glab pr create) from the main repo directory.

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: worktrees
Download link: https://github.com/Castrozan/.dotfiles/archive/main.zip#worktrees

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 223,000+ vetted skills library on demand.