Obtenir un Skill

Skill Skills.Retrieve(parameters, cancellationToken = default)

GET/v1/skills/{skill_id}

Obtenir un Skill

Parameters

SkillRetrieveParams parameters

required string skillID

Unique identifier for the skill.

The format and length of IDs may change over time.

string workspaceID

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

class Skill { Type = "skill"; ID; CreatedAt; /* 4 more */ }

JsonElement Type = "skill"

Object type.

For Skills, this is always "skill".

required string ID

Unique identifier for the skill.

The format and length of IDs may change over time.

required DateTimeOffset CreatedAt

ISO 8601 timestamp of when the skill was created.

formatdate-time

required string DisplayName

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.

required string LatestVersionID

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

required SkillSource Source

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

required Type Type

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:

Custom("custom")

Anthropic("anthropic")

AnthropicExample("anthropic_example")

Plugin("plugin")

required DateTimeOffset UpdatedAt

ISO 8601 timestamp of when the skill was last updated.

formatdate-time

Obtenir un Skill

SkillRetrieveParams parameters = new() { SkillID = "skill_id" };

var skill = await client.Skills.Retrieve(parameters);

Console.WriteLine(skill);

Response 200

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

Returns Examples

Response 200

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