{"name":"openai-knowledge","url":"https://skills.sh/openai/openai-agents-python/openai-knowledge","install":"npx skills add openai/openai-agents-python --skill openai-knowledge","sdk":"openai-agents","key":"openai-agents/openai-knowledge","description":"Use when working with the OpenAI API (Responses API) or OpenAI platform features (tools, streaming, Realtime API, auth, models, rate limits, MCP) and you need authoritative, up-to-date documentation (schemas, examples, limits, edge cases). Prefer the OpenAI Developer Documentation MCP server tools when available; otherwise guide the user to enable `openaiDeveloperDocs`.","hasContent":true,"content":"---\nname: openai-knowledge\ndescription: Use when working with the OpenAI API (Responses API) or OpenAI platform features (tools, streaming, Realtime API, auth, models, rate limits, MCP) and you need authoritative, up-to-date documentation (schemas, examples, limits, edge cases). Prefer the OpenAI Developer Documentation MCP server tools when available; otherwise guide the user to enable `openaiDeveloperDocs`.\n---\n\n# OpenAI Knowledge\n\n## Overview\n\nUse the OpenAI Developer Documentation MCP server to search and fetch exact docs (markdown), then base your answer on that text instead of guessing.\n\n## Workflow\n\n### 1) Check whether the Docs MCP server is available\n\nIf the `mcp__openaiDeveloperDocs__*` tools are available, use them.\n\nIf you are unsure, run `codex mcp list` and check for `openaiDeveloperDocs`.\n\n### 2) Use MCP tools to pull exact docs\n\n- Search first, then fetch the specific page or pages.\n  - `mcp__openaiDeveloperDocs__search_openai_docs` → pick the best URL.\n  - `mcp__openaiDeveloperDocs__fetch_openai_doc` → retrieve the exact markdown (optionally with an `anchor`).\n- When you need endpoint schemas or parameters, use:\n  - `mcp__openaiDeveloperDocs__get_openapi_spec`\n  - `mcp__openaiDeveloperDocs__list_api_endpoints`\n\nBase your answer on the fetched text and quote or paraphrase it precisely. Do not invent flags, field names, defaults, or limits.\n\n### 3) If MCP is not configured, guide setup (do not change config unless asked)\n\nProvide one of these setup options, then ask the user to restart the Codex session so the tools load:\n\n- CLI:\n  - `codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp`\n- Config file (`~/.codex/config.toml`):\n  - Add:\n    ```toml\n    [mcp_servers.openaiDeveloperDocs]\n    url = \"https://developers.openai.com/mcp\"\n    ```\n\nAlso point to: https://developers.openai.com/resources/docs-mcp#quickstart\n","contentSource":"https://raw.githubusercontent.com/openai/openai-agents-python/main/.agents/skills/openai-knowledge/SKILL.md","contentFetchedAt":"2026-07-27T09:00:57.594Z"}