> ## 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 レスポンスとパッケージの共通構造。

## Skill オブジェクト

create、get、list、update エンドポイントで返却されます。

| フィールド              | 型      | 説明                                               |
| ------------------ | ------ | ------------------------------------------------ |
| `id`               | string | `skill_` プレフィックス付きの Skill ID                     |
| `type`             | string | 固定値 `"skill"`                                    |
| `display_title`    | string | 保存された Skill 名から導出される表示タイトル                       |
| `description`      | string | `SKILL.md` からの Skill の説明                         |
| `source`           | string | 有効な値：`custom`、`qoder`                            |
| `latest_version`   | string | 文字列形式の最新バージョン番号                                  |
| `metadata`         | object | Skill に保存されるカスタムメタデータオブジェクト。デフォルトは `{}`          |
| `content`          | string | コンテンツを含む get エンドポイントでリクエストされた場合のみ存在。base64 エンコード |
| `content_encoding` | string | `content` とともに存在。値は `base64`                     |
| `created_at`       | string | 作成時刻                                             |
| `updated_at`       | string | 最終更新時刻                                           |

## Skill バージョンオブジェクト

list versions で返却されます。

| フィールド            | 型       | 説明             |
| ---------------- | ------- | -------------- |
| `skill_id`       | string  | Skill ID       |
| `version`        | string  | バージョン文字列       |
| `content_size`   | integer | コンテンツサイズ（バイト）  |
| `content_sha256` | string  | SHA-256 ダイジェスト |
| `status`         | string  | Skill のステータス   |
| `created_at`     | string  | 作成時刻           |
| `updated_at`     | string  | 最終更新時刻         |

## Skill パッケージ

作成リクエストでは `multipart/form-data` で `.zip` パッケージをアップロードします。

| ルール       | 説明                                     |
| --------- | -------------------------------------- |
| ファイル拡張子   | `.zip`                                 |
| 最大サイズ     | 5 MB                                   |
| 必須マニフェスト  | アーカイブのルートまたはルート直下のディレクトリにある `SKILL.md` |
| 必須フロントマター | `name` と `description`                 |

## 関連項目

<CardGroup cols={2}>
  <Card title="Agent スキル" icon="sparkles" href="/ja/cloud-agents/skills">
    Agent にドメインの専門知識を付与する。
  </Card>
</CardGroup>