How do I install the Amia Git Worktree Operations skill?

Run npx skillmds@latest add emasoft-ai-maestro-integrator-agent/amia-git-worktree-operations 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 Amia Git Worktree Operations safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Amia Git Worktree Operations?

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 Amia Git Worktree Operations free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Amia Git Worktree Operations?

Emasoft (@emasoft-ai-maestro-integrator-agent) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Amia Git Worktree Operations by emasoft-ai-maestro-integrator-agent

Name: Amia Git Worktree Operations
Rating: 4.2 (5 reviews)
Author: Emasoft

File contents

Git Worktree Operations Skill

Overview

Manage git worktrees for parallel PR processing with isolated branch directories sharing a single repository database.

Prerequisites

Git 2.15+ installed (git --version)
Python 3.9+ for running scripts
Sufficient disk space for multiple worktree directories

Instructions

Verify no other git operations are running
Fetch and create worktree: python scripts/amia_create_worktree.py --pr <number> --base-path /tmp/worktrees
Work ONLY within the worktree directory (absolute isolation)
Commit and push: python scripts/amia_worktree_commit_push.py --worktree-path <path> --message "<msg>"
Remove worktree: python scripts/amia_cleanup_worktree.py --worktree-path <path>

Checklist

Copy this checklist and track your progress:

Verify git version 2.15+ and no concurrent git ops
Create worktree at designated path
All file operations strictly inside worktree only
Verify isolation: python scripts/amia_verify_worktree_isolation.py --worktree-path <path>
Commit and push changes
Verify no uncommitted files remain
Cleanup worktree after PR completion

Output

Output Type	Description
Worktree Directory	Checked-out PR branch at specified path
Worktree List	JSON listing active worktrees with paths and branches
Verification Report	Isolation check status and any boundary violations
Commit/Push Confirmation	Success/failure with commit hash or remote status
Cleanup Report	Removal confirmation with warnings if uncommitted changes exist

Output discipline: All scripts support --output-file <path>.

Reference Documents

See references/ directory for all reference documents.

Error Handling

Script failures return non-zero exit codes. Check stderr for details. See the detailed guide in Resources for common error scenarios.

Examples

Process Three PRs in Parallel

# Create worktrees
python scripts/amia_create_worktree.py --pr 101 --base-path /tmp/worktrees
python scripts/amia_create_worktree.py --pr 102 --base-path /tmp/worktrees
python scripts/amia_create_worktree.py --pr 103 --base-path /tmp/worktrees

# Assign each to a subagent, work in isolation, then cleanup
python scripts/amia_cleanup_worktree.py --worktree-path /tmp/worktrees/pr-101

Resources

See references/ directory — 107 reference documents. Full guide: detailed-guide:

When to Use Worktrees
When NOT to Use Worktrees
Critical Constraints
Decision Tree
Script Usage Examples
Error Handling
- Problem: "fatal: branch is already checked out"
- Problem: "worktree is dirty, cannot remove"
- Problem: Files appearing in main repo after worktree work
- Problem: "fatal: unable to create new worktree"
- Problem: Git operations hanging or failing
Safety Warning: Destructive Operations
- Before Any Destructive Operation
- Safe Worktree Removal Checklist
Emergency Recovery
Quick Reference Card

---name: amia-git-worktree-operationsdescription: Use when processing parallel PRs. Trigger with git worktree or parallel development requests. Loaded by ai-maestro-integrator-agent-main-agent.license: MIT---# Git Worktree Operations Skill## OverviewManage git worktrees for parallel PR processing with isolated branch directories sharing a single repository database.## Prerequisites- Git 2.15+ installed (`git --version`)- Python 3.9+ for running scripts- Sufficient disk space for multiple worktree directories## Instructions1. Verify no other git operations are running2. Fetch and create worktree: `python scripts/amia_create_worktree.py --pr <number> --base-path /tmp/worktrees`3. Work ONLY within the worktree directory (absolute isolation)4. Commit and push: `python scripts/amia_worktree_commit_push.py --worktree-path <path> --message "<msg>"`5. Remove worktree: `python scripts/amia_cleanup_worktree.py --worktree-path <path>`### ChecklistCopy this checklist and track your progress:- [ ] Verify git version 2.15+ and no concurrent git ops- [ ] Create worktree at designated path- [ ] All file operations strictly inside worktree only- [ ] Verify isolation: `python scripts/amia_verify_worktree_isolation.py --worktree-path <path>`- [ ] Commit and push changes- [ ] Verify no uncommitted files remain- [ ] Cleanup worktree after PR completion## Output| Output Type | Description ||-------------|-------------|| Worktree Directory | Checked-out PR branch at specified path || Worktree List | JSON listing active worktrees with paths and branches || Verification Report | Isolation check status and any boundary violations || Commit/Push Confirmation | Success/failure with commit hash or remote status || Cleanup Report | Removal confirmation with warnings if uncommitted changes exist |> **Output discipline:** All scripts support `--output-file <path>`.## Reference DocumentsSee `references/` directory for all reference documents.## Error HandlingScript failures return non-zero exit codes. Check stderr for details. See the detailed guide in Resources for common error scenarios.## Examples### Process Three PRs in Parallel```bash# Create worktreespython scripts/amia_create_worktree.py --pr 101 --base-path /tmp/worktreespython scripts/amia_create_worktree.py --pr 102 --base-path /tmp/worktreespython scripts/amia_create_worktree.py --pr 103 --base-path /tmp/worktrees# Assign each to a subagent, work in isolation, then cleanuppython scripts/amia_cleanup_worktree.py --worktree-path /tmp/worktrees/pr-101```## ResourcesSee `references/` directory — 107 reference documents. Full guide: [detailed-guide](references/detailed-guide.md): - When to Use Worktrees - When NOT to Use Worktrees - Critical Constraints - Decision Tree - Script Usage Examples - Error Handling - Problem: "fatal: branch is already checked out" - Problem: "worktree is dirty, cannot remove" - Problem: Files appearing in main repo after worktree work - Problem: "fatal: unable to create new worktree" - Problem: Git operations hanging or failing - Safety Warning: Destructive Operations - Before Any Destructive Operation - Safe Worktree Removal Checklist - Emergency Recovery - Quick Reference Card

Frequently asked questions

Amia Git Worktree Operations