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.

Skill Sync v0.1.5

What's new

• Bulk conflict resolution - resolve many conflicts at once instead of one by one.
• Split delete filter - separate remote deletes from local deletes so you can act on each deliberately.
• Automatic baseline on first bind - onboarding now establishes your local baseline, so the first sync starts clean instead of showing everything as changed.
• Metric cards, two-row grid - sync status at a glance, with the apply bar pinned to the bottom when content is short.
• macOS ad-hoc signing - fewer Gatekeeper warnings on first launch.

Fixes & polish

• Apply bar no longer floats away when the plan list is short.
• Color and layout touch-ups across the sync workspace.
• Architecture cleanup from the latest code review.

---

? If Skill Sync helps you keep your Skills in sync, a Star on GitHub helps others find it.

Skill Sync v0.1.4

What's new

• Delete recovery - accepted local deletes now move to a local trash area instead of being lost forever. Recovery-aware apply means an interrupted sync resumes instead of repeating finished work.
• Public Vault support - a private repository is still the recommended default, but you can now bind a public Vault after an explicit confirmation. Skill Sync asks before binding public.
• Vault link in onboarding - jump straight to your bound repository from the app.
• Support entry in Settings - a low-pressure way to Star the project on GitHub, right from the configured workspace.

Docs

• Documented the GitHub Vault visibility choice (private vs public).

Skill Sync v0.1.3

What's new

• Change-count badges on status filters - see exactly how many uploads, downloads, conflicts, and deletes are pending at a glance.
• Themed metric cards with a dedicated delete metric.
• Open skill directory - open any Skill's folder straight from the app.
• Localized README screenshots - English and 简体中文 previews now in the README.

Fixes

• De-duplicate identical blobs when uploading multiple Skills (avoids redundant work and Vault churn).
• Badge alignment and conflict-metric color fixes.

Skill Sync v0.1.2

What's new

• Select all / none in the sync preview filter.
• Conflict decisions reflected in the summary - the plan summary now matches what you actually chose.
• Local vs cloud change tags - clearer which side changed.

Fixes

• Retry transient GitHub 5xx errors when fetching sync blobs.
• Parent-directory-not-exist error during apply.
• Split verbose sync UI into focused presentational components.

Skill Sync v0.1.1

What's new

• Native Apple Silicon builds - aarch64 .dmg for macOS.
• Rewritten README with clearer setup and the GitHub Vault model.

Fixes

• Aligned the release Rust toolchain so macOS and Windows build consistently.

Skill Sync v0.1.0

What's new

The GitHub Vault release - sync through a repository you own, with no SaaS, no PAT, no Git, and no SSH setup.

• GitHub App Device Flow auth - authorize without ever pasting a token.
• GitHub Vault model - Skills are packed as content-addressed blobs under a manifest in your repository (private recommended).
• Three-way comparison - base / local / remote content-hash diff that detects real changes without relying on timestamps.
• Preview before apply - review uploads, downloads, conflicts, and proposed deletes before anything changes.
• Explicit conflict choices - when both sides changed, decide: keep local, use remote, or skip.
• Recovery journal - interrupted applies retain recovery state and resume instead of blindly repeating completed work.
• Log system for easier debugging.

UI

• Reworked workspace with toast, select, and stepper primitives.

Skill Sync v0.0.1

First release

Skill Sync - keep your AI agent Skills in sync across machines through your own GitHub Vault.

• Local-first sync for Codex (~/.codex/skills), Claude Code (~/.claude/skills), and Agent (~/.agents/skills) Skills.
• No SaaS account, no sync server, no telemetry.
• Bilingual interface (English / 简体中文), dark theme.
• Built with Tauri 2, Rust, Svelte 5, and SvelteKit.
• Windows x64 (EXE + MSI) and macOS builds.

This is the initial public build. The sync model was reworked in v0.1.0 - see that release for the current GitHub Vault architecture.