> ## 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.

# List Skills

> List all skills for the authenticated user

## Overview

The List Skills endpoint returns all skills in your Mokaru account. Use this to review your skill inventory or sync with external tools.

**Common use cases:**

* **AI agent skill matching** - let your AI agent compare your skills against job requirements.
* **Resume optimization** - identify which skills to highlight for a specific role.
* **Skill gap analysis** - export skills to analyze gaps against target job descriptions.

<Note>
  **Scope required:** `skills:read` | **Rate limit:** 60 requests/min
</Note>

## Request

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

### Query Parameters

<ParamField query="limit" type="number" default="25">
  Results per page (max 100)
</ParamField>

<ParamField query="offset" type="number" default="0">
  Number of results to skip for pagination
</ParamField>

### Example

```bash theme={null}
curl "https://api.mokaru.ai/v1/skills?limit=50" \
  -H "Authorization: Bearer mk_your_key"
```

## Response

<ResponseField name="data" type="array">
  Array of skills

  <Expandable>
    <ResponseField name="id" type="string">Unique skill ID</ResponseField>
    <ResponseField name="name" type="string">Skill name</ResponseField>
    <ResponseField name="category" type="string">Skill category (e.g. Frontend, Backend, Design)</ResponseField>
    <ResponseField name="level" type="string">Proficiency level (e.g. beginner, intermediate, advanced, expert)</ResponseField>
    <ResponseField name="createdAt" type="string">ISO 8601 creation date</ResponseField>
    <ResponseField name="updatedAt" type="string">ISO 8601 last update date</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total" type="number">Total number of skills</ResponseField>
<ResponseField name="hasMore" type="boolean">Whether more pages are available</ResponseField>
<ResponseField name="limit" type="number">Current page size</ResponseField>
<ResponseField name="offset" type="number">Current offset</ResponseField>

```json theme={null}
{
  "data": [
    {
      "id": "clx1234...",
      "name": "TypeScript",
      "category": "Frontend",
      "level": "expert",
      "createdAt": "2026-01-10T10:00:00.000Z",
      "updatedAt": "2026-03-15T14:30:00.000Z"
    },
    {
      "id": "clx5678...",
      "name": "React",
      "category": "Frontend",
      "level": "advanced",
      "createdAt": "2026-01-10T10:00:00.000Z",
      "updatedAt": "2026-03-15T14:30:00.000Z"
    }
  ],
  "total": 12,
  "hasMore": false,
  "limit": 50,
  "offset": 0
}
```