# Sync Multi-Repo State

> Detects drift between multiple git repositories (e.g. forks, mirrors, or multi-module projects). Generates a drift report and optionally applies sync actions.

- Skill: `sounder25/sync-multi-repo-state` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add sounder25/sync-multi-repo-state`
- Raw SKILL.md: https://api.skillmd.com/api/skills/sounder25/sync-multi-repo-state/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: Sounder25 (https://skillmd.com/u/sounder25)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/sounder25/sync-multi-repo-state

---


# 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 repos`
- `check repo drift`
- `compare repos`
- `multi-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

1. **Console Report:** Matrix of repo status.
2. **Markdown Report:** `REPO_SYNC_REPORT.md`.

## Preconditions

1. All targets must be valid git repositories.

## Safety/QA Checks

1. **Read-Only Default:** By default, only reports status.
2. **Safety Check:** `--apply` requires clean status in target repos.
3. **Backup:** `--apply` creates backup branch before merging.

## Implementation

See `sync_repos.ps1`.

## Integration

```powershell
.\skills\03_sync_repos\sync_repos.ps1 -Repos "C:\projects\Scrutor\execution-specs", "C:\projects\Scrutor Test\execution-specs"
```