Skills

Create a skill

Creates an authored workspace skill from non-empty name and instructions. description explains when to select it; activation_keywords are search aliases, not automatic triggers. Returns skill_id and provenance without running work. Oversized instructions return 413; disabled cloud-agent configuration returns 503.

<sub>Scope: skills:write</sub>

post/v3/organizations/{orgId}/skills

Request

  • Base URL: https://api.reasonmachines.com
  • URL: https://api.reasonmachines.com/v3/organizations/{orgId}/skills
  • Auth: HTTP bearer

Request body

namestring required
descriptionstring

Describe what the skill does and when an agent should use it. Reason uses this description for semantic selection.

instructionsstring required
activation_keywordsstring[]

Optional search aliases retained for compatibility. They improve explicit search but do not activate the skill automatically.

is_enabledboolean
installation_scope'personal' | 'organization'

personal makes the skill visible only to the creating user; organization (the default) shares it with the Workspace.

Response

Created.

skill_idstring
namestring
descriptionstring

What the skill does and when an agent should use it. Reason uses this description for semantic selection.

instructionsstring
activation_keywordsstring[]

Optional search aliases retained for compatibility. They do not activate the skill automatically.

is_enabledboolean
installation_scope'personal' | 'organization'
authorstring
provenance'authored' | 'skills_sh' | 'git' | 'agent_plugin' | 'curated_integration' | 'builtin'
created_bystring nullable
created_atstring date-time
updated_atstring date-time

Changes

No recorded changes to this operation across all 1 revision of this API.