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" |
name | string | Skill name from SKILL.md; lowercase letters, digits, hyphens, and underscores; starts with a letter or digit; max 64 characters |
description | string | Skill description from SKILL.md |
skill_type | string | Valid values: prebuilt, custom |
content_size | integer | Uploaded content size in bytes |
content_sha256 | string | SHA-256 digest of the uploaded content |
version | integer | Skill version |
status | string | Skill status, typically active |
metadata | object | Metadata object |
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.