Claude Platform Docs

Create Skill

$ ant skills create
POST/v1/skills

Create Skill

Parameters
--file: array of file

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.

--display-name: optional 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.

--workspace-id: optional string⁠Header parameter

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
skill: object{ type: "skill", id, created_at, 4 more }
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.

error code claude_code_key_creator_not_memberHTTP status 400

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.

error code cmek_key_disabledHTTP status 400

The workspace's customer-managed encryption key is disabled or revoked. Re-enable the key, then retry.

error code cmek_key_network_blockedHTTP status 400

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.

error code organization_on_holdHTTP status 400

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.

error code cmek_context_unavailableHTTP status 503

The workspace's encryption settings could not be read, so the request was refused. Retry in a few minutes.

Create Skill
ant skills create \
  --file path/to/file
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"
}