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.