How do I install the AI Util Git Worktree skill?

Run npx skillmds@latest add aws-samples/ai-util-git-worktree in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is AI Util Git Worktree safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with AI Util Git Worktree?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is AI Util Git Worktree free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published AI Util Git Worktree?

aws-samples (@aws-samples) published this skill. Their other Agent Skills are listed on their SkillMD profile.

AI Util Git Worktree by aws-samples

Name: AI Util Git Worktree
Author: aws-samples

AI Util Git Worktree

Manage git worktrees for parallel feature work. Invoke ONLY via the /ai-util-git-worktree slash command. Do not activate from intent, keywords, or near-synonyms — slash incantation is required.

aws-samples 860585e 2 files · 10.7 KB Updated Sep 17, 2026

File contents

/ai-util-git-worktree — Git Worktree Manager

Manage git worktrees for parallel feature work using a Python script bundled with this skill.

Script Location

The worktree script lives at ~/.claude/skills/ai-util-git-worktree/worktree.py (global install). All commands below invoke it via python3.

WORKTREE_SCRIPT="$HOME/.claude/skills/ai-util-git-worktree/worktree.py"

This skill works in any git repository. The script auto-detects the repo root via git rev-parse and places worktrees in .worktrees/ at the repo root.

Commands

Parse the user's arguments and run the appropriate command:

`/ai-util-git-worktree new <branch-name> [--base <branch>]`

python3 "$WORKTREE_SCRIPT" new <branch-name> --base <branch>

branch-name: Used exactly as-is for both the git branch and the .worktrees/ directory name.
--base: Base branch to create from. Defaults to develop.

After creation, use AskUserQuestion to ask if they want to switch to the new worktree. Options:

"Switch to it" — cd to the worktree path in Bash and continue working from there. Use absolute paths for all subsequent Read/Edit/Write tool calls since the session's primary working directory does not change.
"Stay here" — Print the path and suggest cd <path> && claude for manual switching later.

`/ai-util-git-worktree list`

python3 "$WORKTREE_SCRIPT" list

Shows all worktrees in .worktrees/ with branch name and dirty status.

`/ai-util-git-worktree remove <name> [--force] [--keep-branch] [--delete-branch]`

python3 "$WORKTREE_SCRIPT" remove <name> [--force] [--keep-branch] [--delete-branch]

Removes the worktree. Prompts about uncommitted changes unless --force. Asks about branch deletion unless --keep-branch or --delete-branch is specified.

Important: If the script prompts for interactive input (uncommitted changes confirmation or branch deletion), use --force and --delete-branch (or --keep-branch) flags instead — Claude Code cannot respond to interactive prompts. Ask the user what they want before running the command.

`/ai-util-git-worktree clean`

python3 "$WORKTREE_SCRIPT" clean

Prunes stale git worktree references and reports orphaned directories.

---name: ai-util-git-worktreedescription: Manage git worktrees for parallel feature work. Invoke ONLY via the /ai-util-git-worktree slash command. Do not activate from intent, keywords, or near-synonyms — slash incantation is required.---# /ai-util-git-worktree — Git Worktree ManagerManage git worktrees for parallel feature work using a Python script bundled with this skill.## Script LocationThe worktree script lives at `~/.claude/skills/ai-util-git-worktree/worktree.py` (global install). All commands below invoke it via `python3`.```bashWORKTREE_SCRIPT="$HOME/.claude/skills/ai-util-git-worktree/worktree.py"```This skill works in any git repository. The script auto-detects the repo root via `git rev-parse` and places worktrees in `.worktrees/` at the repo root.## CommandsParse the user's arguments and run the appropriate command:### `/ai-util-git-worktree new <branch-name> [--base <branch>]````bashpython3 "$WORKTREE_SCRIPT" new <branch-name> --base <branch>```- `branch-name`: Used exactly as-is for both the git branch and the `.worktrees/` directory name.- `--base`: Base branch to create from. Defaults to `develop`.After creation, use `AskUserQuestion` to ask if they want to switch to the new worktree. Options:1. **"Switch to it"** — `cd` to the worktree path in Bash and continue working from there. Use absolute paths for all subsequent `Read`/`Edit`/`Write` tool calls since the session's primary working directory does not change.2. **"Stay here"** — Print the path and suggest `cd <path> && claude` for manual switching later.### `/ai-util-git-worktree list````bashpython3 "$WORKTREE_SCRIPT" list```Shows all worktrees in `.worktrees/` with branch name and dirty status.### `/ai-util-git-worktree remove <name> [--force] [--keep-branch] [--delete-branch]````bashpython3 "$WORKTREE_SCRIPT" remove <name> [--force] [--keep-branch] [--delete-branch]```Removes the worktree. Prompts about uncommitted changes unless `--force`. Asks about branch deletion unless `--keep-branch` or `--delete-branch` is specified.**Important:** If the script prompts for interactive input (uncommitted changes confirmation or branch deletion), use `--force` and `--delete-branch` (or `--keep-branch`) flags instead — Claude Code cannot respond to interactive prompts. Ask the user what they want before running the command.### `/ai-util-git-worktree clean````bashpython3 "$WORKTREE_SCRIPT" clean```Prunes stale git worktree references and reports orphaned directories.

Frequently asked questions