worktree-start-feature

Create and manage isolated git worktrees for feature branches.

13|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/phenobarbital/antigravity-config --skill worktree-start-feature
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktree-start-feature
Source: https://github.com/phenobarbital/antigravity-config/tree/main/backend/.agent/skills/worktree-start-feature
Command: npx skills add https://github.com/phenobarbital/antigravity-config --skill worktree-start-feature

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of safely implementing features by isolating work in a dedicated git worktree and branch, so the main directory remains stable while development proceeds.

Core Features & Use Cases

  • Preflight checks verify repository status and identify the base branch (prefer main, fallback to master).
  • Create a dedicated worktree at .worktrees/<slug> and a new feature branch from the base reference.
  • Record the active worktree in .worktrees/_active.json with branch, base, and path.
  • Execute all feature work inside the worktree using git -C <path> for deterministic, isolated changes.
  • Finish with a clean state and present a summary, plus the option to open a PR after user approval.

Quick Start

Initialize a new feature by creating a worktree-based environment from the main branch and perform all work inside that workspace.

Frequently Asked Questions about worktree-start-feature

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

FAQPage Schema
How do I isolate feature development from my main branch using a git worktree?

To isolate feature development using a git worktree, the Skill creates a dedicated worktree at .worktrees/<slug> and a new feature branch from your base reference. This ensures all changes remain separate from the primary workspace.

What is the best way to manage multiple git branches without affecting my main directory?

Managing multiple git branches without affecting the main directory is achieved by creating separate worktrees for each feature. The Skill records each active worktree in .worktrees/_active.json, tracking branch, base, and path for deterministic execution.

How do I set up a git worktree workflow for isolated experiments?

Setting up a git worktree workflow for isolated experiments starts with preflight checks that verify repository status and identify the base branch, preferring main and falling back to master. It then creates a dedicated workspace and feature branch.

Can I execute git commands inside a worktree without switching directories?

Yes, you can execute git commands inside a worktree without manual directory switching. The Skill performs all feature work inside the worktree using git -C <path>, ensuring deterministic, isolated changes with proper commit discipline.

How do I finish work in a git worktree and prepare it for a pull request?

To finish work in a git worktree and prepare for a pull request, the Skill ensures a clean state and presents a summary. After user approval, it provides the option to open a PR directly from the isolated feature branch.

Does this worktree workflow require any specific git branch naming conventions?

The worktree workflow enforces branch naming conventions and worktree path conventions automatically. Preflight checks verify repository status before creating the feature branch from the base reference, ensuring consistent isolation practices.