List Skills

SkillListPageResponse Beta.Skills.List(, )

GET/v1/skills

List Skills

ParametersExpand Collapse

SkillListParams parameters

Long limit

Query param: Number of results to return per page.

Maximum value is 100. Defaults to 20.

string? page

Query param: 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.

string? source

Query param: 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

IReadOnlyList<AnthropicBeta> betas

Header param: Optional header to specify the beta version(s) you want to use.

ReturnsExpand Collapse

class SkillListPageResponse:

required IReadOnlyList<SkillListResponse> Data

List of skills.

required string ID

Unique identifier for the skill.

The format and length of IDs may change over time.

required string CreatedAt

ISO 8601 timestamp of when the skill was created.

required string? DisplayTitle

Display title for the skill.

This is a human-readable label that is not included in the prompt sent to the model.

required string? LatestVersion

The latest version identifier for the skill.

This represents the most recent version of the skill that has been created.

required string Source

Source of the skill.

This may be one of the following values:

"custom": the skill was created by a user
"anthropic": the skill was created by Anthropic

required string Type

Object type.

For Skills, this is always "skill".

required string UpdatedAt

ISO 8601 timestamp of when the skill was last updated.

required Boolean HasMore

Whether there are more results available.

If true, there are additional results that can be fetched using the next_page token.

required string? NextPage

Token for fetching the next page of results.

If null, there are no more results available. Pass this value to the page_token parameter in the next request to get the next page.

List Skills

SkillListParams parameters = new();

var page = await client.Beta.Skills.List(parameters);
await foreach (var item in page.Paginate())
{
    Console.WriteLine(item);
}

Response 200

{
  "data": [
    {
      "id": "skill_01JAbcdefghijklmnopqrstuvw",
      "created_at": "2024-10-30T23:58:27.427722Z",
      "display_title": "My Custom Skill",
      "latest_version": "1759178010641129",
      "source": "custom",
      "type": "type",
      "updated_at": "2024-10-30T23:58:27.427722Z"
    }
  ],
  "has_more": true,
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}

Returns Examples

Response 200

{
  "data": [
    {
      "id": "skill_01JAbcdefghijklmnopqrstuvw",
      "created_at": "2024-10-30T23:58:27.427722Z",
      "display_title": "My Custom Skill",
      "latest_version": "1759178010641129",
      "source": "custom",
      "type": "type",
      "updated_at": "2024-10-30T23:58:27.427722Z"
    }
  ],
  "has_more": true,
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}

{ "data": [ { "id": "skill_01JAbcdefghijklmnopqrstuvw", "created_at": "2024-10-30T23:58:27.427722Z", "display_title": "My Custom Skill", "latest_version": "1759178010641129", "source": "custom", "type": "type", "updated_at": "2024-10-30T23:58:27.427722Z" } ], "has_more": true, "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo=" }