What problem does it solve?
skill-sync helps keep your user-created Claude Desktop skills consistent and up to date across the canonical git repo, Codex, and Claude Code without manually copying files and hoping nothing diverged.
Core Features & Use Cases
- Status visibility: Lists each endpoint (canonical, codex, claude_code, claude) with skill counts, file counts, and the full skill list so you can quickly spot drift.
- Safe publishing workflow: Runs an idempotent sync with a dry-run preview first, then applies changes only after confirmation, including mirroring new/updated skills and propagating deletions.
- Targeted removal workflow: Removes a specified skill from canonical and downstream targets via a dry-run plan followed by a confirmed apply, while clearly noting it does not delete from Claude Desktop.
- Operational guardrails: Surfaces conflicts clearly (and skips canonical commits when conflicts are created) and supports flags like --dry-run and --no-commit for inspection.
Quick Start
Tell the agent: "Run skills-sync status, then sync my skills if anything is out of date."