skill-sync
One Git-backed skill library. Explicit installs. Safe updates across Codex and Claude.
skill-sync keeps reusable AI skills in a canonical Git repository and projects selected skills into the tools and repositories where you use them. Every write is validated, conflicts stop instead of overwriting local work, and automation receives deterministic JSON and exit statuses.
initaddinstallstatussyncpublishPick your path
Section titled “Pick your path”New userConnect a library and install a skill
Go from installation to your first managed Codex and Claude copies.
Library ownerCurate and publish canonical skillsAdd skills, organize groups, publish edits, and remove content safely.
OperatorUnderstand drift before changing filesInspect status, compare content, resolve conflicts, and recover backups.
ContributorDevelop and validate the Nx workspaceBuild the CLI and wiki, run focused checks, and inspect release artifacts.
The safety model in one minute
Section titled “The safety model in one minute”- The library is a normal Git repository, but
skill-synctreats fetched content as inert data. - Installed copies are tracked by exact revision and digest in project metadata.
statusanddiffmake local, canonical, and recorded-base differences visible.- Replacing local edits requires explicit destructive intent and confirmation.
- Canonical writes use a clean exact-revision checkout, a normal commit, and a non-force push.
Start with installation or jump directly to the complete command reference.