Skip to main content
Create a skill definition. A skill is a versioned, shareable execution capability; later you can append versions, submit for review, share, and set visibility.

Endpoint

Authentication

Authorization: Bearer <jwt> or X-API-Key <sk_...>. Minimum role: contributor.

Path parameters

string
required
Workspace id.

Request body

string
Skill name.
string
Skill description.

Response

string
Skill id (skill_...).
string
Owning workspace id.
string
Owner user id.
string
Name.
string
Description.
string
Source (git / zip / hub).
string
Visibility (private / team / restricted / agent).
string
Status (draft / reviewed / shared).
string
Creation time (RFC3339).
string
Update time (RFC3339).

Example