openai · OpenAI Platform Docs
Skills
Teaches how to create, upload, and implement versioned bundles of files called Agent Skills for use in both hosted and local shell environments.
Derived skill
Files assembled from official documentation
Viewing SKILL.md
Skills
Teaches how to create, upload, and implement versioned bundles of files called Agent Skills for use in both hosted and local shell environments.
When To Use
Use when you need to bundle files and instructions into a reusable module that an AI agent can invoke within a shell environment.
Reference Files
| File | Contains | Use For |
|---|---|---|
SKILL.md | Entry point: scope, routing table, and workflow. | Start here. |
docs/skills-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-platform-docs-skills.javascript | A JavaScript code example demonstrating how to use the OpenAI client to create a response that invokes specific skills within a shell tool environment. | Exact payloads, commands, or snippets shown in A JavaScript code example demonstrating how to use the OpenAI client to create a response that invokes specific skill... |
examples/skills-openai-platform-skills.python | A Python code example demonstrating how to use the OpenAI client to invoke specific skills within a tool definition. | Exact payloads, commands, or snippets shown in A Python code example demonstrating how to use the OpenAI client to invoke specific skills within a tool definition. |
examples/skills-openai-platform-skills.javascript | A JavaScript code example demonstrating how to define and invoke a shell-type skill within an OpenAI client response request. | Exact payloads, commands, or snippets shown in A JavaScript code example demonstrating how to define and invoke a shell-type skill within an OpenAI client response... |
examples/skills-openai-platform-skills-2.python | A Python code example demonstrating how to define and invoke a shell-type skill within an OpenAI client response request. | Exact payloads, commands, or snippets shown in A Python code example demonstrating how to define and invoke a shell-type skill within an OpenAI client response requ... |
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.md