Home / synthesisengineering / synthesis-skills · skills/synthesis-machine-sync/SKILL.md · GitHub

synthesis-machine-sync skillB

synthesis-machine-sync is agent-read markdown (skill) from synthesisengineering/synthesis-skills: Enroll, sync, hand off, and retire Macs in a personal fleet with git plus the leased coordination board. Use when asked to: machine sync, enroll a Mac, fleet handoff, move work to another Mac, resume on another Mac, fleet doctor, bootstrap a new Mac, retire a Mac, workspace subscriptions..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Machine Sync

Keep a personal fleet of Macs (N=2 first) working as one system. Git remotes
plus the leased coordination board are the only transports: every shared
write goes through compare-and-swap, every Mac keeps its own machine
identity, and no file-replication transport sits in any write path.

This skill is the **protocol** — enroll/sync/leave/handoff plus the engines
that enforce them. Your personal stores (fleet registry copy, repos
manifest, subscriptions) travel in the personal knowledge repo and
materialize to each Mac.

## Non-negotiables

- Each Mac mints its own stable machine-id once
  (`~/.synthesis/fleet/machine-id`, mode 0600). The file never moves to
  another Mac; only the enrollment receipt names it.
- The fleet registry (`machines.json`) names exactly one primary. A
  secondary enrolls against the synced copy, never by founding a second
  fleet.
- Shared board rows identify sessions by `(machine_id, session_uuid,
  client_ref)`. Liveness is heartbeat age on the board, never a pid from
  another Mac.
- Secrets ride the `synthesis-fleet-secrets` provider, never synced files.
  No secret value appears in any synced store, board message, or receipt.
…

Read the whole file at its exact version.

How to install

Latest version
mdr add synthesisengineering/synthesis-skills/synthesis-machine-sync@v1.0.0
Exact content
mdr add synthesisengineering/synthesis-skills/synthesis-machine-sync@sha256:a78a8d838e1b191c

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_og7fds2buvvjp6w3.svg)](https://markdownregistry.com/a/art_og7fds2buvvjp6w3)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
v1.0.0 latest2026-09-20 589d27d 7,554 BB view · diff
v1.0.02026-09-20 1efe765 6,982 BA view · diff
v1.0.02026-09-20 1dffafa 6,623 BA view

Audit of the latest version

B  16 of 17 checks passed. Deterministic, no model, same answer every run.
  • fail: No curl or wget piped into a shell (matched: curl -fsSL https://raw.githubusercontent.com/synthesisengineering/synthesis-skills/stable/onboard.sh)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (7554 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

synthesisengineering/synthesis-skills · 19 stars · license Apache-2.0 · pushed 2026-09-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_og7fds2buvvjp6w3
GET https://markdownregistry.com/api/v1/resolve?ref=synthesisengineering/synthesis-skills/synthesis-machine-sync
GET https://markdownregistry.com/api/v1/blob/a78a8d838e1b191ca1573642438ed184f30dff145215d94c672ed52b8abf7cea

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from synthesisengineering/synthesis-skills

AGENTS.md agents
synthesisengineering/synthesis-skills · AGENTS.md
git:20260923.aa168e8 · audit A · 19 stars
CLAUDE.md claude
synthesisengineering/synthesis-skills · CLAUDE.md
git:20260730.93876b7 · audit B · 19 stars
synthesis-absence-coordination skill
synthesisengineering/synthesis-skills · skills/synthesis-absence-coordination/SKILL.md · Coordinate an absence end to end — vacation, conference travel, family visits, medical leave — the way a good chief of…
v1.0.0 · audit A · 19 stars
synthesis-adversarial-review skill
synthesisengineering/synthesis-skills · skills/synthesis-adversarial-review/SKILL.md · Run bounded, differently-shaped-agent adversarial review against the principal's outcome, with artifact-complete…
v1.0.0 · audit A · 19 stars
synthesis-agent-conformance skill
synthesisengineering/synthesis-skills · skills/synthesis-agent-conformance/SKILL.md · Audit, install, and verify a synthesis ecosystem across multiple AI agent runtimes. Use for Claude Code and OpenAI…
v1.12.0 · audit A · 19 stars
synthesis-agent-correspondence skill
synthesisengineering/synthesis-skills · skills/synthesis-agent-correspondence/SKILL.md · Compose and send honest agent correspondence across Slack, email, and other channels. Defines principal-direct…
v3.1.1 · audit A · 19 stars
synthesis-agent-guardrails skill
synthesisengineering/synthesis-skills · skills/synthesis-agent-guardrails/SKILL.md · Fail-closed session and tool guards for agent harnesses: cross-account artifact routing and publication authority…
v1.0.0 · audit A · 19 stars
synthesis-anti-shortcuts skill
synthesisengineering/synthesis-skills · skills/synthesis-anti-shortcuts/SKILL.md · Discipline for catching the lazy-shortcut antipattern in AI-assistant output. Makes the costume vocabulary explicit so…
v1.1.1 · audit A · 19 stars
synthesis-article-refresh skill
synthesisengineering/synthesis-skills · skills/synthesis-article-refresh/SKILL.md · Refresh and revitalize older articles with improved clarity, presentation, and completeness while preserving the…
v1.1.0 · audit A · 19 stars
synthesis-article-writing skill
synthesisengineering/synthesis-skills · skills/synthesis-article-writing/SKILL.md · Five-phase workflow for creating high-quality thought leadership articles: reader briefing, research and validation…
v2.3.0 · audit A · 19 stars
synthesis-autopilot skill
synthesisengineering/synthesis-skills · skills/synthesis-autopilot/SKILL.md · Execute an explicitly delegated whole task autonomously using the thinking framework, durable plan and context…
v2.3.0 · audit A · 19 stars
synthesis-bitbucket skill
synthesisengineering/synthesis-skills · skills/synthesis-bitbucket/SKILL.md · Work with Bitbucket Cloud repos through the open-source bkt CLI — PR lifecycle (list, view, diff, comment, approve…
v1.1.0 · audit A · 19 stars

Every file in synthesisengineering/synthesis-skills

Browse by kind, by grade B, or by owner.