v1.0.0

Skill Sync 1.0

Sync your AI agent Skills across computers through a GitHub repository you control. Skill Sync reaches 1.0: the cross-machine sync workflow is stable and the Vault protocol is settled, ready for everyday use.

The headline: your Skills, synced across machines through your own GitHub Vault

Skill Sync keeps your Codex, Claude Code, and general agent Skills in their normal tool directories and moves them between computers through a single GitHub repository you own - the Vault. A private repository is recommended so your Skill files stay visible only to you.

• One Vault, many machines - bind the same repository on every computer. Upload local Skills from one machine, then download them on another without copying files by hand.
• No SaaS, no sync server - there is no Skill Sync account and no custom server. Your GitHub repository is the only thing in the cloud.
• No Git, PAT, or SSH setup - authorize with the GitHub App Device Flow, install the App for the selected Vault repository, and you're done. Credentials live in the OS keyring; the desktop app ships no client secret or private key.
• Local-first - Skills stay in their existing tool directories. Scanning, comparison, and apply all run on your machine. The remote Vault only holds content-addressed Skill blobs and a manifest.

Review every change before it happens

• Preview before apply - see planned uploads, downloads, proposed deletes, and conflicts before anything changes. Search the plan, inspect individual Skills, and choose exactly what to sync.
• Explicit conflict choices - when both sides changed, you decide whether to keep local content, use remote content, or skip. Skill Sync never silently overwrites newer work.
• Content-based comparison - a three-way base / local / remote content-hash comparison detects real changes instead of trusting timestamps.
• Bulk conflict resolution - resolve many conflicts at once instead of one by one.
• Safer deletes - deletes are advisory and require explicit selection. Accepted local deletes move to a local trash directory instead of disappearing.
• Recovery-aware apply - if an apply is interrupted, recovery state is retained so the next sync resumes instead of blindly repeating finished work.

Supported Skill directories

V1 scans these fixed user-level roots:

Namespace	Root
agents	~/.agents/skills
codex	~/.codex/skills
claude-code	~/.claude/skills

The reserved ~/.codex/skills/.system directory is excluded from scanning.

Privacy and safety

• The GitHub App requests only Contents: read and write and Metadata: read-only.
• Installation uses selected repositories and exposes exactly one Vault repository to Skill Sync.
• A private repository is the recommended default; binding a public Vault requires explicit confirmation.
• No telemetry. No Skill Sync account. The desktop app contains no GitHub App client secret or private key.

Getting started

1. Download the Windows x64 (EXE/MSI) or Apple Silicon installer from the assets below.
2. Install and launch Skill Sync. Windows may show a security warning because the current installer is unsigned.
3. Complete authorization and Vault binding from the in-app Onboarding flow.
4. Preview and apply your first plan from Sync, then connect the same Vault on your other machines.

Full walkthrough and design docs are in the README.