Skip to main content
Tool create_skill · Behavior Additive
Create a skill — a reusable instruction the model applies on demand. You own it and it defaults to private. Attach reference files with file_ids (upload them first). Returns the created skill.

​
Input parameters

​
string
required
Skill name (required, 1-255 chars).
​
string
required
The skill instructions — the prompt text the model receives when the skill runs (required, 1-100000 chars).
​
string | null
Optional short description of what the skill does (max 1000 chars).
​
'private' | 'organization'
Skill visibility. Defaults to private (only you and users you share it with). organization makes it visible to everyone in your org.
​
string (uuid)[]
Uploaded file ids to attach as reference context (max 50). Upload files first with upload_file.

​
Response

​
object