openai-docs

Retrieve official OpenAI documentation, Codex manual guidance, and model migration references.

Updated Dec 20, 2025
One-click install
npx skills add https://github.com/koala-man-64/helpful-scripts --skill openai-docs-koala-man-64
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openai-docs
Source: https://github.com/koala-man-64/helpful-scripts/tree/main/exports/codex-skills/home-shared/.system/openai-docs
Command: npx skills add https://github.com/koala-man-64/helpful-scripts --skill openai-docs-koala-man-64

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Developers building with OpenAI APIs often rely on outdated or unofficial information when choosing models, configuring Codex, or migrating prompts. This Skill routes questions to authoritative OpenAI documentation sources so answers stay current and citable. ## Core Features & Use Cases - Official docs lookup: Searches and fetches pages from the developers.openai.com MCP server, with fallback to official-domain web search when MCP tools are unavailable. - Codex self-knowledge: Fetches and caches the Codex manual via a Node helper script, generating an outline for targeted section reads on setup, skills, plugins, MCP, hooks, and automations. - Model selection and migration: Resolves the latest model guidance, preserves explicitly requested model targets, and applies bundled upgrade and prompting guides as fallbacks. - Use Case: When asked to migrate an integration to the latest GPT model, the Skill resolves the current model info, fetches the migration and prompting guides, and applies narrow model-string and prompt updates while flagging out-of-scope changes as blocked. ## Quick Start Ask how to configure a Codex feature or which OpenAI model to use for your application and request citations from the official docs.

Frequently Asked Questions about openai-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get up-to-date OpenAI API documentation with citations?▼

Use the openaiDeveloperDocs MCP server tools to search and fetch pages from developers.openai.com before answering. If MCP tools are unavailable, fall back to web search restricted to official OpenAI domains and cite the sources.

How do I find the latest OpenAI model for my use case?▼

Fetch the latest-model guide at developers.openai.com/api/docs/guides/latest-model.md first. If that fetch fails, use the bundled references/latest-model.md fallback and disclose that fallback guidance was used.

What MCP server does OpenAI docs lookup require?▼

It requires the openaiDeveloperDocs MCP server over streamable HTTP at https://developers.openai.com/mcp. If missing, install it with 'codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp' and restart Codex.

Can I migrate to a specific model instead of the latest one?▼

Yes. Explicitly named target models are preserved even when newer guidance exists. The latest-model resolution script only runs when the target is latest, current, default, or otherwise unspecified.

Why does the Codex manual helper fail in some sessions?▼

The helper needs shell execution and a writable temp cache directory such as TMPDIR, TEMP, or /tmp. In read-only or no-shell sessions it is skipped, and Docs MCP search and fetch become the next source before any web fallback.