# 声网 Skills (/zh-CN/introduction/skills-integrate)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

配置 声网 Skills 后，AI Coding Agent 可以在编码前先确定声网产品路径、Starter 和接入步骤，再按官方流程完成实现。

当任务需要判断“先做什么”或“该走哪条官方路径”时，优先使用 声网 Skills。如果还需要在生成代码前查询最新官方文档，可以同时配置 [声网 MCP](/zh-CN/introduction/mcp-integrate)。

## 安装 声网 Skills [#安装-声网-skills]

<Tabs>
<TabsList>
  <TabsTrigger value="skills-cli">Skills CLI</TabsTrigger>
  <TabsTrigger value="manual">手动安装</TabsTrigger>
</TabsList>

<TabsContent value="skills-cli">

```bash
npx skills add AgoraIO/skills
```

当 Agent 检测到相关声网任务时，Skills 会自动激活。

</TabsContent>

<TabsContent value="manual">

克隆仓库，并将 AI Coding Agent 指向 声网 Skills 文件：

```bash
git clone https://github.com/AgoraIO/skills.git ~/agora-skills
```

使用 `skills/agora/` 作为目录入口。如果你的工具需要单个根文件，也可以直接加载 `SKILL.md`。

</TabsContent>
</Tabs>

手动安装时，请按工具要求放置 声网 Skills 文件：

<Tabs>
<TabsList>
  <TabsTrigger value="trae">TRAE</TabsTrigger>
  <TabsTrigger value="kimi-code">Kimi Code</TabsTrigger>
  <TabsTrigger value="codex">Codex</TabsTrigger>
  <TabsTrigger value="claude-code">Claude Code</TabsTrigger>
  <TabsTrigger value="cursor">Cursor</TabsTrigger>
  <TabsTrigger value="other-tools">其他工具</TabsTrigger>
</TabsList>

<TabsContent value="trae">

将克隆后的 `skills/agora/` 目录复制到项目中的 `.trae/skills/agora/`，并保留 `SKILL.md` 以及关联脚本和参考文件。

如果通过 Skills CLI 安装到了 `.agents/skills/`，请在 TRAE 的 **设置 > 技能与命令 > 导入设置** 中启用 `.agents` 技能目录。

安装后，可以让助手“使用声网 Skills”处理声网任务。目录和启用方式见 [TRAE 官方 Skills 文档](https://docs.trae.cn/ide_skills)。

</TabsContent>

<TabsContent value="kimi-code">

将克隆后的 `skills/agora/` 目录复制到项目中的 `.kimi-code/skills/agora/`，并保留 `SKILL.md` 以及关联文件。Kimi Code 也会扫描项目中的 `.agents/skills/`。

新建会话后，让助手“使用声网 Skills”完成任务。也可以使用 `/skill:` 加技能文件中定义的名称来调用。目录和调用方式见 [Kimi Code 官方 Skills 文档](https://www.kimi.com/code/docs/kimi-code-cli/customization/skills.html)。

</TabsContent>

<TabsContent value="codex">

将克隆后的 `skills/agora/` 目录复制到项目中的 `.agents/skills/agora/`，并保留 `SKILL.md` 以及关联脚本和参考文件。

如果希望在所有项目中使用，将该目录放到 `~/.agents/skills/agora/`。已通过 Skills CLI 安装到上述位置时，无需重复复制。

在 Codex 中输入 `$agora` 调用技能；如果尚未显示，重新启动 Codex。目录和调用方式见 [Codex 官方 Skills 文档](https://learn.chatgpt.com/docs/build-skills)。

</TabsContent>

<TabsContent value="claude-code">

将克隆后的 `skills/agora/` 目录复制到项目中的 `.claude/skills/agora/`，并保留 `SKILL.md` 以及关联脚本和参考文件。如果希望在所有项目中使用，将该目录放到 `~/.claude/skills/agora/`。

也可以在 Claude Code 会话中通过插件安装，无需手动复制技能目录：

```text
/plugin marketplace add AgoraIO/skills
/plugin install agora@agora-skills
```

插件默认安装到用户级。若需要项目级安装，在第二条命令末尾添加 `--scope project`。

插件附带的 MCP 服务使用国际站地址 `https://mcp.agora.io`。查询声网中文文档时，请按[声网 MCP 配置说明](/zh-CN/introduction/mcp-integrate)另行添加 `shengwang-docs`，并在提示词中指定使用该服务。

安装后，让助手“使用声网 Skills”处理声网任务。配置方式见 [Claude Code 官方 Skills 文档](https://code.claude.com/docs/en/skills)和[插件安装说明](https://code.claude.com/docs/en/discover-plugins)。

</TabsContent>

<TabsContent value="cursor">

将克隆后的 `skills/agora/` 目录复制到项目中的 `.cursor/skills/agora/`，并保留 `SKILL.md` 以及关联脚本和参考文件。Cursor 也会读取项目中的 `.agents/skills/`；已通过 Skills CLI 安装到该位置时，无需重复复制。

如果希望在本机的所有项目中使用，可以将该目录放到 `~/.cursor/skills/agora/`。

在 Cursor 的技能列表中确认已识别 `agora`，再让助手“使用声网 Skills”处理声网任务。目录和调用方式见 [Cursor 官方 Skills 文档](https://cursor.com/docs/skills)。

</TabsContent>

<TabsContent value="other-tools">

将工具指向 `skills/agora/` 或顶层 `SKILL.md`。

</TabsContent>
</Tabs>

## 从提示词开始 [#从提示词开始]

安装 声网 Skills 后，让 AI Coding Agent 在创建项目或编辑代码前选择正确的声网路径。

```text
使用 声网 Skills 和 声网 MCP 帮我构建一个网页端对话式 AI 引擎 Demo。
请先查询官方文档，选择合适的 Starter，并使用 声网 CLI 完成中国区项目配置。
```

接下来，让 AI Coding Agent 先确认 Starter 和接入路径，再开始创建项目或编辑代码。

## 参考资源 [#参考资源]

在 GitHub 仓库中查看声网 Skills 的技能定义、脚本和参考资料。

<Cards>
  <Card title={<RepositoryCardTitle provider="github">skills</RepositoryCardTitle>} href="https://github.com/AgoraIO/skills" />
</Cards>