在 Cursor、Claude Code 和 Codex 里安装 Duaer 技能

各家从哪里读技能

• Cursor：项目里的 .cursor/skills/ 或 .agents/skills/；对所有项目生效用 ~/.cursor/skills/ 或 ~/.agents/skills/。Cursor 也会读 .claude/skills/ 和 .codex/skills/。
• Claude Code：项目里的 .claude/skills/（从启动目录往上直到仓库根目录）；对所有项目生效用 ~/.claude/skills/。
• Codex：从当前目录往上直到仓库根目录的 .agents/skills/；对所有项目生效用 ~/.agents/skills/。

每个技能一个文件夹，文件夹名和技能里的 name 一致，文件名是 SKILL.md。一个仓库要同时给三家用：真实文件夹放在 .agents/skills/（Cursor 和 Codex 都读），再复制一份到 .claude/skills/（给 Claude Code）。

安装一个 Duaer 技能

1. 在 skills.duaer.com 选一个技能，或在 Duaer 数据市场 点「复制技能」。
2. 按技能名建文件夹，例如 duaer-weather。
3. 把技能存成这个文件夹里的 SKILL.md。文件第一行必须是 ---。skills.duaer.com 的页面开头多一行索引，要删掉第一个 --- 之前的内容，下面的命令会自动处理。
4. 开一个新对话，或重启 CLI，让智能体重新扫描。

mkdir -p .agents/skills/duaer-weather
curl -s https://skills.duaer.com/weather.md | sed -n '/^---$/,$p' > .agents/skills/duaer-weather/SKILL.md
mkdir -p .claude/skills
cp -R .agents/skills/duaer-weather .claude/skills/

换成别的技能时，把 weather 换成 skills.duaer.com 上的地址名，把 duaer-weather 换成技能的 name。

确认智能体看得到

• Cursor 编辑器：在 Agent 对话里输入 / 搜索技能名，或打开 Customize → Skills。
• Cursor CLI：在 CLI 里同样输入 / 再查一次。有用户反馈编辑器能加载、CLI 却看不到同一个文件夹，两边都用就两边都查。
• Claude Code：运行 /skills，或问一句「What skills are available?」。
• Codex：运行 /skills，或输入 $ 看名字是否出现。

找不到时，依次检查文件夹名、SKILL.md 里的 name 行，以及 --- 是否在第一行。

用真实文件夹，不要用软链接

Claude Code 和 Codex 官方支持软链接的技能文件夹，但有用户反馈：软链接的技能能运行却不出现在 / 菜单里，或者在一个应用里能加载、换一个就不行。复制过去的文件夹在各处表现一致。想只维护一份源文件，就用脚本复制进去，不要做链接。

技能没自己启动时，按名字调用

• 智能体靠技能的 description 决定用不用它。没有自动启动时直接点名：Cursor 和 Claude Code 里输入 /duaer-weather，Codex 里输入 $duaer-weather。
• 装的技能很多时，智能体会截短或省略部分 description，匹配就会变差。不用的技能可以移走。

换电脑或分享给同事

• 项目级技能（.agents/skills/、.claude/skills/）提交进仓库，别人克隆就有。
• 用户级技能（~/ 下的文件夹）只在这台电脑上。换电脑时复制这些文件夹，或重新运行上面的安装命令。
• Cursor Cloud Agents 只有打开 Sync Skills for Cloud Agents 后才拿得到 ~/.cursor/skills/。Claude Code 的云端会话读仓库里提交的技能，不读你本机的 ~/.claude/skills/。