List Skills

client.skills.list(?, ?): PageCursor<Skill>

GET/v1/skills

List Skills

Parameters

query: SkillListParams { limit, page, source }

limit?: number

Number of results to return per page.

Ranges from 1 to 1000. Defaults to 20.

minimum1

maximum1000

page?: string | null

Pagination token for fetching a specific page of results.

Pass the value from a previous response's next_page field to get the next page of results.

source?: string | null

Filter skills by source.

If provided, only skills from the specified source will be returned:

"custom": only return user-created skills
"anthropic": only return Anthropic-created skills

Returns

Skill { id, created_at, display_name, 4 more }

List Skills

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  apiKey: process.env["ANTHROPIC_API_KEY"] // This is the default and can be omitted
});

// Automatically fetches more pages as needed.
for await (const skill of client.skills.list()) {
  console.log(skill.id);
}

{
  "data": [
    {
      "id": "skill_01JAbcdefghijklmnopqrstuvw",
      "created_at": "2024-10-30T23:58:27.427722Z",
      "display_name": "display_name",
      "latest_version_id": "latest_version_id",
      "source": {
        "type": "custom"
      },
      "type": "skill",
      "updated_at": "2024-10-30T23:58:27.427722Z"
    }
  ],
  "next_page": "next_page"
}

Returns Examples

{
  "data": [
    {
      "id": "skill_01JAbcdefghijklmnopqrstuvw",
      "created_at": "2024-10-30T23:58:27.427722Z",
      "display_name": "display_name",
      "latest_version_id": "latest_version_id",
      "source": {
        "type": "custom"
      },
      "type": "skill",
      "updated_at": "2024-10-30T23:58:27.427722Z"
    }
  ],
  "next_page": "next_page"
}