SKILL.md file of a single-file skill; bundle skills are not editable via this endpoint. Use this when you want to tweak the skill's description or instructions without changing reference files or doing a full bundle re-upload.description (optional): New description, 1–1024 characters. It cannot be empty; every skill needs a description.description to keep the description in SKILL.md.content (optional): New SKILL.md body text (without frontmatter). ≤ 9 MB.SKILL.md.category is not accepted here; it is managed by the platform and not editable through this endpoint.modified_on / modified_by now update on every successful edit, including a content-only edit.curl --location --globoff --request PATCH 'https:///skills-service/api/v2/skills/' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data '{
"description": "Updated description for my skill.",
"content": "# My Skill\n\nThis is the new SKILL.md body."
}'{
"success": true,
"message": "SKILL.md updated",
"data": {
"skill": {
"id": 42,
"name": "my-skill",
"description": "My skill description.",
"category": "Engineering",
"type": "single_file",
"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"
},
"file_path": "SKILL.md",
"size": 512
}
}