worktrees:new

Create isolated Git worktrees from a base branch with gitignore configuration.

4|1|Updated Jan 23, 2026
One-click install
npx skills add https://github.com/aaronbassett/aaronbassett-marketplace --skill worktrees-new
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktrees:new
Source: https://github.com/aaronbassett/aaronbassett-marketplace/tree/main/plugins/worktrees/skills/new
Command: npx skills add https://github.com/aaronbassett/aaronbassett-marketplace --skill worktrees-new

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a streamlined method to create isolated Git worktrees and ensure correct gitignore configuration, enabling parallel development without polluting your main workspace.

Core Features & Use Cases

  • Create isolated worktrees for feature development from a base branch.
  • Automatically ensure .worktrees is ignored to prevent nested checkouts.
  • Navigate and manage newly created worktrees with clear, repeatable steps.

Quick Start

Run the command to create a new worktree: /worktrees:new <name> [--base <branch>] [--lock]

Frequently Asked Questions about worktrees:new

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

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

To create a Git worktree for parallel development, you use a command specifying a name and optionally a base branch. This isolates your feature work into a separate directory without polluting your main workspace checkout.

Why does my Git worktree checkout show up in the main repository?

Nested worktree checkouts appear if the directory is not ignored. This skill automatically validates and ensures the .worktrees path is properly added to your gitignore configuration to prevent repository pollution.

Can I create a Git worktree from a specific base branch?

Yes, you can create a worktree from a specific base branch by using the --base argument. This allows you to start your parallel development from any existing branch rather than the default repository branch.

How do I lock a newly created Git worktree?

You can lock a newly created Git worktree by passing the --lock argument during creation. This prevents the worktree from being accidentally pruned or modified while you are actively working in it.

What is the best way to manage multiple parallel development branches without conflicts?

Using isolated Git worktrees is the best way to manage parallel development branches. This approach creates separate directory workspaces for each branch, keeping your main checkout clean and preventing file conflicts.