using-git-worktrees

Create isolated git worktrees with directory selection and baseline verification.

2|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/kscius/KS-Cursor-Orchestrator --skill using-git-worktrees-kscius
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/kscius/KS-Cursor-Orchestrator/tree/main/skills/using-git-worktrees
Command: npx skills add https://github.com/kscius/KS-Cursor-Orchestrator --skill using-git-worktrees-kscius

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Starting feature work in a shared workspace often risks contamination of the main branch. This skill creates isolated git worktrees with smart directory selection and safety verification to keep development isolated and reproducible.

Core Features & Use Cases

  • Isolated workspaces via git worktrees to separate feature development from the main workspace.
  • Smart directory selection with priority rules and fallbacks to known project locations.
  • Safety verification steps including ignored-directory checks and cleanup readiness reporting.
  • Integration points with design-to-implementation workflows to streamline feature delivery.

Quick Start

Create an isolated git worktree for the new feature branch, verify the directory is ignored if necessary, and confirm a clean baseline before proceeding.

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 feature development from my main git workspace?

To isolate feature development, you create a git worktree. This sets up an isolated working directory linked to your repository, preventing contamination of your main branch while keeping development reproducible.

What is the best way to set up a git worktree for a new feature branch?

The best way to set up a git worktree is using smart directory selection with priority rules and fallbacks. This automatically creates an isolated workspace, verifies ignored-directory checks, and confirms a clean baseline before you proceed.

How does a git worktree handle directory selection in multi-project repos?

Git worktree directory selection in multi-project repos uses smart priority rules and fallbacks to known project locations. This ensures the new worktree is placed correctly while handling directory discovery and ignore checks automatically.

Can I use a git worktree to verify a clean test baseline before implementing plans?

Yes, you can use a git worktree to verify a clean test baseline. The setup process includes baseline verification and cleanup readiness reporting, ensuring your isolated workspace is fully validated before feature implementation.

What are the limitations of using git worktrees for isolated development?

Git worktree limitations include the need to manage directory discovery and verify .gitignore rules carefully. If ignored-directory checks fail or cleanup readiness is not reported, you risk workspace contamination or orphaned worktrees.