Create Skill

Create a user- or workspace-scoped skill (system scope is read-only → 403).

Request body

scope'user' | 'workspace' | 'system' required

Tier a skill applies to.

Unlike knowledge entries, skills add a system scope: globally-available skills that are read-only through the public service/API and writable only via the internal admin override, plus the in-code create-skill playbook registry. user skills are owned by a single user, workspace skills by a workspace, system skills by neither.

namestring required

descriptionstring required

bodystring required

is_starterboolean nullable

Whether the skill is a new-project starter. Omit for the default: a workflow-type workspace skill defaults to a starter, other types and user skills do not. Only workspace skills may be starters.

skill_type'workflow' | 'enrichment' | 'agent_column'

What kind of work a skill encodes (MAIA-2976).

workflow skills run end-to-end from a blank project (the IOS skill) and are the only kind that defaults into the new-project starter gallery; enrichment skills produce a derived configuration/value (usable IOS acreage) and agent_column skills build a single agent-derived column (owner assemblages) against an existing project's data.

supersedes_skill_idstring uuid nullable

Set when customizing an existing MAIA/workspace skill: the id of the starter this copy supersedes. That original is hidden from the gallery and the agent's routing catalog in this copy's favor.

Response

Successful Response

idstring uuid required

scope'user' | 'workspace' | 'system' required

Tier a skill applies to.

Unlike knowledge entries, skills add a system scope: globally-available skills that are read-only through the public service/API and writable only via the internal admin override, plus the in-code create-skill playbook registry. user skills are owned by a single user, workspace skills by a workspace, system skills by neither.

user_idstring uuid nullable

workspace_idstring uuid nullable

namestring required

descriptionstring required

bodystring required

created_atstring date-time required

updated_atstring date-time required

is_starterboolean

Whether this skill surfaces as a first-run starter in the new-project gallery. System (Ready-made by MAIA) and workspace-scoped skills may be starters; user-scoped skills are never starters.