Agent skill · writing content · openai
openai-docs
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 to official OpenAI domains.
Why this skill is useful
Provides up-to-date, authoritative guidance on OpenAI APIs and model selection that the AI wouldn't reliably generate on its own.
What it needs
Requires openai account access. About 10k tokens when loaded. Last updated 2026-07-14. 24,594 stars on the source repository.
What this skill does
OpenAI Docs Provide authoritative, current guidance from OpenAI developer docs using the developers.openai.com MCP server. "Docs MCP" means mcpopenaiDeveloperDocssearchopenaidocs and mcpopenaiDeveloperDocsfetchopenaidoc; for API reference, schema, parameter, or required-field questions, also use mcpopenaiDeveloperDocsgetopenapispec when available. Official-domain web search is fallback after those tools are unavailable or unhelpful. Broad Codex questions use the manual helper before Docs MCP. This skill also owns model selection, API model migration, and prompt-upgrade guidance. Workflow Configuration Source Priority For Codex self-knowledge, use the Codex source route below; it owns when to use the manual helper, Docs MCP, or bounded uncertainty. For non-Codex OpenAI docs questions, use mcpopenaiDeveloperDocssearchopenaidocs to find the most relevant doc pages. For non-Codex OpenAI docs questions, fetch the relevant page with mcpopenaiDeveloperDocsfetchopenaidoc before answering. If search is noisy, run a narrower Docs MCP search; when any plausible official OpenAI docs URL is known or found, try fetching that URL through Docs MCP before relying on web-search content. For API reference, schema, parameter, or required-field questions, use mcpopenaiDeveloperDocsgetopenapispec when available to verify the API shape alongside the relevant guide or reference page. Use mcpopenaiDeveloperDocslistopenaidocs only when you need to browse or discover non-Codex pages without a clear query. For model-selection, "latest model", or default-model questions, fetch https://developers.openai.com/api/docs/guides/latest-model.md first. If that is unavailable, load references/latest-model.md. For model upgrades or prompt upgrades, run node scripts/resolve-latest-model-info.js only when the target is latest/current/default or otherwise unspecified; otherwise preserve the explicitly requested target. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills openai/openai-docs--4c097b