skill
介绍
Agivar 支持通过 Skill 文件把产品能力说明给外部 AI 客户端。Skill 可以理解为一份给 AI 阅读的使用指南，用来告诉 AI 客户端：Agivar 能做什么、应该怎么调用、任务流程是什么、遇到异常时如何处理。
当 AI 客户端支持 Skill / 自定义技能时，导入 Agivar 提供的 SKILL.md 后，客户端可以更稳定地理解 Agivar 的桌面任务能力，并按照推荐流程连接 MCP、发起任务、轮询结果、读取截图证据和继续补充指令。
Skill 本身不会直接执行任务，真正执行桌面操作的是 Agivar 内置的 MCP 服务。Skill 的作用是降低 AI 客户端接入和使用 Agivar 的理解成本，让它更清楚什么时候该调用 Agivar、怎么调用、以及如何判断任务是否完成。
Skill 文件
SKILL.md 是一份给 AI 客户端阅读的能力说明文件。它不会直接连接 Agivar，也不会替代 MCP 配置；它的作用是告诉 AI 客户端：Agivar 适合处理哪些桌面任务、在调用 Agivar MCP 工具时应该遵循什么流程、如何判断任务是否完成，以及遇到异常时应该如何处理。
如果你的 AI 客户端支持 Skill / 自定义技能，导入 Agivar 提供的 SKILL.md 后，客户端在遇到需要真实桌面操作的任务时，可以更稳定地选择 Agivar，并按推荐方式发起任务、轮询结果、续话、取消任务和读取截图证据。
Skill 文件通常会说明：
- 适合交给 Agivar 的任务类型
- 不适合使用 Agivar 的任务类型
- 推荐的任务描述写法
- 调用工具时的推荐流程
- 如何续话、取消任务和读取结果
- 如何根据总结、观察记录和截图判断任务是否完成
- 使用 Agivar 时的注意事项
技能在哪里可以找到
打开 Agivar，点击左侧头像区域旁的设置图标，在弹出的菜单中选择“扩展中心”，然后点击顶部的“技能”标签页。
扩展中心包含“技能”和“MCP”两个页签。“技能”页签用于查看、安装、启用、停用或删除 Skill；“MCP”页签用于管理 MCP 相关配置。
安装 Skill
进入扩展中心的“技能”页签后，点击右上角“+ 安装技能”，然后选择包含 SKILL.md 的文件夹。安装成功后，该 Skill 会出现在技能列表中。
安装 Skill 时选择的是文件夹，不是单独选择 SKILL.md 文件。一个标准 Skill 文件夹中应包含 SKILL.md 文件，例如文件夹名称为 my-skill，其中包含一个 SKILL.md 文件。
安装后，Agivar 会读取 SKILL.md 中的说明，并在需要时提供给 Agent 使用。
查找已配置 Skill
进入扩展中心的“技能”页签后，可以通过搜索、筛选和视图切换查找已安装的 Skill。
如果知道 Skill 名称或关键词，可以在搜索框中输入关键词，例如 pdf、docx、xlsx 或 paper。列表会自动筛选出匹配的 Skill。
搜索框右侧提供“全部”、“内置”、“本地”三个筛选项。“全部”会显示所有已安装 Skill；“内置”只显示 Agivar 内置 Skill；“本地”只显示用户本地安装的 Skill。Skill 卡片上也会显示来源标签，例如“内置”或“本地”，方便判断该 Skill 的来源。
页面右侧可以在宫格视图和列表视图之间切换。宫格视图会以卡片形式展示 Skill，适合快速浏览；列表视图会以列表形式展示 Skill，适合查看较多 Skill。
启用与停用
每个 Skill 卡片右上角都有独立开关，用于控制单个 Skill 是否启用。开关打开时，该 Skill 处于启用状态，Agent 可以使用；开关关闭时，该 Skill 处于停用状态，Agent 不会使用。
页面右上角还有“总开关”，用于控制所有 Skill 是否启用。总开关打开时，允许使用 Skill；总开关关闭时，会暂停使用全部 Skill。即使单个 Skill 的开关打开，只要总开关关闭，Skill 也不会生效。
如果只是临时停用某一个 Skill，可以关闭该 Skill 卡片上的开关。如果想暂时停用全部 Skill，可以关闭“总开关”。
删除 Skill
在 Skill 卡片上点击删除图标，可以移除该 Skill。
删除后，该 Skill 不会再出现在技能列表中，Agent 也不能继续使用它。内置 Skill 是否允许删除，以实际界面显示为准。
Skill 卡片说明
每个 Skill 会以卡片形式展示。卡片中可以看到 Skill 的名称、来源、描述，以及删除和启用状态。
- Skill 名称：用于标识该技能，例如
docx、pdf、xlsx。 - 来源标签：用于区分该 Skill 是“内置”还是“本地”。
- 描述信息：简要说明该 Skill 适合处理什么任务。
- 删除按钮：用于移除该 Skill。
- 启用开关：用于控制该 Skill 是否可被 Agent 使用。
常见问题
安装后没有看到 Skill
如果安装后没有看到 Skill，可以先确认选择的是包含 SKILL.md 的文件夹，而不是单独选择 SKILL.md 文件；再确认文件名是否为 SKILL.md。
如果文件夹和文件名都正确，可以检查当前是否停留在“技能”页签，而不是“MCP” 页签；也可以清空搜索框，或切换到“全部”筛选，避免 Skill 被搜索关键词或筛选条件过滤掉。
Skill 已安装但没有生效
-
如果 Skill 已安装但没有生效，可以先确认该 Skill 卡片右上角的开关是否打开，再确认页面右上角的“总开关”是否打开。
-
如果开关都已打开，还需要确认当前任务是否符合该 Skill 的适用场景。Skill 是由 Agent 根据任务内容自动选择使用的；如果任务和 Skill 的说明不匹配，Agent 可能不会调用该 Skill。
-
如仍未生效，可以尝试重启 Agivar。