using-worktrees

Create isolated Git worktrees with environment setup and baseline tests.

Updated Jan 23, 2026
One-click install
npx skills add https://github.com/joshsymonds/gambit --skill using-worktrees-joshsymonds
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-worktrees
Source: https://github.com/joshsymonds/gambit/tree/main/skills/using-worktrees
Command: npx skills add https://github.com/joshsymonds/gambit --skill using-worktrees-joshsymonds

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill creates isolated Git worktrees, preventing conflicts and ensuring a clean, reproducible development environment for new features or tasks.

Core Features & Use Cases

  • Safe Isolation: Work on features without affecting your main branch or other ongoing tasks.
  • Environment Setup: Automatically detects and sets up project environments (e.g., Node.js, Devenv).
  • Baseline Verification: Ensures tests pass in the new worktree before you start coding.
  • Use Case: You need to start a new, complex feature that might take days. Use this Skill to create a dedicated, clean workspace for it, complete with its own isolated environment and a verified baseline of passing tests.

Quick Start

Use the using-worktrees skill to create a new worktree for the 'feature/user-auth' branch.

Frequently Asked Questions about using-worktrees

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

FAQPage Schema
How do I create an isolated git worktree for feature development?

To create an isolated git worktree, this Skill manages directory discovery, gitignore verification, and environment setup to ensure a clean, reproducible workspace for your new branch without affecting your main codebase.

What is the best way to keep my devenv database isolated when testing a new feature branch?

Isolating your devenv database during feature development is handled automatically by configuring a specific database strategy during the worktree environment setup, preventing data conflicts across concurrent branches.

Can I verify that baseline tests pass before I start coding in a new git worktree?

Yes, this Skill executes baseline test verification immediately after setting up the isolated git worktree, ensuring your development environment is clean and your tests pass before you begin writing feature code.

Does this worktree setup support Node.js and devenv project environments?

Yes, the worktree setup automatically detects and supports multiple project types including Node.js and devenv, configuring the isolated development environment dynamically based on your project's specific requirements.

Why should I use git worktrees instead of cloning a repository for parallel feature development?

Git worktrees provide safe feature isolation by sharing a single repository history, avoiding the disk space overhead and sync complexity of full clones while maintaining a clean, reproducible environment for each task.