AI Skill Cross-Platform Sync Tool

Problem

AI coding tools keep separate skills/ directories, so the same SKILL.md bundles are copied manually, paths diverge, and name collisions can overwrite work unintentionally. sync-skill treats a Skill as a folder containing SKILL.md plus optional scripts/resources and copies it between supported platforms without converting the format. It does not perform semantic rewrites or assume platform-specific private formats; if the target platform can read the same folder, the same skill definition can be reused.

How It Works

• Direct mode: copies all Skills from the selected scope. --scope global targets personal Skills under the home directory; --scope project targets the workspace Skills in the current directory.
• Interactive mode: guides you through scope → source platform → target platform → Skill selection, useful when only a subset should be copied.
• Collision guard: same-name Skills are not silently replaced. It reports source and target version when present, asks for confirmation, and keeps no backup after replacement.
• Metadata preserved: common fields such as name and description are copied unchanged; extension fields such as model and effort are not rewritten automatically, and the report reminds you to adjust them manually.

Boundaries

• Works with platforms that read the same SKILL.md format, including Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot CLI, VS Code, and OpenCode.
• VS Code and GitHub Copilot CLI share ~/.copilot/skills/ in global scope, so syncing between them may be a no-op.
• Project scope depends on the current working directory; run it from the project root.
• Requires Node.js ≥ 18; Windows paths resolve with %USERPROFILE% and similar system variables.