using-git-worktrees

Create isolated Git worktrees with directory selection and safety checks.

2|3|Updated Nov 24, 2020
One-click install
npx skills add https://github.com/loganlinn/dotfiles --skill using-git-worktrees-loganlinn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/loganlinn/dotfiles/tree/main/config/claude/skills/using-git-worktrees
Command: npx skills add https://github.com/loganlinn/dotfiles --skill using-git-worktrees-loganlinn

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the process of creating isolated development environments using Git worktrees, ensuring a clean and organized workflow for feature development.

Core Features & Use Cases

  • Isolated Workspaces: Work on multiple branches simultaneously without context switching.
  • Smart Directory Selection: Automatically determines the best location for new worktrees based on project conventions and user preferences.
  • Safety Verification: Ensures project-local directories are ignored by Git before creation to prevent accidental commits.
  • Automated Setup: Detects and runs project-specific setup commands (e.g., npm install, cargo build).
  • Baseline Testing: Verifies a clean development state by running project tests.
  • Use Case: Before starting a new feature, use this skill to create a dedicated, isolated worktree, ensuring your main branch remains untouched and stable.

Quick Start

Use the using-git-worktrees skill to create a new worktree for the 'new-feature' branch in the '.worktrees' directory.

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 an isolated git worktree for feature development?

To create an isolated git worktree, this skill automates systematic directory selection and safety verification, placing your new branch in a dedicated workspace while keeping your main branch untouched and stable.

What is the best way to manage multiple git branches without context switching?

Using git worktrees is the best way to manage multiple branches, allowing you to work on different features simultaneously in separate directories without stashing changes or switching contexts in a single repository.

How does git worktree creation handle project setup and dependencies?

Git worktree creation automates project setup by detecting and running project-specific commands like npm install or cargo build, then performs baseline testing to verify a clean development state before you start coding.

Do I need to manually configure .gitignore before creating a worktree?

No, you do not need to manually configure .gitignore. The worktree creation process enforces safety verification checks to ensure project-local directories are ignored by Git, preventing accidental commits of worktree files.

Can git worktrees be stored globally or only in project-local directories?

Git worktrees can be stored in both project-local and global locations. This skill manages smart directory selection automatically, determining the best placement based on your project conventions and preferences.

What should I do after finishing development in an isolated git worktree?

After finishing development in an isolated git worktree, you can integrate with the finishing-a-development-branch skill to merge your work, or use the brainstorming skill to plan your next isolated feature.