> For the complete documentation index, see [llms.txt](https://doc.duaer.com/zh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/zh/getting-started/install-skills.md).

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

把 Duaer 技能放进智能体会扫描的文件夹，确认它出现在列表里，再按名字调用。同一个 SKILL.md 在 Cursor、Claude Code 和 Codex 里都能用。
## 各家从哪里读技能

- 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](https://skills.duaer.com/) 选一个技能，或在 [Duaer 数据市场](/zh/getting-started/data-market.md) 点「复制技能」。
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/。
## Questions

### Duaer 技能要为每个智能体各写一份吗？

不用。一个 Duaer 技能就是一个 SKILL.md，把同一个文件夹放到每家会读的位置即可。

### 为什么要删掉 skills.duaer.com 页面的第一行？

skills.duaer.com 的 Duaer 技能页面开头有一行给读者看的索引。智能体只在 --- 位于第一行时才读取技能头信息，原样保存的 Duaer 技能可能不会自动启动。

### 安装 Duaer 技能会用额度吗？

不会。Duaer 只在数据技能执行检索并返回结果时扣额度。

## 相关

- [在 Duaer 里使用数据市场](https://doc.duaer.com/zh/getting-started/data-market.md)
- [在 Duaer 里查天气预报](https://doc.duaer.com/zh/getting-started/weather.md)
- [Duaer 公开 API 的身份验证](https://doc.duaer.com/zh/api/authentication.md)