sync-skill CLI
sync-skill copies skill folders with SKILL.md between Claude Code, Codex, Cursor, Gemini CLI, Copilot, VS Code and OpenCode.
- 96 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Copies files into other agents' skill folders and after confirmation replaces same-name ones without a backup.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/sync-skillDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Copies files into other agents' skill folders and after confirmation replaces same-name ones without a backup.
This is third-party code. Review the repository files before installing.
What it does
Skills in the `SKILL.md` format are read by many agents, but each looks in its own folder. `sync-skill` knows those folders and moves skills from one environment to another without converting the format. Direct mode `npx -y sync-skill claude cursor` copies every skill, while interactive `npx -y sync-skill` runs a wizard for scope, source, target and a checklist of skills. The `global` scope uses personal folders in the home directory and `project` works with the current project's folders. Skills that exist only on the target stay untouched. If a skill with the same name exists, the tool shows both versions and asks for confirmation.
Who it is for. Developers who use several agents and do not want to copy skills by hand from `~/.claude/skills` to Cursor, Codex or Gemini CLI folders.
Good fit when
- A skill set was built in Claude Code and needs to reach Cursor within a minute
- Project skills from `.claude/skills` must land in Codex's `.agents/skills` for the whole team
- Three of dozens of skills need moving, and a checklist is more convenient
- Before replacing a skill you want to see its versions in source and target
Not a fit when
- A skill needs tuning for the target's model: the `model` and `effort` fields are copied as is
- You want a backup: a confirmed replacement keeps no old version
- Skills should update themselves on a schedule, and the tool has no such mode
Example request
Copy all my global skills from Claude Code to Cursor and show which model fields remain in `SKILL.md`.Limitations
Node.js 18 or newer is required. The `model` and `effort` fields in skill frontmatter belong to the Anthropic model family: the tool copies them unchanged and lists skills worth fixing by hand. A confirmed replacement is irreversible and keeps no backup. VS Code and GitHub Copilot CLI share one global folder, so copying between them changes nothing. The last commit dates from July 2026.
How to disable. There is nothing to remove: `npx` does not install the package permanently. Delete copied skills from the target folders by hand.
FAQ
How do I move skills from Claude Code to Codex?
Run `npx -y sync-skill claude codex --scope project`. The project's `.claude/skills` folder is copied into `.agents/skills`.
Will the command overwrite my skills without asking?
No, on a name match it shows the versions from `SKILL.md` and asks for confirmation. Skills missing in the source are not deleted.
Which environments are supported?
Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot CLI, Visual Studio Code and OpenCode. Names accept synonyms such as `claude`, `openai`, `gemini`.
What to do with the `model` and `effort` fields after copying?
Open `SKILL.md` in the target environment and fix them by hand: the tool copies values as they are and prints the skills where they are set.
Does the package need a global install?
No, `npx -y sync-skill` is enough. Only Node.js 18 or newer is required.
Discussion
No questions or reviews yet.
Related
CLI toolsSkill and agent manager with a lock file: installs one set into Claude Code, Codex, Cursor and others and keeps your edits.
The author's personal set: shared agent rules and dozens of skills for GitHub, the browser, macOS, messaging and releases, plus a sync script
Over 1,100 ready-made skills for Claude Code, Codex, Gemini CLI and Cursor, plus an MCP server that picks a skill for the task
19 skills for Claude Code, Codex and Antigravity CLI: Grok and Exa search, Context7 docs, Serena and task hand-offs between agents
SkillNote is a self-hosted SKILL.md registry with per-project collections and sync into Claude Code and OpenClaw
skills-npm links agent skills shipped in your dependencies in node_modules and listed in the skills field of package.json
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| sync-skill (this card) | no | 96 | |
| skillshare | no | 3,070 | skill sync across tools with its own store; sync-skill just copies folders between environments |
| OpenSkills | no | 10,831 | loads Claude Code-format skills into any agent; sync-skill moves already installed ones |
README in short
Since every environment reads the same `SKILL.md` format, migration is just folder copying. The tool knows each environment's global and project paths, runs on Linux, macOS and Windows and depends only on Node.js and `@inquirer/prompts`.