# Create Skill

> Create a new skill in the catalogue.

Canonical URL: https://docs.botyard.io/docs/api/skills/create_skill_v1_orgs__org_id__skills_post

`POST /v1/orgs/{org_id}/skills`

Create a new skill in the catalogue.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `org_id` | path | yes | string |  |

## Request body

`application/json`: SkillCreate (required)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | yes | Human-readable display name |
| `summary` | string | yes | Brief description for system prompt index |
| `scope` | SkillScope | yes | Visibility scope: org or member |
| `files` | array of SkillFileInput | yes | One or more files comprising the skill. SKILL.md should contain instructions only; name and summary are structured metadata fields, not YAML frontmatter. |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| `201` | Successful Response | SkillResponse |
| `default` | RFC 9457 Problem Details error response | ProblemDetails |

Full schemas: operation `create_skill_v1_orgs__org_id__skills_post` in the OpenAPI spec at https://api.botyard.io/openapi.json.