What problem does it solve? Keeping multiple git repositories and linked worktrees in sync is error-prone: uncommitted changes get lost, stale feature branches become integration bases, and careless deletions or force-pushes destroy remote content. This Skill automates safe synchronization while requiring explicit human approval for deletions, discards, and gitignore changes. ## Core Features & Use Cases - Safe commit and push pipeline: Byte-vets uncommitted changes, non-force-pushes local commits, and fast-forwards or cleanly merges fetched remote commits after anchor, isolated-index, and readback checks. - Multi-target discovery: Syncs the main worktree and current session worktree by default, or explicit targets via repo:, worktree:, branch:, all-worktrees:, and all-repos: selectors. - Conflict proofing: Uses git merge-tree to prove whether divergent trees already converge, recording Sync-deletion-accepted trailers on integration commits. - Mandatory human gates: Tracked-file deletions require --allow-deletions after approval; discard and .gitignore recommendations always stop for explicit user confirmation. - Use Case: Before ending a work session spread across three worktrees, run the sync command to commit safe changes, reconcile each branch with fetched trunk, and surface any divergent edits or deletions for your review. ## Quick Start Ask the agent to run the sync-git sync command to assess and safely synchronize the current repository and session worktree, reviewing any deletion or conflict checkpoints it raises.
