Sync Skill
One-click synchronization tool for **AI Agent Skills** (`SKILL.md`) across coding agents and IDEs.
william-garden · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add william-garden/sync-skill技能说明
sync-skill
One-click synchronization tool for AI Skills (SKILL.md) across coding agents and IDEs.
1. Overview
sync-skill copies your Agent Skills from one AI tool into another. Agent Skills use the open SKILL.md format — a skill is just a folder containing a SKILL.md file (YAML frontmatter plus Markdown instructions) and optional scripts/assets. Because every supported platform reads the same format, syncing is simply a matter of copying skill folders from one platform's skills directory into another's. No format conversion is needed.
Each platform stores skills in a different directory, so sync-skill knows where every tool looks and moves your skills there safely — asking for confirmation before it replaces anything that already exists on the target, and never deleting skills that only exist there.
2. Technical Specifications
- Runtime: Node.js >= 18 (pure ESM, no build step).
- Distribution: run via
npx sync-skill(no global install required). - Dependency:
@inquirer/promptsfor the interactive wizard. Everything else uses Node built-ins. - Tests:
npm test(Node's built-innode --test). - OS support: Linux, macOS, and Windows.
3. Usage
Direct mode (copies all skills)
npx -y sync-skill <source> <target> [--scope global|project]
Examples:
# Sync all global skills from Claude Code into Cursor
npx -y sync-skill claude cursor
# Sync project-level skills from Claude Code into Codex (./.claude/skills -> ./.agents/skills)
npx -y sync-skill claude codex --scope project
Interactive mode (pick individual skills)
npx -y sync-skill
The wizard walks you through: scope → source platform → target platform → checkbox selection of skills to copy.
--scope global(default): personal skills under your home directory.--scope project: