技能是打包后的能力集合，封装常见任务的端到端流程。在控制台 Skill 管理页面管理，可被多个智能体复用。
技能以 zip 包形式上传，zip 根目录须包含
字段说明
description 编写建议
description 的质量决定了智能体调用技能的准确性，建议包含以下信息：
在技能详情页可上传新版本。挂载到智能体时必须指定具体版本号，后续上传新版本不影响已挂载的智能体。
通过 API 上传新版本时，同样需要先获得
在智能体编辑页的技能区点击添加技能，从下拉选择技能并指定版本。通过 API 创建或更新智能体时，在
技能只支持删除，不支持归档。在技能详情页点击删除，技能将被硬删除，不可恢复。已挂载到智能体的技能引用将失效。
SKILL.md。
SKILL.md 编写规范
SKILL.md 由 YAML front matter 和 Markdown 正文两部分组成。front matter 用 --- 包裹，声明技能名称与描述，智能体据此判断何时调用；正文写执行指令，技能触发后才加载。
front matter 缺失、未用
--- 包裹或 YAML 语法错误，审查会不通过。| 字段 | 必填 | 说明 |
|---|---|---|
| name | 是 | 技能的唯一标识名称。仅限小写字母、数字和连字符，不超过 64 字符，如 data-cleaner、invoice-parser。 |
| description | 是 | 描述技能的触发条件和处理能力，直接影响调用准确率。不超过 1024 字符，不能包含尖括号。 |
- 适用的输入类型：技能处理的文件格式或数据类型。
- 支持的操作：技能可以执行的具体操作。
- 触发关键词：对话中可能出现的、应触发该技能的关键词或表达方式。
- 不适用的场景：不应触发该技能的场景，避免误调用。
上传自定义技能
- 点击自定义 Skill。
- 选择本地 zip 包（不超过 10 MB），提交后系统自动审查内容，进入
checking状态。审查通过变为active，可挂载到智能体；审查未通过变为rejected，不能挂载。
file_id，再传入创建接口。完整参数与响应字段详见 创建 Skill API。
版本管理
在技能详情页可上传新版本。挂载到智能体时必须指定具体版本号，后续上传新版本不影响已挂载的智能体。
通过 API 上传新版本时，同样需要先获得 file_id。版本号由服务端自动生成。完整参数与响应字段详见 Skill API。
挂载到智能体
在智能体编辑页的技能区点击添加技能，从下拉选择技能并指定版本。通过 API 创建或更新智能体时，在 skills 字段中指定技能 ID 与版本，详见 创建 Agent API。