Create a NEO skill

`POST /skill`

Creates a skill. slug is the cortex reference name; it defaults to a slug of name and is immutable after creation. content is the skill.md markdown body. Validated via an ephemeral agent before saving; a create snapshot is appended to the skill history.

Request body

namestringbodyrequired

No description.

slugstringbody

Stable cortex reference name. Defaults to a slug of name.

aiAgentIdintegerbody

Owning agent (private) or null (shared).

descriptionstringbody

No description.

contentstringbody

The skill.md markdown body.

Request Example

{
  "name": "string",
  "slug": "string",
  "aiAgentId": 1,
  "description": "string",
  "content": "string"
}

Responses

201 — Created

Response Example

{
  "skill": {
    "id": 1,
    "slug": "string",
    "aiAgentId": 1,
    "name": "string",
    "description": "string",
    "content": "string",
    "createdAt": "2026-01-01T12:00:00Z",
    "modifiedAt": "2026-01-01T12:00:00Z"
  },
  "success": true
}

400 — Missing name or invalid slug

409 — A skill with this slug already exists

422 — Invalid skill (validation violations returned)