using-git-worktrees

Create isolated Git worktrees with directory selection and safety verification.

1|Updated Feb 11, 2026
One-click install
npx skills add https://github.com/dwalleck/kiro-starter-kit --skill using-git-worktrees-dwalleck
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/dwalleck/kiro-starter-kit/tree/main/.kiro/skills/using-git-worktrees
Command: npx skills add https://github.com/dwalleck/kiro-starter-kit --skill using-git-worktrees-dwalleck

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the challenge of managing multiple development streams concurrently by creating isolated Git worktrees, preventing conflicts and ensuring a clean development environment.

Core Features & Use Cases

  • Isolated Workspaces: Create separate directories for different branches, allowing simultaneous work without context switching.
  • Smart Directory Selection: Prioritizes .worktrees/ and worktrees/ directories, checks AGENTS.md for preferences, and prompts the user when necessary.
  • Safety Verification: Ensures project-local worktree directories are ignored by Git before creation to prevent accidental commits.
  • Automated Project Setup: Detects and runs package installation commands (npm, cargo, pip, poetry, go mod) based on project files.
  • Baseline Test Verification: Runs project tests after setup to confirm a clean starting state.

Quick Start

Use the using-git-worktrees skill to set up an isolated workspace for the new feature branch.

Frequently Asked Questions about using-git-worktrees

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

FAQPage Schema
How do I create isolated Git worktrees for concurrent feature development?

To create isolated Git worktrees, the Skill systematically selects directories like `.worktrees/`, verifies `.gitignore` compliance to prevent accidental commits, and sets up the project automatically.

What is the best way to manage multiple development streams without context switching?

Managing multiple development streams safely involves creating separate Git worktree directories for different branches, allowing simultaneous work and preventing conflicts in your main project environment.

How does automated project setup work for new Git worktrees?

Automated project setup for Git worktrees detects package files and runs installation commands for npm, cargo, pip, poetry, or go mod, followed by running baseline tests to confirm a clean state.

Do I need to configure .gitignore before creating project-local worktrees?

Yes, you need `.gitignore` configured correctly. The Skill enforces safety verification to ensure project-local worktree directories are ignored by Git before creation, preventing accidental commits.

How does directory selection work when setting up isolated Git workspaces?

Directory selection for isolated Git workspaces prioritizes `.worktrees/` and `worktrees/` locations, checks `AGENTS.md` for project preferences, and prompts the user only when necessary.

Can I run baseline tests automatically after setting up a Git worktree?

Yes, you can run baseline tests automatically. After detecting and executing package installation, the Skill runs project tests to verify a clean starting state in the new Git worktree.