Skip to main content

openai-knowledge

Retrieve authoritative OpenAI API and platform documentation when an integration or claim needs current external evidence.

Source facts

Repository
openai/openai-agents-python
Last source activity
September 5, 2026 at 06:19
Detected SKILL.md language
English
Stars
29,842
Forks
4,845

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer
2 files

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
name
openai-knowledge
description
Retrieve authoritative OpenAI API and platform documentation when an integration or claim needs current external evidence.
# OpenAI Knowledge ## Overview Use the OpenAI Developer Documentation MCP server to search and fetch exact docs (markdown), then base your answer on that text instead of guessing. ## Workflow ### 1) Check whether the Docs MCP server is available If the `mcp__openaiDeveloperDocs__*` tools are available, use them. If you are unsure, run `codex mcp list` and check for `openaiDeveloperDocs`. ### 2) Use MCP tools to pull exact docs - Search first, then fetch the specific page or pages. - `mcp__openaiDeveloperDocs__search_openai_docs` → pick the best URL. - `mcp__openaiDeveloperDocs__fetch_openai_doc` → retrieve the exact markdown (optionally with an `anchor`). - When you need endpoint schemas or parameters, use: - `mcp__openaiDeveloperDocs__get_openapi_spec` - `mcp__openaiDeveloperDocs__list_api_endpoints` Base your answer on the fetched text and quote or paraphrase it precisely. Do not invent flags, field names, defaults, or limits. ### 3) If MCP is not configured, guide setup (do not change config unless asked) Provide one of these setup options, then ask the user to restart the Codex session so the tools load: - CLI: - `codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp` - Config file (`~/.codex/config.toml`): - Add: ```toml [mcp_servers.openaiDeveloperDocs] url = "https://developers.openai.com/mcp" ``` Also point to: https://developers.openai.com/resources/docs-mcp#quickstart
View on GitHub