---
title: "Get Chat Skill"
method: GET
path: "/api/v1/chat-ai/skills/{slug}"
tags: ["chat-ai", "chat_skills"]
---

# Get Chat Skill

`GET /api/v1/chat-ai/skills/{slug}`

Read one CUSTOM skill including its instructions.

Builtin and curated instructions are managed and never returned here (403).

## Path parameters

- `slug` string, required

## Response `200`

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

- `403` — This skill's instructions are managed
- `404` — Unknown skill
- `422` — Validation Error

## Changes

> 26 revisions in range; 1 not diffed.

- **2026-09-03** `d65b8fefae34` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Change history](https://skmtc.dev/getanana/apis/cleon-api/changes/api/v1/chat-ai/skills/:slug/get.md)

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getanana/apis/cleon-api/revisions/4df7b22a7dae?raw)