Agent Skills

Create agent skill

Create a new instruction-document skill for the current user.

post/api/v0/agent/skills

Request body

namestring required

The name of the skill.

descriptionstring

One-line description shown to the agent in the persona's available-skills list.

bodystring

Markdown body — the SKILL.md-style content the agent reads via the read_skill tool when invoking this skill.

Response

Successful Response

idstring uuid required

The ID of the created skill.

namestring required

The name of the skill.

descriptionstring required

The description of the skill.

bodystring

Markdown body of the skill.

created_atstring date-time required

When the skill was created.

Changes