speckit-worktree-create

Create isolated git worktrees for feature branches in local repositories.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/datamonsterr/mycoai_projects --skill speckit-worktree-create
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-worktree-create
Source: https://github.com/datamonsterr/mycoai_projects/tree/main/.agents/skills/speckit-worktree-create
Command: npx skills add https://github.com/datamonsterr/mycoai_projects --skill speckit-worktree-create

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Spawn an isolated git worktree for a feature branch so you can work on multiple features in parallel without switching branches. Each worktree gets its own directory with a full working copy.

Core Features & Use Cases

  • Create a dedicated worktree for a specified branch or for the current branch.
  • Automatically create and manage the .worktrees/ directory, updating .gitignore and avoiding duplicates.
  • Validate the target branch exists and ensure the worktree provides access to spec artifacts.

Quick Start

Provide the target branch name or say 'current' to create a worktree for the current branch.

Frequently Asked Questions about speckit-worktree-create

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

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

To create an isolated git worktree, specify a target branch name and the tool generates a separate working directory with a full copy of the repository, allowing parallel development without switching branches.

Why use git worktrees for parallel feature development instead of switching branches?

Git worktrees provide isolated working directories for each feature branch, preventing context switching overhead and allowing you to run multiple feature streams simultaneously without stashing uncommitted changes.

Do I need a specific repository structure to spawn a git worktree?

Yes, spawning a git worktree requires a valid local git repository with a .specify directory. The tool automatically creates a .worktrees directory if missing and updates .gitignore to manage it.

Can I create a worktree for my current git branch?

Yes, you can create a worktree for the current git branch by specifying 'current' as the target, which generates an isolated working directory for your active development stream.

What happens if I try to create a duplicate git worktree for an existing branch?

The worktree creation process prevents duplicate worktrees for existing branches, ensuring each feature branch maps to a single isolated working directory and avoiding filesystem conflicts.

What are the limitations of managing feature branches with git worktrees?

Git worktree management requires Git installed locally and operates on repositories containing a .specify directory, meaning it does not support bare repositories or remote-only workflows lacking these local artifacts.