One change

Create Skill

api/skills/create

25 Aug 2026 03:37 UTC first seen 20 Aug 2026 The page's own history The capture it came from

Nearest release: v2.1.245, published an hour after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.

api/skills/create Changed · +26 / -13 lines

# Create Skill ## Body parameters (form-data) ## Returns ## Example ### Response (200) ## Create Skill ### Returns ### Example #### Response

from line 1

----
-title: Create Skill
-url: https://platform.claude.com/docs/en/api/skills/create
----
+# Create Skill
 
-## Create Skill
+**POST** `/v1/skills`
 
-**post** `/v1/skills`
-
 Create Skill
 
-### Returns
+## Body parameters (form-data)
 
-- `Skill object { id, created_at, display_name, 4 more }`
+- `files: array of string`
 
+  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 or null`
+
+  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.
+
+## Returns
+
+- `Skill object`
+
   - `id: string`
 
     Unique identifier for the skill.

from line 32

 
     ISO 8601 timestamp of when the skill was created.
 
+    format: date-time
+
   - `display_name: string`
 
     Human-readable, single-line label for the Skill. Maximum 255 characters.

from line 80

 
     For Skills, this is always `"skill"`.
 
-    - `"skill"`
+    default: skill
 
   - `updated_at: string`
 
     ISO 8601 timestamp of when the skill was last updated.
 
-### Example
+    format: date-time
 
-```http
+## Example
+
+```bash
 curl https://api.anthropic.com/v1/skills \
     -H 'Content-Type: multipart/form-data' \
     -H 'anthropic-version: 2023-06-01' \

from line 98

     -F files='["Example data"]'
 ```
 
-#### Response
+### Response (200)
 
 ```json
 {