---
title: "Create Chat Skill"
method: POST
path: "/api/v1/chat-ai/skills"
tags: ["chat-ai", "chat_skills"]
---

# Create Chat Skill

`POST /api/v1/chat-ai/skills`

Create a custom skill for this workspace. The slug is derived from the title.

## Request body

- ChatSkillCreate — A tenant-authored (custom) skill. The slug is server-derived from title.
  - `title` string, required
  - `description` string, required
  - `when_to_use` string, nullable
  - `category` 'reporting' | 'guests' | 'presence' | 'other', required
  - `body` string, required

## Response `201`

Successful Response

- ChatSkillReadWithBody — A skill including its instructions. Returned only where policy allows reading the content: a tenant admin's own custom skill, or any skill via the super-admin routes.
  - `slug` string, required
  - `title` string, required
  - `description` string, required
  - `when_to_use` string, nullable, required
  - `category` string, required
  - `source` 'builtin' | 'curated' | 'custom', required
  - `enabled` boolean, required
  - `locked` boolean, required
  - `body` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getanana/cleon-api/revisions/3ad158624c53/schema)