SkillSync

SkillSync is a tiny macOS CLI that keeps one shared skills library in sync across Claude Code, Codex, and Kilo Code.

What It Does

SkillSync uses ~/ai-skills as the canonical library and copies it into:

• ~/.claude/skills
• ~/.agents/skills
• ~/.kilocode/skills

All supported tools then get the same set of skill folders.

Install

For local development:

npm link

For a global install once published:

npm install -g skillsync

Commands

skillsync init
skillsync sync-all
skillsync fix-duplicates
skillsync doctor
skillsync add my-skill

skillsync init

Creates ~/ai-skills and then runs a full sync into each supported app folder.

This command uses plain directory copies, not symlinks.

skillsync sync-all

Scans ~/ai-skills, ~/.claude/skills, ~/.agents/skills, and ~/.kilocode/skills, imports any unique skill folders into ~/ai-skills, and then copies the shared library back into every app folder.

If the same skill name exists in more than one place with different contents, it exits with an error and tells you to run skillsync fix-duplicates.

skillsync fix-duplicates

Resolves conflicting same-name skills by keeping one canonical copy, moving the extra copies into ~/ai-skills-duplicates/..., and then finishing the shared-library sync.

skillsync doctor

Prints the health of:

• the shared library directory
• each synced app folder
• conflicting same-name skills across all known skill folders

It exits with a non-zero status when anything is unhealthy.

skillsync add <name>

Creates a new skill at ~/ai-skills/<name>/SKILL.md.

Skill names are limited to letters, numbers, dots, underscores, and hyphens.

Filesystem Layout

~/ai-skills
~/.claude/skills
~/.agents/skills
~/.kilocode/skills