Create Skill

$ ant beta:skills create

POST/v1/skills

Create Skill

Parameters

--file: array of string

Body param: 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-title: optional string

Body param: Display title for the skill.

This is a human-readable label that is not included in the prompt sent to the model.

--beta: optional array of AnthropicBeta

Header param: Optional header to specify the beta version(s) you want to use.

Returns

BetaSkillNewResponse: object{ id, created_at, display_title, 4 more }

id: string

Unique identifier for the skill.

The format and length of IDs may change over time.

created_at: string

ISO 8601 timestamp of when the skill was created.

display_title: string

Display title for the skill.

This is a human-readable label that is not included in the prompt sent to the model.

latest_version: string

The latest version identifier for the skill.

This represents the most recent version of the skill that has been created.

source: string

Source of the skill.

This may be one of the following values:

"custom": the skill was created by a user
"anthropic": the skill was created by Anthropic

type: string

Object type.

For Skills, this is always "skill".

updated_at: string

ISO 8601 timestamp of when the skill was last updated.

Create Skill

ant beta:skills create \
  --api-key my-anthropic-api-key \
  --file 'Example data'

{
  "id": "skill_01JAbcdefghijklmnopqrstuvw",
  "created_at": "2024-10-30T23:58:27.427722Z",
  "display_title": "My Custom Skill",
  "latest_version": "1759178010641129",
  "source": "custom",
  "type": "type",
  "updated_at": "2024-10-30T23:58:27.427722Z"
}

Returns Examples

{
  "id": "skill_01JAbcdefghijklmnopqrstuvw",
  "created_at": "2024-10-30T23:58:27.427722Z",
  "display_title": "My Custom Skill",
  "latest_version": "1759178010641129",
  "source": "custom",
  "type": "type",
  "updated_at": "2024-10-30T23:58:27.427722Z"
}