guild-worktrees

Create an isolated git worktree for a feature branch.

6|Updated Apr 24, 2026
One-click install
npx skills add https://github.com/lookatitude/guild --skill guild-worktrees
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: guild-worktrees
Source: https://github.com/lookatitude/guild/tree/main/skills/fallback/worktrees
Command: npx skills add https://github.com/lookatitude/guild --skill guild-worktrees

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sets up isolated git worktrees for feature work, preventing changes from affecting the current checkout and enabling safe experimentation.

Core Features & Use Cases

  • Directory selection and safety verification: checks for existing directories, CLAUDE.md preferences, and falls back to user prompts.
  • Automatic worktree creation and project setup: creates the worktree, checks out a new branch, and runs project setup commands.
  • Guardrails and Guild integration: integrates with the guild workflow to ensure clean lanes and predictable rollbacks.

Quick Start

Ask Guild to set up an isolated workspace for a new feature branch.

Frequently Asked Questions about guild-worktrees

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

FAQPage Schema
How do I isolate feature branch work from my main git checkout?

To isolate feature branch work from your main git checkout, you can set up an isolated git worktree. This creates a separate directory for your branch, preventing changes from polluting the main checkout and enabling safe experimentation.

What is the safest way to automate git worktree creation for new branches?

Automating git worktree creation safely involves verifying directory availability and checking preferences before checkout. The process creates the worktree, validates ignores, runs optional setup steps, and reports readiness to ensure predictable rollbacks.

Can I run project setup commands automatically when creating a git worktree?

Yes, you can run project setup commands automatically when creating a git worktree. After checking out a new branch in the isolated worktree, the workflow runs optional setup steps to prepare your project environment.

How do git worktrees help with safe experimentation in software engineering?

Git worktrees help with safe experimentation by keeping changes in a separate directory from your main checkout. This isolation prevents work on a new feature branch from affecting your primary project state.

Does automating git worktrees work with existing project directories?

Automating git worktrees checks for existing directories before creation. It validates safety by looking for preferences and falls back to user prompts to ensure the worktree setup does not overwrite existing project data.

What are the limitations of using an isolated git worktree for feature work?

Using an isolated git worktree requires integration with a workflow system to ensure clean lanes and predictable rollbacks. You must manage safety verification and directory selection to avoid conflicts with your main project checkout.