Skill 对象
创建、查询、列表和更新接口都会返回该结构。| 字段 | 类型 | 说明 |
|---|---|---|
id | string | Skill ID，前缀为 skill_ |
type | string | 固定值 "skill" |
name | string | 来自 SKILL.md 的 Skill 名称；只能包含小写字母、数字、连字符和下划线，并以字母或数字开头；最长 64 字符 |
description | string | 来自 SKILL.md 的 Skill 描述 |
skill_type | string | 可选值：prebuilt、custom |
content_size | integer | 上传内容大小，单位 byte |
content_sha256 | string | 上传内容的 SHA-256 摘要 |
version | integer | Skill 版本 |
status | string | Skill 状态，通常为 active |
metadata | object | Metadata 对象 |
content | string | 仅在查询接口请求包含内容时返回；base64 编码 |
content_encoding | string | 与 content 一起返回，值为 base64 |
created_at | string | 创建时间 |
updated_at | string | 最后更新时间 |
Skill version 对象
列出版本接口返回该结构。| 字段 | 类型 | 说明 |
|---|---|---|
skill_id | string | Skill ID |
version | string | 版本字符串 |
content_size | integer | 内容大小，单位 byte |
content_sha256 | string | SHA-256 摘要 |
status | string | Skill 状态 |
created_at | string | 创建时间 |
updated_at | string | 最后更新时间 |
Skill package
创建请求使用multipart/form-data 上传 .zip 包。
| 规则 | 说明 |
|---|---|
| 文件扩展名 | .zip |
| 最大大小 | 5 MB |
| 必需 manifest | SKILL.md 位于压缩包根目录，或根目录下一级目录内 |
| 必需 frontmatter | name 和 description |
相关
Agent 技能
为 Agent 附加领域专业知识。