using-git-worktrees

Create isolated Git worktrees with automated setup and baseline testing.

1|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/Kuass/kiro-gateway-plus --skill using-git-worktrees-kuass
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/Kuass/kiro-gateway-plus/tree/main/.opencode/skill/using-git-worktrees
Command: npx skills add https://github.com/Kuass/kiro-gateway-plus --skill using-git-worktrees-kuass

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a systematic and safe way to create isolated Git worktrees for new feature development, preventing conflicts and ensuring a clean starting point.

Core Features & Use Cases

  • Isolated Workspaces: Work on multiple branches simultaneously without context switching.
  • Smart Directory Selection: Prioritizes project-local hidden directories, then global locations, or prompts the user.
  • Safety Verification: Automatically checks and enforces .gitignore rules for project-local worktrees to prevent accidental commits.
  • Automated Setup: Detects and runs project-specific setup commands (npm, cargo, pip, poetry, go).
  • Baseline Testing: Verifies a clean state by running project tests after setup.
  • Use Case: Before starting a new feature like "user authentication," use this skill to create a dedicated, isolated worktree, ensuring your main branch remains untouched and your development environment is correctly set up.

Quick Start

Use the using-git-worktrees skill to create a new worktree for the 'feature/user-profile' 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 feature development?

Creating isolated Git worktrees involves automating directory selection and verifying safety rules. This process sets up a clean workspace, runs project-specific installations, and executes baseline tests to ensure a properly configured environment.

What is the best way to work on multiple Git branches without context switching?

Git worktrees provide isolated workspaces for working on multiple branches simultaneously without context switching. By creating separate directories for each branch, you can maintain distinct development environments without stashing or committing incomplete work.

Does Git worktree setup support Node.js, Rust, Python, and Go projects?

Git worktree setup supports Node.js, Rust, Python, and Go projects by automatically detecting and running project-specific setup commands like npm, cargo, pip, poetry, and go to configure the isolated environment.

How are .gitignore rules enforced when creating project-local Git worktrees?

Creating project-local Git worktrees enforces .gitignore rules through automated safety verification. This checks and applies ignore configurations to prevent accidental commits of worktree directories into the main repository.

How do I verify a clean state after setting up a new Git worktree?

Verifying a clean state after Git worktree setup involves running baseline testing. The system automatically executes project tests post-setup to confirm the isolated environment is correctly configured and functional.