Fetches exact OpenAI documentation and OpenAPI specs using MCP servers to ensure accurate implementation.
Install
mkdir -p .claude/skills/openai-knowledge && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/932" && unzip -o skill.zip -d .claude/skills/openai-knowledge && rm skill.zipInstalls to .claude/skills/openai-knowledge
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
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`.Key capabilities
- →Fetch live markdown documentation for specific API components
- →List available API endpoints via schema inspection
- →Retrieve OpenAPI specifications for request validation
- →Search documentation by keyword or anchor reference
How it works
Uses MCP server tools to perform remote fetches of documentation data and schemas directly from the official repository.
Inputs & outputs
When to use openai-knowledge
- →Finding correct schema for OpenAI API endpoints
- →Looking up Realtime API usage guidelines
- →Retrieving accurate model rate limits and parameters
About this skill
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 ananchor).
- When you need endpoint schemas or parameters, use:
mcp__openaiDeveloperDocs__get_openapi_specmcp__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:
[mcp_servers.openaiDeveloperDocs] url = "https://developers.openai.com/mcp"
- Add:
Also point to: https://developers.openai.com/resources/docs-mcp#quickstart
When not to use it
- →When offline and MCP servers are unreachable
- →For general coding assistance unrelated to OpenAI platform services
Prerequisites
Limitations
- →Requires active network access to the MCP server
- →Depends on current availability of the OpenAI developer docs site
How it compares
It eliminates hallucination by pulling raw, authoritative source text instead of relying on internal model training data.
Compared to similar skills
openai-knowledge side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| openai-knowledge (this skill) | 5 | 4mo | No flags | Intermediate |
| openrouter-function-calling | 5 | 26d | Review | Intermediate |
| openrouter-openai-compat | 1 | 26d | Review | Intermediate |
| api-documenter | 0 | 8mo | Review | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by openai
View all by openai →You might also like
openrouter-function-calling
jeremylongshore
Implement function/tool calling with OpenRouter models. Use when building agents or structured outputs. Trigger with phrases like 'openrouter functions', 'openrouter tools', 'openrouter agent', 'function calling'.
openrouter-openai-compat
jeremylongshore
Configure OpenRouter as an OpenAI API drop-in replacement. Use when migrating from OpenAI or using OpenAI-compatible libraries. Trigger with phrases like 'openrouter openai', 'openrouter drop-in', 'openrouter compatibility', 'migrate to openrouter'.
api-documenter
ovachiever
Auto-generate API documentation from code and comments. Use when API endpoints change, or user mentions API docs. Creates OpenAPI/Swagger specs from code. Triggers on API file changes, documentation requests, endpoint additions.
mcp-builder
anthropics
Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).
telegram-bot-builder
davila7
Expert in building Telegram bots that solve real problems - from simple automation to complex AI-powered bots. Covers bot architecture, the Telegram Bot API, user experience, monetization strategies, and scaling bots to thousands of users. Use when: telegram bot, bot api, telegram automation, chat bot telegram, tg bot.
stripe-integration
wshobson
Implement Stripe payment processing for robust, PCI-compliant payment flows including checkout, subscriptions, and webhooks. Use when integrating Stripe payments, building subscription systems, or implementing secure checkout flows.