skills.rest
jmerkow
jmerkowCOMMUNITY
Explore all skills by this author →
GitHub

worktree-setup

Create isolated git worktrees with symlinks and project configurations for agent work.

2|Updated Jun 15, 2026
Search Tags:#git#worktree#workspace setup#Copilot#isolated branch#shared engineering state
One-click install
npx skills add https://github.com/jmerkow/my-agentic-stuff --skill worktree-setup-jmerkow
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: worktree-setup
Source: https://github.com/jmerkow/my-agentic-stuff/tree/main/plugins/eng-ops/skills/worktree-setup
Command: npx skills add https://github.com/jmerkow/my-agentic-stuff --skill worktree-setup-jmerkow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill provides a structured approach to setting up a git worktree as an isolated workspace for Copilot agent work, ensuring that changes are contained and shared engineering state is managed effectively.

Core Features & Use Cases

  • Isolated Workspaces: Ensures that agent work is isolated from the main checkout, maintaining a clean environment for development.
  • Shared Engineering State: Manages the .eng/ symlink for accessing shared engineering state, facilitating teamwork.
  • External Repos and Files: Links sibling repos and project-local files directly within the worktree for efficient access.
  • Quick Setup: Streamlines the creation of worktrees, symlinks, and project configurations.

Quick Start

Set up a worktree for Copilot agent work by running: git worktree add <worktree-path> -b <branch-name> <base-branch>

Frequently Asked Questions about worktree-setup

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

FAQPage Schema
How do I set up an isolated git workspace for Copilot agent work?▼

To set up an isolated git workspace for Copilot agent work, create a git worktree using `git worktree add <path> -b <branch> <base>`. This isolates agent changes from your main checkout while maintaining shared engineering state.

What is a git worktree and when do I need isolated workspaces?▼

A git worktree is an isolated checkout linked to a single repository, allowing simultaneous work on multiple branches. You need isolated workspaces when running Copilot agents to contain changes and keep your main development environment clean.

Does git worktree setup support linking external repos and project files?▼

Yes, git worktree setup supports linking external repos and project-local files. It automatically creates symlinks for sibling repositories and manages the `.eng/` symlink to access shared engineering state efficiently within the isolated workspace.

How do I manage shared engineering state across isolated git worktrees?▼

You manage shared engineering state across isolated git worktrees using a `.eng/` symlink. This setup ensures team collaboration data and configurations are accessible directly within each isolated workspace without duplicating files.

Can I use git worktrees for team collaboration and agent development?▼

Yes, you can use git worktrees for team collaboration and agent development. The setup supports administrative workflows by isolating agent changes while managing shared engineering state, ensuring clean environments for collaborative development.

Related Skills

Explore More Software Engineering Skills→
good-ideagood-idea
3

using-git-worktrees

Create Git worktrees for isolated feature development and cleanup optionally deleting branches.

Community
Intermediate
cryborg1211cryborg1211

vc:merge-worktree

Merge a git worktree branch into the main checkout and prune it.

Community
Intermediate
withpiperwithpiper
6

branch

Create worktree-based feature, fix, or hotfix branches with Linear integration.

Official
Advanced
homeassistant-aihomeassistant-ai
4.3k

wt

Create a git worktree under worktree/<branch> and update submodules.

Official
Intermediate