如何把技能同步到 Claude Code、Codex、Cursor 和 OpenCode

每个工具从哪里读取

信息来自各工具的文档，2026年11月4日查阅。每个文件夹里，每个技能一个子文件夹，子文件夹里有一个 SKILL.md。

两个文件夹就能覆盖四个工具：~/.claude/skills（Claude Code、Cursor、OpenCode）和 ~/.agents/skills（Codex、Cursor、OpenCode）。

在自己电脑上只留一份：符号链接

把实际文件放在一个文件夹里，让两个位置都指向它。在 macOS 或 Linux 上：

mkdir -p ~/skills
# 先把已有的技能移进来，然后：
ln -s ~/skills ~/.claude/skills
ln -s ~/skills ~/.agents/skills

如果其中某个文件夹已经存在，先把里面的内容移到 ~/skills，删除空文件夹后再建立链接。Cursor 和 OpenCode 两个位置都读，所以会通过两条路径读到同一批文件。如果其中某个工具把一个技能显示了两次，它仍然只是一个文件：在 ~/skills 里改一次就好。

仓库也一样：对 .claude/skills 和 .agents/skills 做同样的处理，提交实际的文件夹，每个克隆仓库的人都能拿到这些技能。

全团队共用一份：MCP 服务器

符号链接和仓库适合开发者，但照顾不到在浏览器里用 Claude 或 ChatGPT 工作的同事，而且每次更新都要 git pull。这四个编程智能体也都能连接远程 MCP 服务器：

• Claude Code：claude mcp add --transport http <name> <url>
• Codex：在配置中添加一个带 url = "…" 的服务器条目（Streamable HTTP）。
• Cursor：在 MCP 设置中添加一个 Streamable HTTP 服务器。
• OpenCode：在配置中添加一个带 "type": "remote" 的服务器。

用一个服务器存放团队的技能，编程智能体、Claude 和 ChatGPT 读取的就是同一份最新内容，不用拉取，也不用重新链接。

确认工具能看到你的技能

1. 检查结构：<folder>/<skill-name>/SKILL.md，文件夹名称要和 name 字段一致。
2. 检查前置信息：name 只用小写英文字母、数字和连字符，最多 64 个字符；description 不能为空。SKILL.md 转换工具会写好这两项。
3. 开启一个新会话，问智能体有哪些技能，或者直接让它做描述中写到的任务。

常见问题

怎样让 Claude Code 的技能和 Claude 桌面版、claude.ai 保持同步？

Claude Code 读取磁盘上的文件夹；Claude 桌面版和 claude.ai 则把上传的技能保存在你的账号里。把同一个文件夹打包成 ZIP，在 Customize > Skills 中上传；或者把两边都连接到一个提供技能的 MCP 服务器。

为什么 Claude Code 看不到我的 .agents/skills 文件夹？

Claude Code 读取的是 ~/.claude/skills 和 .claude/skills，而不是 .agents/skills。按上文符号链接的步骤，把这个文件夹链接到 ~/.claude/skills 即可。