Skills

Skills belong to the workspace. Authoring happens under /skills; attaching a skill to a bot happens under /agents/{agentId}/skills. Paths are relative to /api/workspaces/{workspaceId}.

Authoring

Method	Path	Does
GET	/skills/	List skills
POST	/skills/	Create a skill
GET	/skills/{skillId}	Read one
PATCH	/skills/{skillId}	Update
DELETE	/skills/{skillId}	Delete
GET	/skills/{skillId}/references/	List references
POST	/skills/{skillId}/references/	Add a reference
PATCH	/skills/{skillId}/references/{referenceId}	Update a reference
DELETE	/skills/{skillId}/references/{referenceId}	Delete a reference

curl -X POST https://<host>/api/workspaces/{workspaceId}/skills/ \
  -H "Authorization: Bearer $KATA_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "monthly-close",
    "description": "How to prepare the monthly financial close. Use when asked to close a month.",
    "content": "1. Export the ledger...\n2. Reconcile...\n3. Report..."
  }'

• name: lowercase letters, numbers and single hyphens, at most 64 characters, unique in the workspace.
• description: required, at most 1024 characters, no XML tags.
• content: required, Markdown.

A reference takes name, content and an optional description. The bot reads it as references/<name>.md when the skill points to it.

Attaching to a bot

Method	Path	Does
GET	/agents/{agentId}/skills/	Skills this bot has
POST	/agents/{agentId}/skills/	Attach: { "skillId": "…" }
DELETE	/agents/{agentId}/skills/{skillId}	Detach

Attaching and detaching return 204. Detaching doesn’t delete the skill.