Skip to main content

versions

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

Overview

Nameversions
TypeResource
Idanthropic.skills.versions

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringUnique identifier for the skill version.

The format and length of IDs may change over time.
namestringHuman-readable name of the skill version.

This is extracted from the SKILL.md file in the skill upload.
skill_idstringIdentifier for the skill that this version belongs to.
created_atstringISO 8601 timestamp of when the skill version was created.
descriptionstringDescription of the skill version.

This is extracted from the SKILL.md file in the skill upload.
directorystringDirectory name of the skill version.

This is the top-level directory name that was extracted from the uploaded files.
typestringObject type.

For Skill Versions, this is always `"skill_version"`.
versionstringVersion identifier for the skill.

Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectskill_id, version
listselectskill_id
deletedeleteskill_id, version
createexecskill_id, files
downloadexecskill_id, versionDownload a skill version's content as a zip archive.

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.

NameDatatypeDescription
skill_idstringUnique identifier for the skill. The format and length of IDs may change over time.
versionstringVersion identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").

SELECT examples

Successful Response

SELECT
id,
name,
skill_id,
created_at,
description,
directory,
type,
version
FROM anthropic.skills.versions
WHERE skill_id = '{{ skill_id }}' -- required
AND version = '{{ version }}' -- required
;

DELETE examples

No description available.

DELETE FROM anthropic.skills.versions
WHERE skill_id = '{{ skill_id }}' --required
AND version = '{{ version }}' --required
;

Lifecycle Methods

Successful Response

EXEC anthropic.skills.versions.create
@skill_id='{{ skill_id }}' --required
@@json=
'{
"files": "{{ files }}"
}'
;