The whole hunk
from line 104, old and new numbered
/
lines
from line 104
104104
105105 All files must be in the same top-level directory and must include a SKILL.md file at the root of that directory.
106106
107- `display_title: optional string or null`
107- `display_name: optional string or null`
108108
109 Display title for the skill.
109 Human-readable, single-line label for the Skill. Maximum 255 characters.
110 Always set: derived from the SKILL.md frontmatter `name` when omitted at
111 creation. Not unique.
110112
111 This is a human-readable label that is not included in the prompt sent to the model.
112
113113## Returns
114114
115- `id: string`
115- `BetaSkill object`
116116
117 Unique identifier for the skill.
117 - `id: string`
118118
119 The format and length of IDs may change over time.
119 Unique identifier for the skill.
120120
121- `created_at: string`
121 The format and length of IDs may change over time.
122122
123 ISO 8601 timestamp of when the skill was created.
123 - `created_at: string`
124124
125- `display_title: string or null`
125 ISO 8601 timestamp of when the skill was created.
126126
127 Display title for the skill.
127 format: date-time
128128
129 This is a human-readable label that is not included in the prompt sent to the model.
129 - `display_name: string`
130130
131- `latest_version: string or null`
131 Human-readable, single-line label for the Skill. Maximum 255 characters.
132 Always set: derived from the SKILL.md frontmatter `name` when omitted at
133 creation. Not unique.
132134
133 The latest version identifier for the skill.
135 - `latest_version_id: string`
134136
135 This represents the most recent version of the skill that has been created.
137 ID of the newest Skill Version — what `latest` references resolve to. Always set: a Skill holds at least one version.
136138
137- `source: string`
139 - `source: BetaSkillSource`
138140
139 Source of the skill.
141 Where the Skill comes from.
140142
141 This may be one of the following values:
143 Possible values:
142144
143 * `"custom"`: the skill was created by a user
144 * `"anthropic"`: the skill was created by Anthropic
145 * `"custom"`: authored by the platform user; private to their workspace
146 * `"anthropic"`: published by Anthropic; shared and read-only
147 * `"anthropic_example"`: Anthropic-published sample Skill
148 * `"plugin"`: resolved from an installed plugin
145149
146- `type: string`
150 - `type: "custom" or "anthropic" or "anthropic_example" or "plugin"`
147151
148 Object type.
152 Where the Skill comes from.
149153
150 For Skills, this is always `"skill"`.
154 Possible values:
151155
152 default: skill
156 * `"custom"`: authored by the platform user; private to their workspace
157 * `"anthropic"`: published by Anthropic; shared and read-only
158 * `"anthropic_example"`: Anthropic-published sample Skill
159 * `"plugin"`: resolved from an installed plugin
153160
154- `updated_at: string`
161 - `"custom"`
155162
156 ISO 8601 timestamp of when the skill was last updated.
163 - `"anthropic"`
157164
165 - `"anthropic_example"`
166
167 - `"plugin"`
168
169 - `type: "skill"`
170
171 Object type.
172
173 For Skills, this is always `"skill"`.
174
175 default: skill
176
177 - `updated_at: string`
178
179 ISO 8601 timestamp of when the skill was last updated.
180
181 format: date-time
182
158183## Example
159184
160185```bash
from line 186
161186curl https://api.anthropic.com/v1/skills \
162187 -H 'Content-Type: multipart/form-data' \
163188 -H 'anthropic-version: 2023-06-01' \
164 -H 'anthropic-beta: skills-2025-10-02' \
165189 -H "X-Api-Key: $ANTHROPIC_API_KEY" \
166190 -F files='["Example data"]'
167191```
from line 196
172196{
173197 "id": "skill_01JAbcdefghijklmnopqrstuvw",
174198 "created_at": "2024-10-30T23:58:27.427722Z",
175 "display_title": "My Custom Skill",
176 "latest_version": "1759178010641129",
177 "source": "custom",
178 "type": "type",
199 "display_name": "display_name",
200 "latest_version_id": "latest_version_id",
201 "source": {
202 "type": "custom"
203 },
204 "type": "skill",
179205 "updated_at": "2024-10-30T23:58:27.427722Z"
180206}
181207```