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
Agent Skills
Attach domain expertise to your agent.