How do I install the Skills Sync skill?

Run npx skillmds@latest add kang-chen/skills-sync in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Skills Sync safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Skills Sync?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Skills Sync free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Skills Sync?

Kang-chen (@kang-chen) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Skills Sync by kang-chen — Agent Skill

Name: Skills Sync
Author: Kang-chen

File contents

Skills Sync (DEPRECATED)

Note: This skill has been merged into skill-manager. Please use skill-manager for all skill operations.

Migration Guide

Use these skill-manager commands instead:

Old (skills-sync)	New (skill-manager)
`sync.py sync -g`	`skills sync`
`sync.py sync -p`	`skills sync --local`
`sync.py list -g`	`skills list`
`sync.py status -g`	`skills status`

New Commands

# Sync all skills to all IDEs
python ~/.ai-skills/skill-manager/scripts/skills sync

# Sync single skill
python ~/.ai-skills/skill-manager/scripts/skills sync my-skill

# Sync with dry-run preview
python ~/.ai-skills/skill-manager/scripts/skills sync --dry-run

# Check sync status
python ~/.ai-skills/skill-manager/scripts/skills status

# Verify sync consistency
python ~/.ai-skills/skill-manager/scripts/skills verify

Legacy Scripts (Still Available)

The original scripts remain for backward compatibility:

Sync Commands

python ~/.ai-skills/skills-sync/scripts/sync.py sync -g       # Sync global skills
python ~/.ai-skills/skills-sync/scripts/sync.py sync -p       # Sync project skills
python ~/.ai-skills/skills-sync/scripts/sync.py list -g       # List global skills
python ~/.ai-skills/skills-sync/scripts/sync.py status -g     # Check sync status

Architecture

GLOBAL:  ~/.ai-skills/          →  ~/.xxx/skills/
PROJECT: <project>/.ai-skills/  →  <project>/.xxx/skills/

Supported IDEs

IDE	Global Target	Project Target
Claude Code	`~/.claude/skills/`	`.claude/skills/`
Cursor	`~/.cursor/skills/`	`.cursor/skills/`
Codex	`~/.codex/skills/`	`.codex/skills/`
Gemini CLI	`~/.gemini/skills/`	`.gemini/skills/`
Antigravity	`~/.gemini/antigravity/skills/`	`.agent/skills/`

Configuration (Legacy)

Edit ~/.ai-skills/skills-sync/config.json:

{
  "global_source_dir": "~/.ai-skills",
  "global_targets": { "claude": "~/.claude/skills", ... },
  "enabled": ["claude", "cursor", "codex", "gemini", "antigravity"],
  "exclude_skills": [],
  "preserve_target_skills": {
    "codex": [".system"]
  }
}

Notes

Does NOT modify ~/.codex/skills/.system/ (Codex pre-installed skills)
Auto-removes orphaned skills from targets during full sync

---name: skills-syncdescription: DEPRECATED - Use skill-manager instead. This skill is kept for backward compatibility. For syncing skills: use 'skills sync' from skill-manager.---# Skills Sync (DEPRECATED)> **Note:** This skill has been merged into **skill-manager**. Please use skill-manager for all skill operations.## Migration GuideUse these skill-manager commands instead:| Old (skills-sync) | New (skill-manager) ||-------------------|---------------------|| `sync.py sync -g` | `skills sync` || `sync.py sync -p` | `skills sync --local` || `sync.py list -g` | `skills list` || `sync.py status -g` | `skills status` |## New Commands```bash# Sync all skills to all IDEspython ~/.ai-skills/skill-manager/scripts/skills sync# Sync single skillpython ~/.ai-skills/skill-manager/scripts/skills sync my-skill# Sync with dry-run previewpython ~/.ai-skills/skill-manager/scripts/skills sync --dry-run# Check sync statuspython ~/.ai-skills/skill-manager/scripts/skills status# Verify sync consistencypython ~/.ai-skills/skill-manager/scripts/skills verify```---## Legacy Scripts (Still Available)The original scripts remain for backward compatibility:### Sync Commands```bashpython ~/.ai-skills/skills-sync/scripts/sync.py sync -g # Sync global skillspython ~/.ai-skills/skills-sync/scripts/sync.py sync -p # Sync project skillspython ~/.ai-skills/skills-sync/scripts/sync.py list -g # List global skillspython ~/.ai-skills/skills-sync/scripts/sync.py status -g # Check sync status```## Architecture```GLOBAL: ~/.ai-skills/ → ~/.xxx/skills/PROJECT: <project>/.ai-skills/ → <project>/.xxx/skills/```## Supported IDEs| IDE | Global Target | Project Target ||-----|---------------|----------------|| Claude Code | `~/.claude/skills/` | `.claude/skills/` || Cursor | `~/.cursor/skills/` | `.cursor/skills/` || Codex | `~/.codex/skills/` | `.codex/skills/` || Gemini CLI | `~/.gemini/skills/` | `.gemini/skills/` || Antigravity | `~/.gemini/antigravity/skills/` | `.agent/skills/` |## Configuration (Legacy)Edit `~/.ai-skills/skills-sync/config.json`:```json{ "global_source_dir": "~/.ai-skills", "global_targets": { "claude": "~/.claude/skills", ... }, "enabled": ["claude", "cursor", "codex", "gemini", "antigravity"], "exclude_skills": [], "preserve_target_skills": { "codex": [".system"] }}```## Notes- Does NOT modify `~/.codex/skills/.system/` (Codex pre-installed skills)- Auto-removes orphaned skills from targets during full sync

Frequently asked questions

Skills Sync