Skill 数据结构

Skill API 复用的响应与包结构。

​

Skill 对象

创建、查询、列表和更新接口都会返回该结构。

字段	类型	说明
id	string	Skill ID，前缀为 skill_
type	string	固定值 "skill"
display_title	string	由已存储 Skill 名称派生的展示标题
description	string	来自 SKILL.md 的 Skill 描述
source	string	可选值：custom、qoder
latest_version	string	最新版本号，字符串格式
metadata	object	与 Skill 一起存储的自定义元数据对象；省略时为 {}
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 附加领域专业知识。