sync-skill

一键同步AI技能(SKILL.md)到不同编码助手和IDE的工具

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:sync-skill。
它的用途是:一键同步AI技能(SKILL.md)到不同编码助手和IDE的工具
完整的 Skill 内容见:https://321skill.com/skills/sync-skill/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

当你从使用 Claude Code 切换到 Cursor 时,无需重新配置技能。只需在终端运行 `npx -y sync-skill claude cursor`,它会自动将你在 Claude Code 中定义的所有全局技能复制到 Cursor 的对应目录中,让你在新工具中立刻拥有熟悉的AI助手能力。

介绍

sync-skill 解决了开发者在使用多个AI编码助手(如Claude Code、Cursor、VS Code等)时,需要为每个平台重复配置相同技能的痛点。它基于开放的 SKILL.md 格式,将技能视为包含一个 SKILL.md 文件(YAML元数据加Markdown指令)和可选脚本/资源的文件夹。由于所有支持的平台都读取相同的格式,同步本质上就是将技能文件夹从一个平台的技能目录复制到另一个平台。

使用方式非常灵活,支持直接模式和交互模式。在直接模式下,通过命令行指定源平台和目标平台,即可一键同步所有技能。在交互模式下,运行命令后会启动一个向导,引导用户逐步选择同步范围(全局或项目)、源平台、目标平台,并可以勾选需要同步的特定技能,实现精细化操作。

它非常适合同时使用多个AI编码工具的开发者,尤其是那些希望在不同工作环境(如不同IDE或不同公司的AI助手)间保持技能配置一致性的用户。无论是个人开发者还是团队,都可以利用它来统一和分享开发技能配置,提升效率。

与同类工具或手动复制相比,sync-skill 的核心优势在于其“平台感知”能力。它内置了各主流AI编码工具(Claude Code、Cursor、Codex等)的技能目录路径知识库,能自动定位和迁移文件,并提供了安全机制(如覆盖前确认、不删除目标端独有技能),避免了手动操作可能导致的路径错误或数据丢失风险。

核心特点

核心区别在于它是一个专为跨平台AI技能同步设计的工具,内置了所有主流AI编码助手(Claude Code、Cursor、Codex等)的技能目录路径映射,并能智能处理覆盖冲突,无需用户手动查找和复制文件路径。

注意事项

该工具仅适用于使用标准 `SKILL.md` 格式的技能,对于平台特有的、非标准格式的自定义功能可能无法同步。

常见问题

sync-skill 会覆盖我目标平台已有的技能吗?

在覆盖前会请求用户确认,并且永远不会删除目标平台独有、源平台没有的技能。

支持哪些AI工具之间的同步?

支持 Claude Code、Cursor、Codex、Gemini CLI、GitHub Copilot CLI、VS Code Agent、OpenCode 之间的相互同步。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/sync-skill/raw/index.md 读取 sync-skill 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。