skill_idstring uuid required
parent_revision_idstring uuid nullable required
The revision this one was edited from; null for the first.
contentstring required
The whole SKILL.md as written: frontmatter, then the instructions.
descriptionstring required
What the skill is for, from the frontmatter; agents read it to decide when to load the skill.
metadataobject required
The frontmatter's metadata map, as written.
licensestring nullable required
The license the frontmatter names; null when none.
instructionsstring required
The instructions an agent follows once it loads the skill: the SKILL.md body after the frontmatter.
content_format'skill/v1' required
Versions of the SKILL.md dialect; evolves additively, never in
place. skill/v1 is the agentskills.io shape the skillv1 write gate
enforces.
status'draft' | 'published' | 'superseded' required
authored_by_user_idstring uuid required
content_versioninteger required
Changes each time this revision is edited in place; send it back as parent_content_version.
created_atstring date-time required
When the revision was created.
updated_atstring date-time required
When the revision last changed: an edited draft or a status change.