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

# List Skills

> List the skills the caller can see.

Lists the skills the caller can see, the same list as the Skills page in the Wordsmith app. A skill is a set of instructions the Wordsmith agent follows when a request matches its description, with files such as references and scripts.

The list holds the caller's own skills, skills shared with them, their organisation's skills, and the public and community skills from Wordsmith. Skills come back sorted by name. Read one in full with [Get Skill](https://wordsmithai.mintlify.site/api-reference/skills/get-skill.md).

## Authentication

Requires an API key, or an OAuth token with `skills:read`.

## Query parameters

**query** `string`

Only skills whose name or description contains this text.

**visibility** `string`

Only skills with this visibility: `private`, `customer`, `public` or `community`.

**cursor** `string`

The `cursor` from the previous page.

**limit** `integer` (default: 50)

Skills per page, up to 100.

## Response

Returns `200` with a page of skills.

**visibility** `string`

`private` for the caller's own skills and skills shared with them, `customer` for the organisation's, `public` for Wordsmith's and `community` for community skills.

**editable** `boolean`

Whether the caller can change the skill with [Update Skill](https://wordsmithai.mintlify.site/api-reference/skills/update-skill.md). Public and community skills are never editable.

**url** `string`

The skill in the Wordsmith app: its editor when the caller can change it, otherwise the Skills page. Opening it needs a Wordsmith sign-in.

```bash cURL theme={null}
curl "https://api.wordsmith.ai/api/v1/skills?query=NDA" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"
```

```json Response theme={null}
{
  "items": [
    {
      "id": "5f0d2c1e-8a47-4b6e-9c31-2d7e4a9b6f10",
      "name": "nda-review",
      "description": "Review an inbound NDA against our standard positions.",
      "visibility": "private",
      "editable": true,
      "url": "https://app.wordsmith.ai/skills/new?mode=edit&skillId=5f0d2c1e-8a47-4b6e-9c31-2d7e4a9b6f10",
      "created_at": "2026-10-19T09:12:04Z",
      "updated_at": "2026-10-19T09:12:04Z"
    }
  ],
  "cursor": null
}
```

## Errors

| Status | `error_code` | When |
| - | - | - |
| 400 | `bad_request` | `visibility` is not one of the four values, `limit` is out of range, or `cursor` is not one this API returned. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.