skills

Creates, updates, deletes, gets or lists a skills resource.

Overview

Name	skills
Type	Resource
Id	anthropic.skills.skills

Fields

The following fields are returned by SELECT queries:

get

Name	Datatype	Description
id	string	Unique identifier for the skill. The format and length of IDs may change over time.
latest_version_id	string	ID of the newest Skill Version — what `latest` references resolve to. Always set: a Skill holds at least one version.
display_name	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.
created_at	string (date-time)	ISO 8601 timestamp of when the skill was created.
▶source	object	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	string	Object type. For Skills, this is always `"skill"`. (skill)
updated_at	string (date-time)	ISO 8601 timestamp of when the skill was last updated.

list

Name	Datatype	Description
id	string	Unique identifier for the skill. The format and length of IDs may change over time.
latest_version_id	string	ID of the newest Skill Version — what `latest` references resolve to. Always set: a Skill holds at least one version.
display_name	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.
created_at	string (date-time)	ISO 8601 timestamp of when the skill was created.
▶source	object	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	string	Object type. For Skills, this is always `"skill"`. (skill)
updated_at	string (date-time)	ISO 8601 timestamp of when the skill was last updated.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	skill_id	anthropic-workspace-id
list	select		source, anthropic-workspace-id
delete	delete	skill_id	anthropic-workspace-id
create	exec	files	anthropic-workspace-id

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
skill_id	string	Unique identifier for the skill. The format and length of IDs may change over time.
anthropic-workspace-id	string	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. (example: wrkspc_011CZkZaBF1tNoB5wlCeusgy)
source	string	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

SELECT examples

get

Successful Response

SELECT
id,
latest_version_id,
display_name,
created_at,
source,
type,
updated_at
FROM anthropic.skills.skills
WHERE skill_id = '{{ skill_id }}' -- required
AND "anthropic-workspace-id" = '{{ anthropic-workspace-id }}'
;

list

Successful Response

SELECT
id,
latest_version_id,
display_name,
created_at,
source,
type,
updated_at
FROM anthropic.skills.skills
WHERE source = '{{ source }}'
AND "anthropic-workspace-id" = '{{ anthropic-workspace-id }}'
;

DELETE examples

delete

No description available.

DELETE FROM anthropic.skills.skills
WHERE skill_id = '{{ skill_id }}' --required
AND "anthropic-workspace-id" = '{{ anthropic-workspace-id }}'
;

Lifecycle Methods

create

Successful Response

EXEC anthropic.skills.skills.create 
@anthropic-workspace-id='{{ anthropic-workspace-id }}'
@@json=
'{
"files": "{{ files }}", 
"display_name": "{{ display_name }}"
}'
;