v1
skills

Upload a copilot skill from a SKILL.md file

Changed on

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

Request

  • The document declares no server URL.
  • Auth
    HTTP bearer

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[]
originstring nullable
updatestring nullable

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the new optional query request parameter expert_id