using-git-worktrees

Create and manage deterministic git worktrees with safety verification and automated setup.

Updated Sep 28, 2021
One-click install
npx skills add https://github.com/hhk7734/hhk7734 --skill using-git-worktrees-hhk7734
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/hhk7734/hhk7734/tree/main/skills/using-git-worktrees
Command: npx skills add https://github.com/hhk7734/hhk7734 --skill using-git-worktrees-hhk7734

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Isolate feature work by creating dedicated git worktrees and applying safety verification to prevent accidental commits of worktree contents.

Core Features & Use Cases

  • Directory-aware worktree creation with a clear priority rule (project-local first, then global), ensuring isolation without cluttering the main workspace.
  • Rigorous safety verification to confirm worktree directories are ignored by git and won't pollute the repository.
  • Automatic project setup after worktree creation, including toolchain installation and build steps, plus a post-creation test baseline.

Quick Start

Create an isolated git worktree for the current project on a new feature branch and run the appropriate project setup.

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 work?

To create an isolated git worktree, the Skill automates directory selection, applies project-name detection, and establishes a new feature branch. It ensures isolation by prioritizing project-local directories to prevent cluttering your main workspace.

Why do I need to verify ignore rules before setting up a git worktree?

Verifying ignore rules before setting up a git worktree prevents accidental commits of worktree contents into the main repository. The Skill performs rigorous safety checks to confirm the worktree directory is properly ignored by git.

What is the best way to automate project setup after creating a git worktree?

The best way to automate project setup after creating a git worktree is to use a Skill that handles toolchain installation and build steps automatically. This Skill also runs a post-creation test baseline to verify the environment is correctly configured.

Can I apply CLAUDE.md preferences when managing git worktrees?

Yes, you can apply CLAUDE.md preferences when managing git worktrees. The Skill integrates these preferences during the worktree creation and automated setup process to ensure the isolated workspace aligns with your project configuration.

Does git worktree isolation work without cluttering the main workspace directory?

Git worktree isolation works without cluttering the main workspace by following a clear directory priority rule. The Skill selects project-local directories first, then global ones, ensuring feature work remains safely separated from your primary repository.