Skills
.Work. You
Rest

git-worktree-prepare

Community

Create deterministic, reusable git worktrees

Software Engineering#automation#git#bash#worktree#branch-management#parallel-development
Authorf4irline
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill prevents branch checkout conflicts by creating or reusing isolated git worktrees for target branches so multiple agents or parallel processes can work concurrently without interfering with each other.

Core Features & Use Cases

  • Deterministic Path Layout: Always places worktrees under .opencode/.bbq-worktrees with branch names normalized by replacing slashes with dashes.
  • Safe Creation & Reuse: Detects an existing attached worktree for a branch and reuses it, or creates a new tracked branch or branch from the remote default when needed.
  • Local-only File Syncing: Mirrors repository-local files listed in .opencode/worktree-local-files into new worktrees using symlinks with copy fallbacks to keep environment files consistent.
  • Use Case: Ideal for ticket-driven development where multiple agents spin up parallel environments for features, automated CI tasks, or agent-based code workflows.

Quick Start

Run the skill with the target branch name to create or reuse the deterministic worktree path and sync local-only files into it.

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: git-worktree-prepare
Download link: https://github.com/f4irline/bbqparty-ai/archive/main.zip#git-worktree-prepare

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.