skills.rest
ckallum
ckallumCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

sync-preview

Previews target divergences and planned reconciliation changes without writing files.

Updated Feb 8, 2026
Search Tags:#sync#drift#report#preflight#targets#dry-run#divergence
One-click install
npx skills add https://github.com/ckallum/calsuite --skill sync-preview
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sync-preview
Source: https://github.com/ckallum/calsuite/tree/main/.claude/skills/sync-preview
Command: npx skills add https://github.com/ckallum/calsuite --skill sync-preview

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Read-only preview of calsuite --sync across every target in config/targets.json. It shows how many files would be written, updated, migrated, or skipped and lists diverged files with reasons. This helps teams understand the impact of a reconciliation before taking action.

Core Features & Use Cases

  • Divergence snapshot: per-target counts of changes and a list of diverged files.
  • Safety-first preview: no writes are performed; it only reports what would happen.
  • Planning aid: run before /reconcile-targets after bulk changes or after long absences to scope effort.

Quick Start

From inside the calsuite project, run the sync-preview command to print a per-target report without applying changes.

Frequently Asked Questions about sync-preview

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

FAQPage Schema
How do I preview file drift before syncing targets?▼

A drift preview reads calsuite HEAD and config/targets.json to output a human-readable report showing per-target counts of files to write, update, migrate, or skip, without writing any files.

What is a dry-run reconciliation report and when do I need one?▼

A dry-run reconciliation report is a read-only divergence snapshot showing what a sync would change across targets. You need one after bulk changes or long absences to scope reconciliation effort safely.

How do I check which files have diverged across sync targets?▼

You check diverged files by running a preflight sync preview that reads calsuite HEAD and config/targets.json, listing every diverged file with reasons alongside per-target change counts.

Does the sync preview modify any files during the drift report?▼

No, the sync preview does not modify files during the drift report. It is strictly safety-first and read-only, outputting a human-readable report of what would happen without performing writes.

Can I use a preflight sync report for every target in my config file?▼

Yes, you can use a preflight sync report for every target. The preview applies to all targets defined in config/targets.json, reading scripts/sync-preview.cjs to generate the divergence snapshot.

What's the best way to scope reconciliation effort after bulk changes?▼

The best way to scope reconciliation effort after bulk changes is to run a read-only drift preview that lists diverged files with reasons and per-target counts of writes, updates, migrations, and skips.

Related Skills

Explore More Software Engineering Skills→
ckallumckallum

sync

Run calsuite cross-target synchronization and parse divergence summaries.

Community
Advanced
gonzalopozogonzalopozo
1

agents-md-sync

Detect drift between AGENTS.md files and the codebase and apply minimal updates.

Community
Advanced
jedmamostojedmamosto

gsd-audit-fix

Run audits, classify findings, apply fixes with test verification and atomic commits.

Community
Advanced
MJ-AgentLabMJ-AgentLab

etl-dwd-to-dws

Trigger the QCM ETL 5-phase pipeline from biz_dwd to biz_dws via PostgreSQL.

Official
Advanced