openai · OpenAI Platform Docs
Skills | OpenAI API
Explains how to implement and utilize Skills within the OpenAI API to enable models to perform specific tasks or interact with external systems.
Derived skill
Files assembled from official documentation
Viewing SKILL.md
Skills | OpenAI API
Explains how to implement and utilize Skills within the OpenAI API to enable models to perform specific tasks or interact with external systems.
When To Use
Use when you need to implement a workflow that allows an AI model to execute specific functions or interact with external tools through the Skills framework.
Reference Files
| File | Contains | Use For |
|---|---|---|
SKILL.md | Entry point: scope, routing table, and workflow. | Start here. |
docs/skills-openai-api-workflow-guide.md | A guide explaining how to create and use agent skills via directory or zip uploads for local and hosted execution. | Questions about a guide explaining how to create and use agent skills via directory or zip uploads for local and hosted execution. |
examples/skills-openai-api-openai-api-skills-definition.text | A text representation of a skill definition including name, description, and usage instructions for the OpenAI API. | Exact payloads, commands, or snippets shown in A text representation of a skill definition including name, description, and usage instructions for the OpenAI API. |
examples/skills-openai-api-openai-api-skills-upload-curl-request.text | A curl command demonstrating how to upload skill files to the OpenAI API using a multipart/form-data POST request. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to upload skill files to the OpenAI API using a multipart/form-data POST request. |
examples/skills-openai-api-openai-api-skills-curl-upload-zip.text | A curl command demonstrating how to upload a zip file to the OpenAI skills endpoint using a POST request. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to upload a zip file to the OpenAI skills endpoint using a POST request. |
examples/skills-openai-api-openai-api-skills-curl-request.text | A curl command demonstrating how to structure a request to the OpenAI API using the skills and tools parameters. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to structure a request to the OpenAI API using the skills and tools parameters. |
examples/skills-openai-api-openai-api-skills-shell-tool-nodejs.text | A Node.js code example demonstrating how to define a shell tool with skill references within an OpenAI API response request. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to define a shell tool with skill references within an OpenAI API response r... |
examples/skills-openai-api-openai-api-python-skills-tool-definition.text | A Python code example demonstrating how to define a shell tool with specific skill references using the OpenAI client. | Exact payloads, commands, or snippets shown in A Python code example demonstrating how to define a shell tool with specific skill references using the OpenAI client. |
examples/skills-openai-api-openai-api-skills-curl-request-2.text | A curl command demonstrating how to call the OpenAI API with a shell-type tool and a defined skill configuration. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to call the OpenAI API with a shell-type tool and a defined skill configuration. |
examples/skills-openai-api-openai-api-skills-shell-tool-nodejs-2.text | A Node.js code example demonstrating how to define a shell-type tool with a custom skill within an OpenAI API response request. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to define a shell-type tool with a custom skill within an OpenAI API respons... |
examples/skills-openai-api-openai-api-python-skills-shell-tool.text | A Python code example demonstrating how to define a shell-type tool with a custom skill for CSV analysis using the OpenAI client. | Exact payloads, commands, or snippets shown in A Python code example demonstrating how to define a shell-type tool with a custom skill for CSV analysis using the Op... |
examples/skills-openai-api-openai-api-skills-list-versions-curl.text | A curl command demonstrating how to list available versions of skills using the OpenAI API. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to list available versions of skills using the OpenAI API. |
examples/skills-openai-api-openai-api-skills-list-curl.text | A curl command demonstrating how to list available skills using the OpenAI API. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to list available skills using the OpenAI API. |
examples/skills-openai-api-openai-api-skill-reference-json-structure.text | A JSON object demonstrating the skill_reference structure including skill_id and version fields. | Exact payloads, commands, or snippets shown in A JSON object demonstrating the skillreference structure including skillid and version fields. |
examples/skills-openai-api-openai-api-inline-skill-container-curl-request.text | A curl command demonstrating how to create an inline skill container using the OpenAI API containers endpoint. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to create an inline skill container using the OpenAI API containers endpoint. |
What This Skill Covers
- Agent Skills let you upload and reuse versioned bundles of files in hosted and local shell environments.
- Main sections:
What’s a skill,Create a skill,Option 1: Directory upload (multipart),Option 2: Zip upload,Use skills with hosted shell.
Workflow
- Open the most relevant file under
docs/for the exact documented workflow and wording. - Open
schemas/files for exact structured contracts. - Open
examples/files for concrete requests, commands, snippets, and manifests. - Do not add behavior or configuration that is not present in the attached source files.
Canonical source: https://developers.openai.com/api/docs/guides/tools-skills