_worktree-create

Create Git worktrees with pre-creation checks and metadata recording.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Piece-Puzzly/Piece-iOS --skill worktree-create-piece-puzzly
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: _worktree-create
Source: https://github.com/Piece-Puzzly/Piece-iOS/tree/main/.claude/skills/_worktree-create
Command: npx skills add https://github.com/Piece-Puzzly/Piece-iOS --skill worktree-create-piece-puzzly

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the creation of new Git worktrees, simplifying the process of managing multiple branches for development or feature work.

Core Features & Use Cases

  • Automated Worktree Setup: Creates new Git worktrees based on specified branch names and base branches.
  • .gitignore Management: Ensures the .worktree/ directory is correctly ignored by Git.
  • Use Case: When starting a new feature, you can use this Skill to quickly set up a dedicated worktree for that feature branch, keeping your main development environment clean.

Quick Start

Create a new worktree for the branch named 'feature/new-login-flow' using the develop branch as the base.

Frequently Asked Questions about _worktree-create

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

FAQPage Schema
How do I automate Git worktree creation for new feature branches?

To automate Git worktree creation, this Skill handles pre-creation checks for repository status and branch existence, then creates the worktree and records metadata. It streamlines setting up dedicated development branches based on a specified base branch.

What is a Git worktree and when do I need it for my development workflow?

A Git worktree allows you to manage multiple development branches within a single repository without switching contexts. You need it when starting a new feature to keep your main development environment clean while working on isolated branch changes.

How do I set up a new Git worktree from a specific base branch?

Setting up a new Git worktree involves specifying the target branch name and the base branch. This Skill fetches the latest base branch, updates `.gitignore` to ignore the `.worktree/` directory, creates the worktree, and executes project-specific setup hooks.

Does Git worktree creation handle `.gitignore` updates automatically?

Yes, Git worktree creation handles `.gitignore` updates automatically by ensuring the `.worktree/` directory is correctly ignored. This prevents your worktree directories from being tracked by Git and avoids potential repository pollution.

Can I execute project-specific setup hooks after creating a Git worktree?

Yes, you can execute project-specific setup hooks after creating a Git worktree. Once the worktree is created and metadata is recorded, the Skill supports running custom hooks to prepare your development environment automatically.

What are the limitations of using Git worktrees for branch management?

Limitations of using Git worktrees include requiring a valid Git repository status before creation and checking if the target branch already exists. The Skill will halt if pre-creation checks fail, preventing duplicate worktrees or incorrect repository states.