Create Worktree Skill

What it does

This skill allows an AI agent to create Git worktrees. Worktrees provide a way to check out multiple versions of a repository simultaneously, enabling parallel development or experimentation without interfering with the main working copy. The skill handles the creation and management of these isolated workspaces within a single Git repository.

When to use it

• Branching experiments: Quickly create a worktree for testing a new feature branch without affecting your primary codebase.
• Parallel development: Maintain separate worktrees for different developers working on distinct parts of the same project.
• Reproducing builds: Create a clean worktree to reproduce specific build environments or historical commits.
• Code reviews: Set up a dedicated worktree for reviewing changes without modifying your main working copy.

Key capabilities

• Creates new Git worktrees.
• Manages existing worktrees (e.g., switching between them).
• Handles cleanup of worktrees when they are no longer needed.

Example prompts

• "Create a worktree named 'feature-x' based on the 'develop' branch."
• "Switch to the worktree called 'bugfix-123'."
• "Delete the worktree 'experimental-branch'."

Tips & gotchas

• Requires Git to be installed and accessible in the environment.
• Worktrees share history with the main repository, so large repositories can consume significant disk space when multiple worktrees are active.