Listar Skills

client.Skills.List(ctx, params) (*PageCursor[Skill], error)

GET/v1/skills

Listar Skills

Parameters

params SkillListParams

Limit param.Opt[int64] OptionalQuery

Number of results to return per page.

Ranges from 1 to 1000. Defaults to 20.

minimum1

maximum1000

Page param.Opt[string] OptionalQuery

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 param.Opt[string] OptionalQuery

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

WorkspaceID param.Opt[string] OptionalHeader

Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

Returns

type Skill struct { Type: "skill"; ID; CreatedAt; /* 4 more */ }

Type Skill

Object type.

For Skills, this is always "skill".

defaultskill

ID string

Unique identifier for the skill.

The format and length of IDs may change over time.

CreatedAt Time

ISO 8601 timestamp of when the skill was created.

formatdate-time

DisplayName string

Human-readable, single-line label for the Skill. Maximum 255 characters. Always set: derived from the SKILL.md frontmatter name when omitted at creation. Not unique.

LatestVersionID string

ID of the newest Skill Version — what latest references resolve to. Always set: a Skill holds at least one version.

Source SkillSource

Where the Skill comes from.

Possible values:

"custom": authored by the platform user; private to their workspace
"anthropic": published by Anthropic; shared and read-only
"anthropic_example": Anthropic-published sample Skill
"plugin": resolved from an installed plugin

Type SkillSourceType

Where the Skill comes from.

Possible values:

"custom": authored by the platform user; private to their workspace
"anthropic": published by Anthropic; shared and read-only
"anthropic_example": Anthropic-published sample Skill
"plugin": resolved from an installed plugin

One of the following:

const SkillSourceTypeCustom SkillSourceType = "custom"

const SkillSourceTypeAnthropic SkillSourceType = "anthropic"

const SkillSourceTypeAnthropicExample SkillSourceType = "anthropic_example"

const SkillSourceTypePlugin SkillSourceType = "plugin"

UpdatedAt Time

ISO 8601 timestamp of when the skill was last updated.

formatdate-time

Listar Skills

package main

import (
	"context"
	"fmt"

	"github.com/anthropics/anthropic-sdk-go"
	"github.com/anthropics/anthropic-sdk-go/option"
)

func main() {
	client := anthropic.NewClient(
		option.WithAPIKey("my-anthropic-api-key"),
	)
	page, err := client.Skills.List(context.TODO(), anthropic.SkillListParams{})
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", page)
}

Response 200

{
  "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

Response 200

{
  "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"
}