Agent skill · OpenAI
OpenAI Docs skill for Claude Code, Codex and Cursor
Officialname: openai-docs★ 28k (repo)pushed 2026-09-08Apache-2.0SKILL.md on GitHubchecked 2026-11-07
What it does, in the publisher's words
Use when the user asks how to build with OpenAI products or APIs, asks about Codex itself or choosing Codex surfaces, needs up-to-date official documentation with citations, help choosing the latest model for a use case, or model upgrade and prompt-upgrade guidance; use OpenAI docs MCP tools for non-Codex docs questions, use the Codex manual helper first for broad Codex self-knowledge, and restrict fallback browsing...
The description field of the SKILL.md. The agent reads only this at startup and decides from it when to load the full skill.
Install OpenAI Docs
The skills CLI copies the skill into the folder of each agent you pick (Claude Code, Codex, Cursor, Copilot, Gemini CLI, OpenCode, Windsurf...). Add -g for all projects. Needs Node.js 22.20+. docs
npx skills add openai/skills --skill openai-docs
Copy the skill folder into ~/.claude/skills (all projects) or .claude/skills (this repo). Claude Code picks it up without a restart. docs
npx skills add openai/skills --skill openai-docs -a claude-code # or by hand: git clone --depth 1 https://github.com/openai/skills.git /tmp/openai-docs-src cp -r /tmp/openai-docs-src/skills/.curated/openai-docs ~/.claude/skills/openai-docs
Download the skill folder, zip it, then Customize > Skills > + > Create skill > Upload a skill. Code execution must be on (Settings > Capabilities). docs
git clone --depth 1 https://github.com/openai/skills.git /tmp/openai-docs-src cp -r /tmp/openai-docs-src/skills/.curated/openai-docs ./openai-docs zip -r openai-docs.zip openai-docs
It's in OpenAI's own catalog: ask Codex for $skill-installer openai-docs, or use the skills CLI. docs
$skill-installer openai-docs
gh skill (GitHub CLI 2.90+, preview) installs it for Copilot in VS Code, the CLI and the cloud agent. Copilot also reads .github/skills and ~/.copilot/skills. docs
gh skill install openai/skills openai-docs
Cursor reads .cursor/skills, .agents/skills and ~/.cursor/skills (and .claude/skills). It does not install loose skills from a GitHub URL, so copy it in. docs
npx skills add openai/skills --skill openai-docs -a cursor
Installs from the GitHub repo; --path picks this skill out of the repo. Default scope is user (all projects). docs
gemini skills install https://github.com/openai/skills.git --path skills/.curated/openai-docs
OpenCode reads .opencode/skills, ~/.config/opencode/skills and the Claude and .agents folders. docs
npx skills add openai/skills --skill openai-docs -a opencode
Windsurf (now Devin Desktop) reads .devin/skills, .windsurf/skills and ~/.codeium/windsurf/skills. docs
npx skills add openai/skills --skill openai-docs -a windsurf
Works with
Claude Code, Claude.ai and Claude Desktop, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Windsurf and other agents that read the open Agent Skills format.
- Bundles 2 JavaScript scripts the agent can run, so it needs JavaScript on the machine. In the Claude apps, code execution must be on.
What's in the SKILL.md
- Workflow Configuration
- Source Priority
- OpenAI product snapshots
- Codex self-knowledge
- Source Route
- Surface Map
- Boundaries And Output
- If MCP server is missing
- Workflow
- Reference map
- Quality rules
- Tooling notes
Bundled files
- LICENSE.txt
- agents/openai.yaml
- assets/openai-small.svg
- assets/openai.png
- references/latest-model.md
- references/prompting-guide.md
- references/upgrade-guide.md
- scripts/fetch-codex-manual.mjs
- scripts/resolve-latest-model-info.js
Loaded only when the instructions point to them.
Facts
- Skill name
- openai-docs
- Publisher
- OpenAI (official)
- Repo
- openai/skills
- License
- Apache-2.0
- SKILL.md size
- 2,476 words, 156 lines
- Bundled files
- 9, 2 scripts (JavaScript), 3 docs
- Repo stars
- 28k (as of 2026-10-24)
- SKILL.md checked
- 2026-11-07
Pairs with the OpenAI MCP server: the server gives the agent the tools, the skill teaches it how to use them.
More skills from openai/skills
- ChatGPT Apps: Scaffolds and debugs ChatGPT apps built with the Apps SDK: an MCP server plus widget UI.
- GitHub: Address PR Comments: Works through review comments on the current branch's pull request using the gh CLI.
- GitHub: Fix CI: Reads failing GitHub Actions checks with gh, summarizes the cause and proposes a fix.
- Image Generation: Generates or edits raster images such as illustrations, sprites, mockups and transparent cutouts.
- Linear: Reads, creates and updates Linear issues and projects from the agent.
- Playwright Browser Automation: Automates a real browser from the terminal for form filling, snapshots, scraping and UI debugging.
- Security Best Practices Review: Reviews code for language- and framework-specific security issues and suggests safer defaults.
- Security Threat Model: Writes a threat model for a repository: trust boundaries, assets, attack paths and mitigations.
- Skill Installer (Codex): Codex's built-in helper that installs skills from the curated list or any GitHub repo path.
Related ai & ml skills
- Claude API · Anthropic
- Hugging Face CLI · Hugging Face
- Gradio · Hugging Face
- Hugging Face LLM Trainer · Hugging Face
- Transformers.js · Hugging Face
- Gemini API · Google (Gemini)
- Gemini Live API · Google (Gemini)
- Cloudflare Agents SDK · Cloudflare
FAQ
What does the openai-docs skill do?+
Looks up current OpenAI API and Codex documentation and helps pick a model. In its own SKILL.md, OpenAI describes it as: "Use when the user asks how to build with OpenAI products or APIs, asks about Codex itself or choosing Codex surfaces, needs up-to-date official documentation with citations, help choosing the latest model for a use case, or model upgrade and prompt-upgrade guidance; use OpenAI docs MCP tools for..."
How do I install the openai-docs skill?+
Run npx skills add openai/skills --skill openai-docs and pick your agents, or use the tab for your agent above. In Claude Code the skill ends up in ~/.claude/skills/openai-docs/SKILL.md; in Codex and Cursor in .agents/skills/openai-docs/.
Does OpenAI Docs work in Codex, Cursor and Copilot, or only Claude?+
It's a standard SKILL.md, so any agent that reads the Agent Skills format can use it: Claude Code, the Claude apps, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Windsurf and more.
Who maintains OpenAI Docs?+
OpenAI, the company or project behind it, in the openai/skills repo on GitHub, last pushed 2026-09-08. License: Apache-2.0.
Read a skill's SKILL.md and scripts before you install it: skills aren't verified by any agent vendor. Claude skills marketplace · How to install skills · MCP servers