SKILL.md file (instructions only) or a bundle: a .zip (or .skill) archive containing SKILL.md plus any reference files your skill needs (templates, examples, helper scripts, etc.).name field in SKILL.md frontmatter, so you don't pass it separately.name, description, license, compatibility, metadata, allowed-tools. Any other field is rejected with 422.name: lowercase letters, digits, hyphens; ≤64 chars; no leading/trailing or consecutive hyphens (ASCII only).description: required, ≤1024 chars.compatibility: optional, ≤500 chars..zip/.skill bundle ≤50 MB on both the compressed upload and its summed uncompressed files (default limits). An upload over its limit is rejected with 413 http_413 while it is received, or with 400 http_400 once it is opened (e.g. a bundle that grows past the limit when unpacked).skill_frontmatter_invalid with a field_errors list..skill accepted as an alias for .zip bundle uploads.curl --location --globoff 'https:///skills-service/api/v2/skills' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer ' \
--form 'file="(a SKILL.md file, or a .zip or .skill bundle)"'{
"success": true,
"message": "Skill 'my-skill' uploaded",
"data": {
"skill": {
"id": 42,
"name": "my-skill",
"description": "My skill description.",
"type": "bundle",
"org_id": 7,
"is_enabled": true,
"is_draft": false,
"is_default": false,
"created_by": "[email protected]",
"created_on": "2026-05-21T12:00:00Z",
"modified_by": "[email protected]",
"modified_on": "2026-05-21T12:00:00Z"
},
"type": "bundle",
"items": [
{
"file_path": "SKILL.md",
"size": 1024
},
{
"file_path": "references/notes.md",
"size": 512
}
],
"meta": {
"file_count": 2,
"total_size_bytes": 1536
}
}
}