openai-docs

Retrieves and cites official OpenAI developer documentation via MCP tools.

Updated Feb 4, 2026
One-click install
npx skills add https://github.com/pchemguy/AISandbox --skill openai-docs-pchemguy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openai-docs
Source: https://github.com/pchemguy/AISandbox/tree/main/docs/AgentSkills/openai/skills/skills/.curated/openai-docs
Command: npx skills add https://github.com/pchemguy/AISandbox --skill openai-docs-pchemguy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve? Developers building with OpenAI products often rely on outdated or unofficial sources, leading to incorrect API usage. This Skill provides authoritative, current answers from the official OpenAI developer documentation with proper citations. ## Core Features & Use Cases - Official Docs Search: Uses the developers.openai.com MCP server to search, fetch, and browse official OpenAI documentation pages. - Product Coverage: Covers Codex, Responses API, Chat Completions, Apps SDK, Agents SDK, Realtime API, and gpt-oss models. - Controlled Fallback: Falls back to web search restricted to official OpenAI domains only when the MCP server returns no meaningful results. - Use Case: When asked how to build a ChatGPT app with the Apps SDK, the Skill searches the official docs, fetches the relevant section, and answers with concise, cited guidance. ## Quick Start Ask how to use the OpenAI Responses API and request an answer based on the official OpenAI documentation with citations.

Frequently Asked Questions about openai-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get up-to-date OpenAI API documentation in my AI assistant?

Use the OpenAI Developer Docs MCP server at developers.openai.com/mcp, which exposes search, fetch, and list tools for official documentation. This Skill prioritizes those MCP tools over generic web search for OpenAI-related questions.

What OpenAI products does the official docs MCP server cover?

It covers Codex, the Responses API, Chat Completions API, Apps SDK for ChatGPT apps, Agents SDK, Realtime API, and the gpt-oss open-weight models. Each product has dedicated documentation pages searchable through the MCP tools.

What happens if the OpenAI docs MCP server is not installed?

The Skill attempts to install it by running codex mcp add openaiDeveloperDocs with the official URL, retrying with escalated permissions if needed. Only after those attempts fail does it ask the user to run the install command and restart.

Can I use web search instead of the OpenAI docs MCP tools?

Web search is only a fallback when the MCP server is installed but returns no meaningful results. In that case, browsing is restricted to official OpenAI domains such as developers.openai.com and platform.openai.com, with sources cited.

How are answers from OpenAI documentation cited?

The Skill fetches the specific doc page and section, then paraphrases or briefly quotes the content with a citation to the source. If multiple pages conflict, it calls out the difference and cites both.