Sync Multi-Repo State

Compare git repositories and generate a REPO_SYNC_REPORT.md drift report.

27|8|Updated Jan 16, 2026
One-click install
npx skills add https://github.com/Sounder25/Google-Antigravity-Skills-Library --skill sync-multi-repo-state
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Sync Multi-Repo State
Source: https://github.com/Sounder25/Google-Antigravity-Skills-Library/tree/main/03_sync_repos
Command: npx skills add https://github.com/Sounder25/Google-Antigravity-Skills-Library --skill sync-multi-repo-state

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps teams detect and report state drift across multiple git repositories, including forks and mirrors, so you can synchronize and maintain consistency.

Core Features & Use Cases

  • Drift detection: Compares branches and commit histories across repos to highlight divergence.
  • Drift reporting: Generates a machine-readable and human-friendly REPO_SYNC_REPORT.md.
  • Safe synchronization: Provides an optional apply path with safety checks to create backups before merging or pulling.

Quick Start

Run the drift analysis script to compare given repository paths and generate a drift report. Example: .\skills\03_sync_repos\sync_repos.ps1 -Repos "C:\path\to\repo1","C:\path\to\repo2" -Reference "C:\path\to\repo1"

Frequently Asked Questions about Sync Multi-Repo State

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect drift across multiple git repositories?

To detect drift across multiple git repositories, provide a list of repository paths and a reference repo to the PowerShell script. It compares branches and commit histories to highlight divergence and generates a machine-readable REPO_SYNC_REPORT.md for human review.

What is the best way to compare state divergence between git forks and mirrors?

Comparing state divergence between forks and mirrors is handled by running a drift analysis script that checks commit histories against a reference repository. This produces a detailed report highlighting inconsistencies so teams can synchronize and maintain consistency.

Can I safely synchronize multiple git repositories after detecting drift?

You can safely synchronize repositories using the optional apply path, which includes safety checks to create backups before merging or pulling. This prevents data loss while aligning fork and mirror states with the reference repository.

Do I need PowerShell and Git to run multi-repo drift reports?

You need both Git and PowerShell installed to run multi-repo drift reports. The automation script requires PowerShell to execute and Git to analyze branch and commit histories across the specified repository paths.

How does drift reporting work for multi-module projects?

Drift reporting for multi-module projects works by accepting a list of repository paths and a reference path to compare commit histories. It outputs a REPO_SYNC_REPORT.md file that documents the current state and divergence of each module.

What are the limitations of automating repository sync with PowerShell?

Automating repository sync with PowerShell requires specifying exact repository paths and a reference repo for analysis. The safe synchronization apply path is optional, meaning manual review of the generated drift report is recommended before executing any merge or pull operations.