using-git-worktrees

Create and manage Git worktrees for isolated parallel development spaces.

Updated Apr 24, 2026
One-click install
npx skills add https://github.com/michael-conrad/.opencode --skill using-git-worktrees-michael-conrad
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/michael-conrad/.opencode/tree/main/skills/using-git-worktrees
Command: npx skills add https://github.com/michael-conrad/.opencode --skill using-git-worktrees-michael-conrad

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Git worktrees provide isolated workspaces for parallel development, reducing cross-branch interference and merge conflicts by sharing a single repository while operating in separate trees.

Core Features & Use Cases

  • Create isolated worktrees for feature branches to enable parallel development without duplicating repos.
  • Ensure safe path prefixes and consistent base-branch workflows for multi-agent coordination.
  • Manage lifecycle: verify, reuse existing worktrees, and export environment details for downstream tasks.

Quick Start

Create a worktree for a new feature branch and begin isolated development in the dedicated .worktrees path.

Frequently Asked Questions about using-git-worktrees

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

FAQPage Schema
How do I isolate parallel feature work in a single Git repository?

Use Git worktrees to establish isolated development spaces for parallel tasks. Worktrees share a single repository while operating in separate trees, reducing cross-branch interference and merge conflicts during feature work or speculative experiments.

What's the best way to manage Git worktrees for multi-agent coordination?

Managing Git worktrees for multi-agent coordination requires safe path prefixes and consistent base-branch workflows. This approach verifies existing worktrees for reuse and exports environment details to downstream tasks, ensuring isolated development across parallel agents.

When should I use Git worktrees instead of cloning a repository?

Use Git worktrees when you need isolated workspaces for parallel development without duplicating repos. Worktrees are ideal for feature work, speculative experiments, and multi-agent coordination, preventing cross-branch interference while sharing a single repository.

How do I set up a worktree for a new feature branch?

Create a worktree for a new feature branch to begin isolated development in a dedicated .worktrees path. The workflow applies safety checks and base-branch selection to ensure consistent setup for parallel tasks within the repository.

Does Git worktree workflow support exporting environment details to downstream tasks?

Yes, Git worktree workflows support exporting environment details to downstream tasks. After verifying or reusing existing worktrees, the lifecycle management process exports the necessary environment configuration for subsequent parallel development operations.

What limitations should I watch for when using Git worktrees for parallel development?

Git worktrees require careful base-branch selection and safety checks to avoid path conflicts. Always verify and reuse existing worktrees to prevent duplication, and ensure consistent path prefixes in the .worktrees directory for safe parallel task isolation.