> ## 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 data structures

> Shared Skill response and package structures.

## Skill object

Returned by create, get, list, and update endpoints.

| Field              | Type   | Description                                                                       |
| ------------------ | ------ | --------------------------------------------------------------------------------- |
| `id`               | string | Skill ID with the `skill_` prefix                                                 |
| `type`             | string | Always `"skill"`                                                                  |
| `display_title`    | string | Display title derived from the stored skill name                                  |
| `description`      | string | Skill description from `SKILL.md`                                                 |
| `source`           | string | Valid values: `custom`, `qoder`                                                   |
| `latest_version`   | string | Latest version number as a string                                                 |
| `metadata`         | object | Custom metadata object stored with the Skill; defaults to `{}`                    |
| `content`          | string | Present only when requested by get endpoints that include content; base64 encoded |
| `content_encoding` | string | Present with `content`; value is `base64`                                         |
| `created_at`       | string | Creation time                                                                     |
| `updated_at`       | string | Last update time                                                                  |

## Skill version object

Returned by list versions.

| Field            | Type    | Description           |
| ---------------- | ------- | --------------------- |
| `skill_id`       | string  | Skill ID              |
| `version`        | string  | Version string        |
| `content_size`   | integer | Content size in bytes |
| `content_sha256` | string  | SHA-256 digest        |
| `status`         | string  | Skill status          |
| `created_at`     | string  | Creation time         |
| `updated_at`     | string  | Last update time      |

## Skill package

Create requests upload a `.zip` package with `multipart/form-data`.

| Rule                 | Description                                                    |
| -------------------- | -------------------------------------------------------------- |
| File extension       | `.zip`                                                         |
| Maximum size         | 5 MB                                                           |
| Required manifest    | `SKILL.md` at the archive root or one directory below the root |
| Required frontmatter | `name` and `description`                                       |

## Related

<CardGroup cols={2}>
  <Card title="Agent Skills" icon="sparkles" href="/cloud-agents/skills">
    Attach domain expertise to your agent.
  </Card>
</CardGroup>