sync

Run calsuite cross-target synchronization and parse divergence summaries.

Updated Feb 8, 2026
One-click install
npx skills add https://github.com/ckallum/calsuite --skill sync-ckallum
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync
Source: https://github.com/ckallum/calsuite/tree/main/.claude/skills/sync
Command: npx skills add https://github.com/ckallum/calsuite --skill sync-ckallum

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manages and interprets cross-target synchronization for calsuite by executing the mechanical sync protocol across all configured targets and presenting an actionable divergence summary.

Core Features & Use Cases

  • Executes the real sync across every target defined in config/targets.json.
  • Parses and highlights divergence details, including per-file status and recommended follow-ups.
  • Supports a read-only dry-run via /sync preview to safely validate changes before applying them.
  • Helps coordinate reconciliation, claiming, or pruning actions based on the end-of-sync report.

Quick Start

Run the real synchronization across all targets by executing node "$calsuite_dir/scripts/configure-claude.js" --sync and review the divergence summary.

Frequently Asked Questions about sync

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

FAQPage Schema
How do I automate cross-target synchronization for calsuite targets?

Cross-target synchronization is automated by running Node-based scripts that execute the sync protocol across all targets defined in config/targets.json, producing a divergence summary and recommended follow-up steps.

Can I preview synchronization changes before applying them to all targets?

Yes, you can run a read-only dry-run using the /sync preview command to safely validate changes and inspect divergence details before executing the real synchronization across your configured targets.

What does a divergence summary show after syncing configuration targets?

A divergence summary highlights per-file status details and recommended follow-up actions across all synced targets, helping you coordinate reconciliation, claiming, or pruning operations based on the end-of-sync report.

Do I need a local calsuite setup to run cross-target sync?

Yes, a local calsuite setup is required. The synchronization process uses Node-based scripts within that environment to run the sync and parse results across all targets defined in your configuration.

How do I interpret and reconcile file divergence across multiple sync targets?

Interpreting file divergence involves reviewing the end-of-sync summary generated by the Node scripts, which highlights per-file status and recommends reconciliation, claiming, or pruning actions to resolve inconsistencies.

What's the best way to run a safe dry-run before syncing calsuite targets?

The best way to safely validate changes is executing a read-only dry-run via the /sync preview command, which parses divergence details without applying actual modifications to your configured targets.