---
title: "Draft System Skill"
method: POST
path: "/api/v1/internal/skills/draft"
tags: ["internal", "internal-skills"]
---

# Draft System Skill

`POST /api/v1/internal/skills/draft`

Draft a system skill from a plain-language prompt (LLM; no persistence).

Powers the admin "Build with MAIA" mode: the draft pre-fills the create form,
which staff review and save through the audited create path. ``current_*``
let ``prompt`` act as revision feedback on an existing draft.

## Request body

- AdminSkillDraftRequest — Draft a system skill from a plain-language description (no persistence). ``current_*`` carry an existing draft so ``prompt`` can be read as revision feedback rather than a fresh request; omit them for a first draft. The draft is reviewed and saved through ``AdminSkillWriteRequest``, so this is uncapped beyond the prompt length.
  - `prompt` string, required
  - `current_name` string, nullable
  - `current_description` string, nullable
  - `current_body` string, nullable

## Response `200`

Successful Response

- AdminSkillDraftResponse — A drafted skill's three authored fields, for pre-filling the editor.
  - `name` string, required
  - `description` string, required
  - `body` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/maia-analytics/apis/maia-api.md) · [All operations](https://skmtc.net/maia-analytics/apis/maia-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/maia-analytics/maia-api/versions/ba2b8d962161/schema)