What types of OpenAI products does this skill cover?

This skill covers various OpenAI products including Codex, Chat Completions, Apps SDK, and more, providing documentation for each.

How do I use this skill to find documentation?

You can use commands like `mcp__openaiDeveloperDocs__search_openai_docs` to search for specific documentation or `mcp__openaiDeveloperDocs__fetch_openai_doc` to retrieve exact sections.

What happens if the MCP server is not installed?

If the MCP server is missing, you will need to install it using the command provided in the skill documentation, and follow the steps for escalation if necessary.

Can I access unofficial OpenAI documentation with this skill?

No, this skill strictly prioritizes official OpenAI documentation and will only search official OpenAI domains when necessary.

Is this skill suitable for beginners?

This skill is designed for intermediate users who are familiar with OpenAI products and APIs, as it requires some understanding of the documentation structure.

OpenAI Docs

Name: OpenAI Docs
Availability: InStock
Author: davila7

Free

Access up-to-date OpenAI documentation easily.

by davila730.2k stars on davila7/claude-code-templates

1 views

Updated Aug 10, 2026

Get this skill

Free · Opens the source repo

What OpenAI Docs does

The OpenAI Docs skill provides developers and designers with direct access to the official OpenAI documentation. It is designed to streamline the process of finding accurate and current information related to OpenAI's APIs and products, including Codex, Chat Completions, and the various SDKs. By prioritizing the use of the MCP server for documentation queries, this skill ensures that users receive authoritative guidance without unnecessary detours through unofficial sources.

When using this skill, developers can utilize commands such as mcp__openaiDeveloperDocs__search_openai_docs to locate relevant documentation pages quickly. If specific sections are needed, mcp__openaiDeveloperDocs__fetch_openai_doc allows for precise retrieval of content, ensuring that users can quote or paraphrase accurately. This focus on official documentation helps maintain the integrity of the information provided, which is crucial in development environments where accuracy is paramount.

The skill is particularly useful for those who are building applications with OpenAI's products, as it covers a wide range of functionalities, from the Apps SDK for creating ChatGPT applications to the Responses API for managing stateful interactions. By offering a structured workflow, the OpenAI Docs skill guides users through the process of clarifying their needs, searching for documentation, and retrieving the most pertinent information. This makes it an essential tool for developers looking to leverage OpenAI's capabilities effectively.

Overall, the OpenAI Docs skill is an invaluable resource for anyone working with OpenAI technologies, providing a reliable means of accessing the latest documentation while minimizing the risk of misinformation from unofficial sources.

When to use it

Use this skill when you need official documentation for OpenAI APIs or products while developing applications.

When not to use it

This skill may not be suitable if you're looking for unofficial resources or community-driven content, as it strictly prioritizes official documentation.

What you can build with it

Building a ChatGPT App

When developing a ChatGPT application, use this skill to access the Apps SDK documentation for guidance on integrating your app's tools.

Using Codex for Development

If you need to understand how to utilize Codex for code generation or debugging, this skill provides direct access to relevant documentation.

Implementing the Responses API

Use this skill to find documentation on the Responses API when designing stateful interactions in your application.

How to install OpenAI Docs

View source

1. Install with the skills CLI

npx skills add davila7/claude-code-templates/openai-docs --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by davila7

OpenAI Docs

Provide authoritative, current guidance from OpenAI developer docs using the developers.openai.com MCP server. Always prioritize the developer docs MCP tools over web.run for OpenAI-related questions. Only if the MCP server is installed and returns no meaningful results should you fall back to web search.

Quick start

Use mcp__openaiDeveloperDocs__search_openai_docs to find the most relevant doc pages.
Use mcp__openaiDeveloperDocs__fetch_openai_doc to pull exact sections and quote/paraphrase accurately.
Use mcp__openaiDeveloperDocs__list_openai_docs only when you need to browse or discover pages without a clear query.

OpenAI product snapshots

Apps SDK: Build ChatGPT apps by providing a web component UI and an MCP server that exposes your app's tools to ChatGPT.
Responses API: A unified endpoint designed for stateful, multimodal, tool-using interactions in agentic workflows.
Chat Completions API: Generate a model response from a list of messages comprising a conversation.
Codex: OpenAI's coding agent for software development that can write, understand, review, and debug code.
gpt-oss: Open-weight OpenAI reasoning models (gpt-oss-120b and gpt-oss-20b) released under the Apache 2.0 license.
Realtime API: Build low-latency, multimodal experiences including natural speech-to-speech conversations.
Agents SDK: A toolkit for building agentic apps where a model can use tools and context, hand off to other agents, stream partial results, and keep a full trace.

If MCP server is missing

If MCP tools fail or no OpenAI docs resources are available:

Run the install command yourself: codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
If it fails due to permissions/sandboxing, immediately retry the same command with escalated permissions and include a 1-sentence justification for approval. Do not ask the user to run it yet.
Only if the escalated attempt fails, ask the user to run the install command.
Ask the user to restart Codex.
Re-run the doc search/fetch after restart.

Workflow

Clarify the product scope (Codex, OpenAI API, or ChatGPT Apps SDK) and the task.
Search docs with a precise query.
Fetch the best page and the specific section needed (use anchor when possible).
Answer with concise guidance and cite the doc source.
Provide code snippets only when the docs support them.

Quality rules

Treat OpenAI docs as the source of truth; avoid speculation.
Keep quotes short and within policy limits; prefer paraphrase with citations.
If multiple pages differ, call out the difference and cite both.
If docs do not cover the user’s need, say so and offer next steps.

Tooling notes

Always use MCP doc tools before any web search for OpenAI-related questions.
If the MCP server is installed but returns no meaningful results, then use web search as a fallback.
When falling back to web search, restrict to official OpenAI domains (developers.openai.com, platform.openai.com) and cite sources.

Frequently asked questions about OpenAI Docs

Similar skills

Markdown to HTML Conversion

Efficiently convert Markdown documents to HTML.

Code Tour

Create structured walkthroughs for codebases.

Acquire Codebase Knowledge

Streamline onboarding with comprehensive codebase documentation.

Documentation & Modernization

Streamline codebase documentation and modernization planning.

Azure Resource Visualizer

Generate architecture diagrams for Azure resources.

CLAUDE.md Improver

Optimize your CLAUDE.md files for better project context.