| name | Sync Multi-Repo State |
| description | Detects drift between multiple git repositories (e.g. forks, mirrors, or multi-module projects). Generates a drift report and optionally applies sync actions. |
| version | 1.0.0 |
| author | Antigravity Skills Library |
| created | "2026-01-15T00:00:00.000Z" |
| leverage_score | 4/5 |
SKILL-003: Sync Multi-Repo State
Overview
When working with split repositories (e.g., Scrutor and Scrutor Test having copies of execution-specs), state drift is a major risk. This skill analyzes multiple repos to report on ahead/behind commits, uncommitted changes, and branch divergence.
Trigger Phrases
sync reposcheck repo driftcompare reposmulti-repo status
Inputs
| Parameter | Type | Required | Default | Description |
|---|
--repos | string[] | No | Auto-detect | List of repo paths to compare |
--reference | string | No | First repo | The "source of truth" repo path |
--apply | switch | No | False | Unsafe: Attempt to fast-forward/merge |
Outputs
- Console Report: Matrix of repo status.
- Markdown Report:
REPO_SYNC_REPORT.md.
Preconditions
- All targets must be valid git repositories.
Safety/QA Checks
- Read-Only Default: By default, only reports status.
- Safety Check:
--apply requires clean status in target repos.
- Backup:
--apply creates backup branch before merging.
Implementation
See sync_repos.ps1.
Integration
.\skills\03_sync_repos\sync_repos.ps1 -Repos "C:\projects\Scrutor\execution-specs", "C:\projects\Scrutor Test\execution-specs"
