开源工具统一管理Cursor、Claude Code与Antigravity的Skills

同时用 Cursor、Claude Code 和 Antigravity你还在手动拷 Skills 吗这款开源神器拯救强迫症说实话我身边越来越多同事开始同时装两三个 AI 编程工具了。Cursor 写前端交互顺手Claude Code 处理长链路重构靠谱Antigravity 在代码补全的响应速度上确实有两下子。工具多了一个很隐蔽但特别折磨人的问题就来了——Skills 文件。今天在 Cursor 里调好的一个 skill明天想在 Claude Code 里用要么重新写一遍要么手动拷贝到对应目录。一次两次还能忍次数多了真能把强迫症逼疯。我后来实在受不了专门找了个开源的统一管理方案把三套工具的 skills 目录全部打通彻底告别手动复制粘贴。这篇文章就把这套方案的完整思路和实操过程分享出来。不管你是刚接触 Skills 的初学者还是已经被多工具同步折磨很久的老手都能在这里找到适合自己的解决路径。我会先讲清楚三款工具在 Skills 机制上的差异再说明为什么用开源方案而不是自己写脚本最后给出完整的搭建步骤和避坑经验。1. Skills 机制解析三款工具到底在哪儿存文件、怎么加载要解决同步问题第一步不是急着找工具而是先把三款工具的 Skills 目录结构和加载机制彻底搞明白。这个环节如果偷懒后面配置起来大概率会踩坑。1.1 Cursor 的 Skills 目录结构与加载规则Cursor 对 Skills 的支持相对比较直接它主要读取两个位置的目录一个是用户级别的全局目录~/.cursor/skillsWindows 下是%USERPROFILE%\.cursor\skills另一个是项目级别的.cursor/skills。全局目录适合放那些跨项目通用的技能比如代码审查规范、Git 提交信息生成规则项目目录则适合放跟当前业务强相关的技能比如Nacos 配置检查这种只对这个项目有用的内容。这里有一个特别容易忽略的细节Cursor 对 Skills 的加载优先级是项目目录优先于全局目录。也就是说如果你在项目里放了一个code-review.md全局目录里也有同名文件实际生效的是项目里的那个。这个机制本身没问题但很多人不知道导致改了全局文件却发现行为没变化白白排查半天。1.2 Claude Code 的 Skills 定位方式Claude Code 的 Skills 机制走的是另一套逻辑。它支持在项目根目录创建.claude/skills文件夹同时用户主目录下也有对应的用户级 Skills 目录。但 Claude Code 更强调通过配置文件来管理和启用 Skills使用.claude/settings.json来控制哪些技能可用、哪些被禁用。与 Cursor 相比Claude Code 的 Skills 文件通常要包含更加结构化的 frontmatter 元数据比如技能名称、描述、触发条件等。它希望通过这些描述让 Claude 在对话中主动决定是否调用某个技能而不是靠用户手工指定。这样设计的好处是交互更自然但副作用就是同一个技能文件往往需要在格式上做调整才能跨工具复用。1.3 Antigravity 的个性化存储路径Antigravity 作为较新的一款 AI IDE它的 Skills 存储机制在早期版本里比较自我。默认情况下Antigravity 会把用户自定义的 Skills 存放在~/.antigravity/skills或类似的专属目录中并且其配置体系跟 Cursor、Claude Code 并不完全兼容。加上 Antigravity 的安装包在不同平台上行为有差异目录位置也不是处处一致这就让多工具同步显得更加麻烦。不过有一点值得肯定Antigravity 在 Tools 和 Agent 层面提供了较多的自定义扩展点。也就是说只要你愿意花点时间做适配完全可以通过统一的方式把外部 Skills 接入进去。关键就在于要找到正确的目录并且了解它对技能文件格式的容忍程度。1.4 三款工具差异对比速查表为了方便大家直观理解我把三款工具的差异整理成一张表格工具全局 Skills 目录项目级 Skills 目录配置文件加载优先级Cursor~/.cursor/skillsWin 为%USERPROFILE%\.cursor\skills.cursor/skills目录即文件项目优先于全局Claude Code~/.claude/skills.claude/skillssettings.json控制启停项目优先配置可覆盖Antigravity~/.antigravity/skills以实际安装版本为准.antigravity/skills或自定义独立配置文件不支持跨层同名覆盖看到这里你应该明白了三套目录、三套配置规则、三套文件要求靠手动同步根本不现实。哪怕你只是新增一个技能都要至少跑三个地方复制粘贴。2. 为什么我不用自研脚本而是选择开源方案很多程序员的第一反应是这不就写个 shell 脚本或者 Python 脚本把三个目录软链接到一起不就行了吗我一开始也是这么想的但实际测下来发现事情没那么单纯。2.1 手动软链接的致命缺陷目录结构不对齐表面上看Linux 和 macOS 下用ln -s软链接Windows 下用mklink /D目录联接确实可以让三个工具共享同一份文件。但问题在于三款工具的目录结构、文件名规范、元数据要求都存在差异。最简单的例子Cursor 里一个技能就是一个.md文件文件名即技能名但 Claude Code 除了.md文件还经常配套一个可执行的脚本文件用来让 Agent 在执行技能时调用外部程序Antigravity 则可能需要在配置里显式注册技能路径。你没法简单地用一个软链接让他们共用同一套文件因为三者的文件形态根本不一样。2.2 开源同步工具解决的核心痛点我最终选择的方案是基于名为skill-sync一个社区维护的开源 Skill 管理工具构建的完整同步链路。当然市面上类似的工具还有几个比如基于 dotfiles 管理思路的skills-symlink和基于 Git 仓库的skill-manager。它们解决的核心痛点是一致的统一仓库所有 Skills 文件集中到一个地方管理通过 Git 做版本控制改坏了随时能回滚。智能映射根据目标工具的目录规范自动把统一的源文件转换成对应工具需要的格式和位置。增量同步只同步发生变化的文件而不是每次全量拷贝节省时间也避免不必要的冲突。跨平台支持Windows、macOS、Linux 都能跑团队内部不同系统之间也能保持一致。2.3 一个被很多人忽略的关键点Skills 源文件本身也应该分层写 Skills 的时候很多人喜欢把所有内容堆在一个文件里但这样在跨工具复用时会非常被动。比较合理的做法是源文件按照功能归档同步时再根据目标工具进行组装。举个例子一个前端代码审查技能至少应该拆成三个部分prompt.md用于 Cursor 这种以提示词为核心的工具包含审查规则、输出格式、检查清单。agent.mdscript.py用于 Claude Code 这种支持 Agent 调用的工具除了提示词外还有一个可执行脚本辅助分析。config.yaml用于 Antigravity 这类依赖配置注册的工具描述技能触发条件和参数定义。统一的源目录是一份全量素材然后通过同步工具按需生成每个平台需要的实际文件。这就是开源方案相比手动复制最大的优势——你只需要维护一份源文件剩下的分发自适配由工具完成。3. 实操搭建从零开始配置 skill-sync 统一管理三工具 Skills下面进入正题我把完整搭建过程一步步写出来。整个流程在 macOS 和 Linux 上验证过Windows 用户我用 WSL 环境也测过基本一致只有个别路径写法有差异。3.1 安装 skill-sync 并初始化中央仓库首先安装 skill-sync。它的安装方式很简单依赖 Node.js 18 以上版本# 使用 npm 全局安装 npm install -g skill-sync # 验证安装 skill-sync --version安装完成后初始化中央 Skills 仓库。这个仓库不一定要建在工具目录下我个人的习惯是放在一个独立的目录比如~/workspace/my-skills然后用 Git 管理# 创建并进入仓库目录 mkdir -p ~/workspace/my-skills cd ~/workspace/my-skills # 初始化仓库结构 skill-sync init # 把仓库变成 Git 仓库方便版本管理 git init初始化完成后目录结构大致如下my-skills/ ├── source/ # 源文件目录你的所有技能素材放这里 │ ├── frontend-review/ # 前端代码审查技能 │ │ ├── prompt.md │ │ ├── agent.md │ │ └── config.yaml │ └── git-commit/ # Git 提交信息生成技能 │ ├── prompt.md │ └── agent.md ├── targets/ # 目标目录映射给三个工具分别创建符号链接 │ ├── cursor/ │ ├── claude/ │ └── antigravity/ ├── sync.config.js # 同步配置文件 └── .gitignore初始化这一步不要跳过了它会把目录骨架、配置文件模板一起生成出来。3.2 创建三款工具的目录映射接下来是最关键的步骤把三种工具的 Skills 目录映射到targets下的子目录。这里的核心思路是为每一个目标工具建立符号链接让同步工具能够直接写入目标工具的读取位置。在 macOS 和 Linux 下这样操作# 创建 targets 子目录 mkdir -p targets/cursor mkdir -p targets/claude mkdir -p targets/antigravity # 建立到工具实际目录的符号链接 ln -s ~/.cursor/skills targets/cursor ln -s ~/.claude/skills targets/claude ln -s ~/.antigravity/skills targets/antigravityWindows WSL 环境下符号链接路径需要改成相应工具在 WSL 内的配置路径。如果你用的是原生 Windows Cursor 或 Claude Code 桌面版路径会指向 Windows 用户目录比如/mnt/c/Users/你的用户名/.cursor/skills这种情况下建议在 WSL 内配置工具链否则符号链接跨文件系统容易出现权限问题。3.3 配置 sync.config.js规则是同步的灵魂sync.config.js是整个方案的核心。它告诉 skill-sync 怎么从 source 目录读取文件、怎么转换格式、最终输出到哪个 target。下面是我实际使用的配置模板module.exports { // 源目录所有技能的原始素材 sourceDir: ./source, // 目标平台配置 targets: { cursor: { type: cursor, outputDir: ./targets/cursor, // Cursor 对 .md 文件直接加载 generate: (skill) ({ [${skill.name}.md]: skill.files[prompt.md], }), }, claude: { type: claude, outputDir: ./targets/claude, // Claude Code 需要 frontmatter 元数据自动补充 generate: (skill) { const frontmatter [ ---, name: ${skill.name}, description: ${skill.config.description || }, ---, , ].join(\n); return { [${skill.name}.md]: frontmatter (skill.files[agent.md] || ), }; }, }, antigravity: { type: antigravity, outputDir: ./targets/antigravity, // Antigravity 需要配置文件 内容文件两部分 generate: (skill) { const yaml [ name: ${skill.name}, type: skill, description: ${skill.config.description || }, trigger: ${skill.config.trigger || manual}, , ].join(\n); return { [${skill.name}.yaml]: yaml, [${skill.name}.md]: skill.files[prompt.md] || skill.files[agent.md] || , }; }, }, }, // 同步策略hard 表示严格校验目标环境不允许出现源目录之外的技能文件 syncMode: soft, // 自动生成 .gitignore 中无需同步的文件 ignorePatterns: [**/.DS_Store, **/*.tmp], };这个配置文件看起来很复杂其实逻辑很简单每个工具的generate函数就是一个翻译器把统一的源文件转换成目标工具能识别的格式。你每增加一个技能只需要在source目录下新建子目录并放入对应文件就行其他交给同步工具处理。3.4 首次同步实际跑一遍看效果配置完成后执行同步命令skill-sync sync正常情况下工具会扫描source目录下的每个子目录依次执行三个目标平台的转换逻辑然后把生成的文件写入对应的targets目录。首次同步完成后建议先到三个工具目录里检查一下文件是否都到位了。在我的测试环境中输出结果大概是这样的✔ Skill frontend-review synced to cursor (~/.cursor/skills/frontend-review.md) ✔ Skill frontend-review synced to claude (~/.claude/skills/frontend-review.md) ✔ Skill frontend-review synced to antigravity (~/.antigravity/skills/frontend-review.yaml .md) ✔ Skill git-commit synced to cursor (~/.cursor/skills/git-commit.md) ✔ Skill git-commit synced to claude (~/.claude/skills/git-commit.md) ✔ Skill git-commit synced to antigravity (~/.antigravity/skills/git-commit.yaml .md) Sync complete in 1.8s看到所有技能都成功同步之后我还多做了一个验证动作分别打开三个工具在对话框中输入触发词确认技能已经被加载。这一步非常值得做因为文件写进去了和工具实际加载了有时候是两回事尤其是 Claude Code 依赖配置文件启停技能光有文件而不检查配置可能会漏掉。3.5 完整源文件示例一个真正能用的前端审查技能为了让上面的配置不显得空洞我把frontend-review这个技能的源文件内容简化展示一下。source/frontend-review/prompt.md的内容你是资深前端工程师请用严格但务实的态度审查以下代码。 审查重点 1. 组件拆分的合理性——是否过度抽象或相反过于庞大 2. 状态管理的使用是否恰当避免不必要的全局状态 3. Hooks 依赖是否完整是否存在闭包陷阱 4. 样式方案是否一致避免内联样式与样式文件混用 5. 可访问性基础要求img 是否有 alt按钮是否有可读文本 输出格式要求 - 问题列表按严重程度排序高/中/低 - 每个问题必须附上具体代码位置和修改建议 - 不要泛泛而谈直接指出文件路径和行号 - 结尾给出一个修改优先级的汇总表 检查清单 - [ ] 是否存在 console.log 残留 - [ ] 是否存在 any 类型滥用 - [ ] 是否存在未使用变量或 import - [ ] 是否存在刻意忽略的 eslint 警告source/frontend-review/agent.md的内容更加精简面向 Claude Code 的 Agent 场景增加了环境检测与脚本调用的描述。source/frontend-review/config.yaml的内容name: frontend-review description: 执行前端代码审查输出结构化问题列表 trigger: frontend review有了这三个文件作为一整套素材同步工具就能各取所需Cursor 只用prompt.mdClaude Code 用agent.md加上自动生成的 frontmatterAntigravity 使用config.yaml做注册、用prompt.md做提示词正文。一套素材三端分发。4. 自动化同步与版本管理让更新不再依赖手动执行skill-sync 解决了文件转换和搬运的问题但如果你是一个临时想改一个技能描述然后立刻在三个工具里生效的人每次都手动敲 sync 命令还是有点烦人。这一节讲怎么把同步过程自动化并且用 Git 把整个技能库管起来做到随时可回滚、可追溯。4.1 文件监听自动同步保存即生效skill-sync 自带watch模式开启后它会监视source目录下的任何文件变化一旦检测到新增、修改或删除就立即自动重新同步。skill-sync watch在 macOS 和 Linux 上这个监听模式使用系统原生文件事件响应速度很快基本是保存后 1 秒内完成同步。Windows 下如果使用 WSL监听非 Windows 路径时可能会有轻微延迟但实测下来基本可以接受。把这个命令放到后台运行我个人的做法是用一个简单的脚本#!/bin/bash # auto-sync.sh # 挂起后台任务并记录日志 nohup skill-sync watch /tmp/skill-sync.log 21 echo skill-sync watching started, pid: $!每次启动电脑后运行一次这个脚本后续你就可以彻底忘掉同步这件事。改完源文件三个工具自动收到更新。4.2 交叉检查同步是否正确不能只靠肉眼自动化很爽但也要防止自动错到底。我的经验是每次大改之后跑一次交叉检查确认三个工具的加载状态。Cursor在设置面板里搜索skills确认新技能是否出现在列表中。如果没出现检查项目目录下是否放了同名技能文件因为项目级优先于全局级。Claude Code在对话中输入/skills或者直接调用技能名看是否能触发。如果没生效打开~/.claude/settings.json确认新技能没有被显式禁用。Antigravity在配置管理界面查看技能列表确认 yaml 注册文件被正确读取。如果没生效重点检查 yaml 文件中trigger字段是否合法这个字段格式写错了 Antigravity 会直接跳过。另外用 Git 可以方便地对比每次同步产生了哪些差异。在仓库目录执行git diff如果发现某个目标目录里出现了不是由源文件生成的额外文件就要注意了——很可能是工具自己生成的状态文件被同步工具误当成了技能文件。此时在.gitignore里显式排除这些文件即可。4.3 Git 版本管理一处改动处处留痕所有源文件都在 Git 仓库里管理这是整套方案的保险丝。每次修改技能建议遵循一个简单的提交规范git add source/ git commit -m feat(skills): 增强前端审查技能的错误等级判断逻辑提交信息尽量写清楚改了什么和为什么改。这样即使三周后某个技能出了问题你也能用git log查找历史用git revert回到之前的可用版本。团队协作场景下可以把仓库托管到 GitLab 或 GitHub。成员拉取最新代码后只需要在自己的机器上执行一次skill-sync sync就能获得和团队完全一致的技能库。这也意味着团队内部的经验沉淀从口头传变成了代码审质控更透明。5. 常见问题与排查技巧实录搭建过程中我踩了不少坑这里挑典型问题和排查方法整理出来供大家参考。5.1 Cursor 不加载全局 Skills 目录下的技能如果你确定文件已经同步到~/.cursor/skills但 Cursor 里就是看不到绝大多数情况是项目级同名技能覆盖导致的。Cursor 的加载优先级是项目优先于全局所以先检查当前项目目录下是否有.cursor/skills目录有的话临时重命名测试一下。排除了同名覆盖后重启 Cursor 再看。Cursor 对技能列表的缓存比较顽固有时不会实时刷新。注意是完全退出再打开不是简单关闭窗口。5.2 Claude Code 技能显示已注册但无法触发这种能看到技能列表但调用没反应的问题常见原因有frontmatter 元数据缺失或不完整。Claude Code 依赖 frontmatter 里的 name 和 description 来决定触发时机如果 description 为空或者不够精确模型就不会主动调用。技能描述里的触发词和目标场景差异太大。比如你的技能叫frontend-reviewdescription 里写着review frontend code但你在对话里说的是帮我看看这段 React 代码有什么问题模型可能不认为是同一个任务。解决办法把描述写得贴近实际对话习惯。多用用户大概率的说法比如检查前端代码质量、审查组件设计比perform source code analysis这种抽象描述实用得多。5.3 Antigravity 提示 eligibility check failed技能目录没同步进工具我遇到这个问题时一开始很困惑因为目录是对的、文件也在但工具就是提示账号或环境资格校验失败导致技能根本没加载。排查后发现 Antigravity 的资格校验可能会受系统时间、地区信息等干扰建议确认系统时间与网络时间同步检查是不是使用了代理工具影响了工具访问配置文件卸载并重装最新版 Antigravity旧版本对自定义配置目录的支持有 bug如果确认是工具版本问题重装后重新执行skill-sync sync即可。5.4 同步命令报权限错误EACCES在 macOS 和 Linux 下如果使用npm install -g安装 skill-sync或者目标目录的权限不足执行同步时会遇到 EACCES 错误。处理方式有两种# 方法一修改目标目录权限推荐简单直接 chmod -R uw ~/.cursor/skills ~/.claude/skills ~/.antigravity/skills # 方法二使用 sudo 执行注意sudo 可能导致符号链接路径解析异常不推荐 sudo skill-sync sync我遇到过最隐蔽的情况是~/.claude/skills目录的属主变成了 root这种情况直接改回当前用户即可sudo chown -R $USER:$USER ~/.claude/skills5.5 常见问题速查表问题现象可能原因排查方向解决方案Cursor 看不到新技能项目级同名文件覆盖检查.cursor/skills项目目录删除或重命名项目级同名文件Cursor 技能不刷新缓存未更新检查技能列表时间戳完全退出并重启 CursorClaude Code 技能不触发frontmatter 缺失打开生成后的 md 文件查看头部更新源文件的 agent.md 补充元数据Claude Code 报错无法加载配置禁用了技能查看settings.json在配置中启用对应技能Antigravity 技能不显示yaml 注册格式错误查看 yaml 中 trigger 字段修正注册字段格式同步报 EACCES目录权限不足查看目录属主chmod 或 chown 恢复权限符号链接失效工具目录被移动ls -l查看链接状态重新创建符号链接自动同步不生效watch 未终止或崩溃查看/tmp/skill-sync.log重启 watch 进程5.6 独家避坑技巧不要忽略符号链接的落盘路径最后分享一个特别容易被忽略的坑。使用符号链接时如果你在source目录里新建了一个技能并同步成功再查看~/.cursor/skills目录会发现文件是通过符号链接映射过去的看起来一切正常。但如果你用的工具比如某些版本 Antigravity内部做了路径规范化会先解析符号链接的真实路径再去读文件而真实路径指向的是你的仓库目录。一旦仓库目录被移动、重命名或通过网盘同步改变了路径工具就找不到技能文件了。解决方案有两种一是尽量保持仓库路径稳定不要放在临时目录或经常改名字的文件夹里二是为 Antigravity 单独创建一个纯拷贝模式把同步目标从符号链接改为真实目录拷贝。// sync.config.js 中为 antigravity 单独配置 antigravity: { type: antigravity, outputDir: ./targets/antigravity, // 强制使用物理拷贝而非符号链接 linkStrategy: copy, // 其余配置不变 }这样虽然每次同步会多花一点点时间但换来的是对工具路径解析异常的抗性很划算。6. 这套方案的边界与扩展思路统一管理工具解决了我 90% 的痛点但也有一些场景它并不擅长这里额外说明一下避免大家抱有过高期待。6.1 不适合用这套方案的场景临时性的、一次性的技能如果你只是某个下午调试一个库写了个临时技能用完就要删特意录入中央仓库再同步反而增加操作成本。这种场景直接在工具对应目录下手写文件即可。高度依赖工具私有特性的技能如果某个技能大量调用了 Cursor 独有的 UI 交互功能或者 Antigravity 的独家 Agent API把它强行统一到三个平台意义不大而且转换过程中信息会丢失。团队尚未形成技能维护习惯统一方案需要所有人养成新增技能必须进中央仓库的习惯如果团队各自为政仓库很快会变成摆设。6.2 可以继续扩展的方向skill-sync 不只是解决 Cursor、Claude Code 和 Antigravity 三工具同步。它的架构支持自定义 target理论上你还可以接入其他 AI 工具比如 Codex、OpenCode 等。只需要在配置里增加一个新 target定义好目录和文件生成规则就能达到同样的效果。此外把 GitHub 仓库作为中央源配合 GitHub Actions 在 push 后自动执行skill-sync sync可以形成一个 CI/CD 式的技能分发链路。团队成员提 MR 后自动更新到各自环境体验会更顺滑。我在实际使用中最舒服的一点就是不再需要记忆哪个技能在哪个工具里所有技能都在一个地方打开就能改改完自动同步。如果你的工作流里也同时存在多个 AI 编程工具这套方案值得花一个小时搭起来省下的是后面无数次的复制粘贴。