openai-docs

SKILL.md

Access current OpenAI developer documentation with MCP tools and model-selection guidance.

Prioritizes the OpenAI Developer Docs MCP server for all queries; falls back to web search only on official OpenAI domains if MCP returns no results

Includes reference files for model selection, GPT-5.4 upgrade planning, and prompting guidance; always verifies recommendations against live docs before answering

Covers seven core OpenAI products: Apps SDK, Responses API, Chat Completions, Codex, gpt-oss, Realtime API, and Agents SDK

Handles MCP server installation and escalation if tools are unavailable, with clear workflow for clarifying product scope and upgrade needs

OpenAI Docs

Provide authoritative, current guidance from OpenAI developer docs using the developers.openai.com MCP server. Always prioritize the developer docs MCP tools over web.run for OpenAI-related questions. This skill also owns model selection, API model migration, and prompt-upgrade guidance. Only if the MCP server is installed and returns no meaningful results should you fall back to web search.

Quick start

Use mcp__openaiDeveloperDocs__search_openai_docs to find the most relevant doc pages.

Use mcp__openaiDeveloperDocs__fetch_openai_doc to pull exact sections and quote/paraphrase accurately.

Use mcp__openaiDeveloperDocs__list_openai_docs only when you need to browse or discover 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.

Preserve explicit target requests: if the user names a target model like "migrate to GPT-5.4", keep that requested target even if latest-model.md names a newer model. Mention newer guidance only as optional.

If current remote guidance is needed, fetch both the returned migration and prompting guide URLs directly. If direct fetch fails, use MCP/search fallback; if that also fails, use bundled fallback references and disclose the fallback.

OpenAI product snapshots