skills

Upload a copilot skill from a SKILL.md file

Create a user-distilled skill from an uploaded SKILL.md file.

Parses the canonical frontmatter + body, then reuses :func:backend.copilot.tools.skills.store_user_skill so an uploaded skill is validated, capped, and persisted exactly like one the copilot distils via store_skill. Malformed files return 400, the per-expert cap returns 409, and an existing slug is overwritten (upsert).

post/api/skills

Query parameters

expert_idstring nullable

Store the skill as this expert's own.

Request body

contentstring required

Response

Successful Response

namestring required

descriptionstring required

triggersstring[]

Changes

Changed in 3 of the 165 revisions of this API.12

Sep 12, 2026cc0f7a7461f51See the full diff
- ○
  added the new optional query request parameter expert_id
  new-optional-request-parameter
Jun 25, 20269dd7012af81a1See the full diff
- ○
  endpoint added
  endpoint-added
Apr 30, 20268c84efcb3afb1See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
This revision also has 96 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history