openai-docs-skill

SKILL.md

Query OpenAI's official developer documentation via MCP server for API, SDK, and platform guidance.

Search and fetch docs on OpenAI APIs (Chat Completions, Realtime, Responses), SDKs, ChatGPT Apps, Codex, and migrations using a CLI wrapper around the OpenAI Docs MCP server

Includes subcommands for discovery (search, list), retrieval (fetch), and schema inspection (endpoints, openapi)

Supports optional anchors for fetching specific doc sections and code sample generation in multiple languages

Returns markdown content with source URLs for transparent, authoritative reference

OpenAI Docs MCP Skill

Overview

Use the OpenAI developer documentation MCP server from the shell to search and fetch authoritative docs. Always do this for OpenAI platform work instead of relying on memory or non-official sources.

Core rules

Always use this skill for OpenAI API/SDK/Apps/Codex questions or when precise, current docs are required.

Query the MCP server via the CLI wrapper in scripts/openai-docs-mcp.sh (do not rely on Codex MCP tools).

Use search or list to find the best doc page, then fetch the page (or anchor) for exact text.

Surface the doc URL you used in your response so sources are clear.

Quick start

scripts/openai-docs-mcp.sh search "Responses API" 5
scripts/openai-docs-mcp.sh fetch https://platform.openai.com/docs/guides/migrate-to-responses