SPB Git

Repository Public

create.md 2.8 KB 125 lines markdown

1---2title: Create Skill3url: https://platform.claude.com/docs/en/api/skills/create4---56# Create Skill78**POST** `/v1/skills`910Create Skill1112## Headers1314- `"anthropic-workspace-id": optional string`1516## Body parameters (form-data)1718- `files: array of string`1920  Files to upload for the skill.2122  All files must be in the same top-level directory and must include a SKILL.md file at the root of that directory.2324- `display_name: optional string or null`2526  Human-readable, single-line label for the Skill. Maximum 255 characters.27  Always set: derived from the SKILL.md frontmatter `name` when omitted at28  creation. Not unique.2930## Returns3132- `Skill object`3334  - `type: "skill"`3536    Object type.3738    For Skills, this is always `"skill"`.3940    default: skill4142  - `id: string`4344    Unique identifier for the skill.4546    The format and length of IDs may change over time.4748  - `created_at: string`4950    ISO 8601 timestamp of when the skill was created.5152    format: date-time5354  - `display_name: string`5556    Human-readable, single-line label for the Skill. Maximum 255 characters.57    Always set: derived from the SKILL.md frontmatter `name` when omitted at58    creation. Not unique.5960  - `latest_version_id: string`6162    ID of the newest Skill Version — what `latest` references resolve to. Always set: a Skill holds at least one version.6364  - `source: SkillSource`6566    Where the Skill comes from.6768    Possible values:6970    * `"custom"`: authored by the platform user; private to their workspace71    * `"anthropic"`: published by Anthropic; shared and read-only72    * `"anthropic_example"`: Anthropic-published sample Skill73    * `"plugin"`: resolved from an installed plugin7475    - `type: "custom" or "anthropic" or "anthropic_example" or "plugin"`7677      Where the Skill comes from.7879      Possible values:8081      * `"custom"`: authored by the platform user; private to their workspace82      * `"anthropic"`: published by Anthropic; shared and read-only83      * `"anthropic_example"`: Anthropic-published sample Skill84      * `"plugin"`: resolved from an installed plugin8586      - `"custom"`8788      - `"anthropic"`8990      - `"anthropic_example"`9192      - `"plugin"`9394  - `updated_at: string`9596    ISO 8601 timestamp of when the skill was last updated.9798    format: date-time99100## Example101102```bash103curl https://api.anthropic.com/v1/skills \104    -H 'Content-Type: multipart/form-data' \105    -H 'anthropic-version: 2023-06-01' \106    -H "X-Api-Key: $ANTHROPIC_API_KEY" \107    -F 'files[]=@/path/to/file'108```109110### Response (200)111112```json113{114  "id": "skill_01JAbcdefghijklmnopqrstuvw",115  "created_at": "2024-10-30T23:58:27.427722Z",116  "display_name": "display_name",117  "latest_version_id": "latest_version_id",118  "source": {119    "type": "custom"120  },121  "type": "skill",122  "updated_at": "2024-10-30T23:58:27.427722Z"123}124```125
Files main
Menu

Theme