synthesis-mac-sync

Installation
SKILL.md

Synthesis Mac Sync

A methodology for keeping multiple Macs in sync using iCloud for configuration files and Git for repositories. Designed to run fully automated via an AI coding assistant — the user says "run my mac-sync" and the assistant handles everything.

This skill provides the protocol — the sync methodology, safety rules, conflict resolution, and manifest format. Your personal config file (a README or manifest in your iCloud sync folder) provides the specifics: which files, which machines, which repos.

Configuration

These values are user-specific. Update them for your environment.

Setting Value Description
icloud_sync_folder ~/Library/Mobile Documents/com~apple~CloudDocs/workspaces/[username]/mac-sync/ iCloud Drive folder for synced config files
git_scan_root ~/workspaces/ Root directory for git repository discovery
git_scan_max_depth 3 Maximum depth for recursive .git directory search
git_repos_manifest git-repos.yaml Manifest file caching discovered repos

Related skills
Installs
13
GitHub Stars
6
First Seen
Mar 20, 2026