> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mokaru.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Skill

> Create a new skill

## Overview

The Create Skill endpoint lets you add a new skill to your Mokaru account.

**Common use cases:**

* **AI agent skill extraction** - automatically add skills extracted from a job description or resume.
* **Profile enrichment** - add newly acquired skills to your career profile.
* **Bulk import** - add skills from an external source or assessment platform.

<Note>
  **Scope required:** `skills:write` | **Rate limit:** 20 requests/min
</Note>

## Request

```bash theme={null}
POST /v1/skills
```

### Body Parameters

<ParamField body="name" type="string" required>
  Skill name (max 100 characters)
</ParamField>

<ParamField body="category" type="string">
  Skill category, e.g. "Frontend", "Backend", "Design" (max 100 characters)
</ParamField>

<ParamField body="level" type="string">
  Proficiency level. One of: `beginner`, `intermediate`, `advanced`, `expert`
</ParamField>

### Example

```bash theme={null}
curl -X POST "https://api.mokaru.ai/v1/skills" \
  -H "Authorization: Bearer mk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "TypeScript",
    "category": "Frontend",
    "level": "expert"
  }'
```

## Response

<ResponseField name="success" type="boolean">Whether the skill was created</ResponseField>
<ResponseField name="id" type="string">The new skill's unique ID</ResponseField>

```json theme={null}
{
  "success": true,
  "id": "clx1234..."
}
```