worktree-manager-skill

The Worktree Manager skill provides a robust lifecycle management interface for Git worktrees, specifically designed to support high-velocity, parallel development environments. By leveraging Git's worktree functionality, this skill enables developers to work on multiple branches simultaneously within a single repository, without the need to perform frequent context switches or stash uncommitted changes. It is an essential tool for engineers juggling complex feature sets, urgent hotfixes, or parallel integration testing. The skill automates the underlying complexity of managing separate directories, ensuring that each environment remains isolated regarding ports, database configurations, and environment variables.

• Create new, isolated worktrees from specific branches instantly.

• List all currently managed worktrees with status reporting for quick visibility.

• Safely remove or clean up worktrees to reclaim disk space and resources.

• Enforce port uniqueness and prevent environment configuration conflicts.

• Automate standard git worktree lifecycle operations via simple, integrated slash commands.

• Support for custom port-offset configurations to ensure local services do not collide.

• Always use the provided slash commands like /create_worktree, /list_worktrees, and /remove_worktree instead of manual git bash commands.

• The skill validates all operations to ensure directory integrity and configuration consistency.

• Do not attempt to manage worktree processes or database cleanup manually as the tool handles these tasks as part of the remove operation.

• Ensure the repository is in a clean state before executing significant creation tasks.

• Perfect for users who frequently need to run multiple parallel local environments (e.g., frontend and backend development simultaneously) without polluting the main working directory.

• Compatible with standard Git repository structures and CI/CD development flows.