# Create a skill

> Create a draft skill with a starter SKILL.md.

Source: https://docs.generalinput.com/api/skills/create



<Endpoint method="POST" path="/v1/skills" />

<Access scope="skills:manage" />

## Body [#body]

| Field  | Type   | Required | Notes                                         |
| ------ | ------ | -------- | --------------------------------------------- |
| `name` | string | no       | Up to 255 characters. Generated when omitted. |

## Response [#response]

`201 Created` with the skill detail (the same shape as one entry of [list skills](/api/skills/list)). The starter `SKILL.md` carries a slugified `name` in its frontmatter; the cloud name re-syncs from that frontmatter on every publish.