> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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`         |

## 相关

<CardGroup cols={2}>
  <Card title="Agent 技能" icon="sparkles" href="/zh/cloud-agents/skills">
    为 Agent 附加领域专业知识。
  </Card>
</CardGroup>