skillsync

SkillSync

Version control for Agent Skills. SkillSync wraps Git to let you track, diff, snapshot, and restore entire Skills — not individual files.

Rule: Human Confirmation Required

Before executing ANY skillsync command, you MUST ask the user for confirmation.

• Never run skillsync commands automatically or silently.
• Always explain what the command will do and why, then wait for explicit approval.
• This applies to every command: init, snapshot, restore, sync, remote add, etc.

Install

curl -fsSL https://raw.githubusercontent.com/johnsonbuilds/skillsync/main/install.sh | sh

Or via pip (requires Python 3.12+):

pip install skillsync

After install, initialize:

skillsync init

This auto-detects your agent harness and Skills directory.

Commands

Check for changes

skillsync status        # which Skills changed
skillsync diff          # what exactly changed
skillsync diff   # diff for a specific Skill

Save a snapshot

skillsync snapshot -m "describe what you did"

View history

skillsync log                    # all snapshots
skillsync log             # history for one Skill

Restore a Skill

skillsync restore                   # restore to last snapshot
skillsync restore      # restore to a specific version

Multi-machine sync

skillsync remote add      # set up remote (first machine)
skillsync clone     # clone to a second machine
skillsync sync                 # sync across machines
skillsync sync --use-remote    # on conflict, accept remote version

Key Concepts

• Skill: A directory containing a SKILL.md file. SkillSync's basic unit of management.
• Snapshot: A Git commit capturing the state of all Skills.
• Pre-sync Snapshot: Auto-created before sync to protect unsaved local work.

Safety

• Never force-pushes. History is always safe.
• Restore creates a new commit; existing history is never deleted.
• Network commands have timeout protection (fetch 10s, push 120s, clone 300s).