openai-knowledge
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`.
Best use case
openai-knowledge is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
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`.
Teams using openai-knowledge should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/openai-knowledge/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How openai-knowledge Compares
| Feature / Agent | openai-knowledge | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
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`.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# 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(s).
- `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#quickstartRelated Skills
prompt-engineering-openai-api-f7c24501
Log in [Sign up](https://platform.openai.com/signup)
openai-docs
Use when the user asks how to build with OpenAI products or APIs and needs up-to-date official documentation with citations (for example: Codex, Responses API, Chat Completions, Apps SDK, Agents SDK, Realtime, model capabilities or limits); prioritize OpenAI docs MCP tools and restrict any fallback browsing to official OpenAI domains.
openai-docs-skill
Query the OpenAI developer documentation via the OpenAI Docs MCP server using CLI (curl/jq). Use whenever a task involves the OpenAI API (Responses, Chat Completions, Realtime, etc.), OpenAI SDKs, ChatGPT Apps SDK, Codex, MCP integrations, endpoint schemas, parameters, limits, or migrations and you need up-to-date official guidance.
openai-codex
OpenAI Codex CLI usage patterns, configuration, sandboxing, and best practices for AI-assisted development.
naiba-openai-sales
ChatGPT use cases and prompts for sales teams | Part of naiba-openai-work-assistant
naiba-openai-product
ChatGPT use cases and prompts for product teams | Part of naiba-openai-work-assistant
naiba-openai-managers
ChatGPT use cases and prompts for managers | Part of naiba-openai-work-assistant
naiba-openai-it
ChatGPT use cases and prompts for IT teams | Part of naiba-openai-work-assistant
naiba-openai-hr
ChatGPT use cases and prompts for HR teams | Part of naiba-openai-work-assistant
naiba-openai-government-it-staff
A quick-start guide for IT teams at any level of government who just received ChatGPT access | Part of naiba-openai-work-assistant
naiba-openai-executives
ChatGPT use cases and prompts for executives | Part of naiba-openai-work-assistant
naiba-openai-engineers
ChatGPT use cases and prompts for engineering teams | Part of naiba-openai-work-assistant