v51

latestOpenAPI 3.0.3agplraw.githubusercontent.com2026-08-014010324.1 KB

agent_skills

Store a skill

Create or overwrite a skill in the user's storage. The action field of the response is 'created' if a new SKILL.md was written, or 'overwritten' if an existing one was replaced.

post/ocs/v2.php/apps/assistant/api/{apiVersion}/skills

Path parameters

apiVersion'v1' required

Headers

OCS-APIRequestboolean required

Required to be true for the API request to pass

Request body

skillNamestring required

The skill's folder name (also used as the frontmatter name)

descriptionstring required

Short, agent-facing description of when to use the skill

contentstring required

Markdown body to write after the frontmatter

Response

Existing skill overwritten