Skill data structures - Qoder

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`

Agent Skills

Attach domain expertise to your agent.

List skill versions List vaults