Create Skill Version
Create Skill Version
Parameters
--skill-id: stringPath parameterUnique identifier for the skill.
Unique identifier for the skill.
The format and length of IDs may change over time.
--file: array of fileFiles to upload for the skill.
Files to upload for the skill.
All files must be in the same top-level directory and must include a SKILL.md file at the root of that directory.
--beta: optional array of AnthropicBetaHeader parameterOptional header to specify the beta version(s) you want to use.
Optional header to specify the beta version(s) you want to use.
"message-batches-2024-09-24"Deprecated
"prompt-caching-2024-07-31"Deprecated
"pdfs-2024-09-25"Deprecated
"token-counting-2024-11-01"Deprecated
"token-efficient-tools-2025-02-19"Deprecated
"files-api-2025-04-14"Deprecated
"extended-cache-ttl-2025-04-11"Deprecated
"skills-2025-10-02"Deprecated
"cache-diagnosis-2026-04-07"Deprecated
"ce-user-management-2026-07-13"Deprecated
--workspace-id: optional stringHeader parameterOptional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).
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
beta_skill_version: object{ type: "skill_version", id, created_at, 3 more }
type: "skill_version"Object type.
Object type.
For Skill Versions, this is always "skill_version".
Unique identifier for this Skill Version. The id addresses the version in paths and pins it in references.
created_at: stringISO 8601 timestamp of when the skill was created.
ISO 8601 timestamp of when the skill was created.
description: stringDescription of the skill version.
Description of the skill version.
This is extracted from the SKILL.md file in the skill upload.
The Skill's immutable kebab-case slug, set at creation from the first
upload's SKILL.md frontmatter name (or its enclosing directory). Every
later upload must resolve to the same value. Also the top-level directory
of the Skill's mounted files and the base name of a downloaded archive.
skill_id: stringUnique identifier for the skill.
Unique identifier for the skill.
The format and length of IDs may change over time.
Errors
Any method can also return the general HTTP errors.
Each code below is the value of error.details.error_code in the response body.
The API key belongs to the Claude Code workspace, and the user who created it is no longer a member of the organization or of that workspace.
The workspace's customer-managed encryption key is disabled or revoked. Re-enable the key, then retry.
The key management service's network access controls blocked the request to the workspace's customer-managed encryption key. The key itself may be healthy.
Anthropic has disabled the organization for trust and safety reasons. An organization disabled for any other reason, such as billing, does not get this code. appeal_url, when present, is where the organization can appeal.
The workspace's encryption settings could not be read, so the request was refused. Retry in a few minutes.
ant beta:skills:versions create \
--skill-id skill_id \
--file path/to/file{
"id": "id",
"created_at": "2024-10-30T23:58:27.427722Z",
"description": "description",
"name": "name",
"skill_id": "skill_01JAbcdefghijklmnopqrstuvw",
"type": "skill_version"
}Returns Examples
{
"id": "id",
"created_at": "2024-10-30T23:58:27.427722Z",
"description": "description",
"name": "name",
"skill_id": "skill_01JAbcdefghijklmnopqrstuvw",
"type": "skill_version"
}