worktree-manager

Create git worktrees with kebab-case branch names from descriptions.

62|10|Updated Dec 4, 2025
One-click install
npx skills add https://github.com/terrylica/cc-skills --skill worktree-manager-terrylica
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktree-manager
Source: https://github.com/terrylica/cc-skills/tree/main/plugins/alpha-forge-worktree/skills/worktree-manager
Command: npx skills add https://github.com/terrylica/cc-skills --skill worktree-manager-terrylica

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, and includes scripts (resource) and references (resource) components.

What problem does it solve?

It automates the creation and management of alpha-forge git worktrees, generating descriptive, reproducible branch names and ensuring safe, atomic operations.

Core Features & Use Cases

  • New Branch Worktrees: Create a new branch and worktree atomically from a description.
  • Remote Tracking: Create worktrees that track remote branches with sensible defaults.
  • Local Branch Worktrees: Attach worktrees to existing local branches cleanly.

Quick Start

Use create-worktree.sh to create a new worktree with a derived slug from your feature description, then open the worktree in your IDE.

Frequently Asked Questions about worktree-manager

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

FAQPage Schema
How do I automatically create git worktrees with descriptive branch names?

Git worktrees with automatic branch naming are created by running create-worktree.sh with a feature description, which derives a kebab-case slug and atomically creates the branch and worktree in one operation, eliminating manual naming and reducing setup steps.

Can I create worktrees that track remote branches in git?

Yes, worktree-manager creates worktrees that track remote branches with sensible defaults, automatically handling remote validation and branch attachment without manual configuration.

How do I attach a worktree to an existing local branch?

Worktree-manager attaches worktrees to existing local branches cleanly through its local-branch reuse feature, which validates the branch and creates the worktree without recreating the branch or duplicating work.

What naming conventions does automatic branch creation follow?

Worktree-manager generates branch names in kebab-case with word-economy rules applied to your feature description, ensuring reproducible, descriptive names that follow alpha-forge workflow conventions and tab/path reporting standards.

What git operations does worktree-manager validate before creating?

The Skill validates main branch presence, checks remote and base branch status, and performs atomic operations to ensure safe worktree creation without partial failures or inconsistent state.

Does worktree-manager work with existing git workflows?

Yes, worktree-manager integrates with alpha-forge workflows and standard git operations. It requires only git as a dependency and works across new branch creation, remote-tracking, and local-branch reuse scenarios.