Skills
安装、启用和选择可复用的 Agent 工作流程。
Skill 是一个包含 SKILL.md 的目录，其 YAML frontmatter 给出名称，并说明何时使用它。目录中的其他内容——引用资料、脚本、资源、许可证——都是支持材料。这就是全部格式，与 Claude 和 Codex 读取的格式一致，因此能在那里安装的包也能在这里安装。
Skill 可以指导 Agent 处理特定任务，但不会绕过会话模式、工具策略和权限审批。
Skill 来自哪里
Skill 在三个根目录下被发现，按就近顺序搜索：
| 归属 | 位置 | 可编辑 |
|---|---|---|
| Repo | 工作区根目录旁的 .agents/skills | 否 |
| User | 受管理的 Skills 根目录 | 是 |
| System | 随应用程序捆绑 | 否 |
加载失败的目录会与目录列表一并报告并跳过，因此一个格式错误的包不会让你失去其余的 Skill。
安装和检查
在“设置 → Agent → Skills”中，可以从文件夹安装 Skill，也可以编写、复制、编辑其文件或删除它。只有受管理的 user 根目录中的 Skill 可以修改；repo 和捆绑的 Skill 是只读的，需要先复制一份。
安装前检查：
- 包名称、用途、版本和来源是否符合预期。
SKILL.md中声明的操作步骤和触发条件。- 引用资料、资源文件和脚本内容。
- 需要的 MCP 服务、传输方式和外部地址。
- 是否允许 Agent 在未点名时隐式使用该 Skill。
Skill 可能带来真实操作
Skill 中的说明和脚本可以引导 Agent 执行命令、修改文件或调用外部工具。只安装可信来源，并在更新后重新检查差异和依赖。
启用状态与当前 turn
被发现的 Skill 默认是开启的，直到你关闭它。启用状态决定 Skill 是否会提供给每个新接纳的 user turn。会话不保留自己的 catalog：turn admission 会捕获最新的只读 catalog，而已经运行的 turn 保持其冻结的 catalog 和 Skill context。
因此一个 Skill 只有两个值得关注的状态，设置页面会同时报告：
- 当前可用——已启用，会提供给下一个 turn。
- 本 turn 已采用——运行中的 turn 已读取并正在遵循它。
启用或停用从下一个 turn 开始生效。任何操作都不会改变正在运行的模型请求。
为下一条消息选择 Skill
执行 /skills，或使用输入框中的 Skill 选择器，为下一条消息选择已启用的 Skill。选中状态只随这次提交发送，不代表永久启用。
提示中明确点名 Skill 可以减少歧义，例如：
请使用 release-check Skill 检查当前版本的发布准备情况，只做分析。如果 Skill 允许隐式调用，它的名称和描述会进入模型 catalog；任务明确匹配时 Agent 必须使用它。仅允许显式调用的 Skill 不进入该 catalog，但仍可通过点名选中。
Agent 能对 Skill 做什么
Agent 通过 skills_list 和 skills_read 读取 Skill，并可在你批准后使用 enable_skill 和 disable_skill 开启或关闭某个 Skill。编写、安装和删除 Skill 包使用普通的文件系统与命令工具——Skill 目录就是一个普通目录——因此这些操作与其他文件写入走同样的审批流程。
捆绑的 Skill Creator 和 Skill Manager 向 Agent 说明了这些工作流程。
删除
删除只移除已安装的包。历史记录会保留早期 turn 实际采用的 Skill context，删除也不会改写正在运行的 turn。应先等待当前任务结束，再整理能力。