openai-docs

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

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/chhpt/skills --skill openai-docs-chhpt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openai-docs
Source: https://github.com/chhpt/skills/tree/main/skills/openai-docs
Command: npx skills add https://github.com/chhpt/skills --skill openai-docs-chhpt

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 integrations. This Skill routes questions to authoritative OpenAI documentation sources so answers stay current, cited, and accurate. ## Core Features & Use Cases - Official Docs Lookup: Searches and fetches pages from the OpenAI Developer Docs 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 helper script, generating an outline for targeted answers about Codex configuration, skills, plugins, MCP, hooks, and automations. - Model Selection & Migration: Resolves the latest recommended model and provides bundled fallback guides for model upgrades and prompt rewrites, preserving explicitly requested target models. - Use Case: When asked "which model should I use for a coding agent" or "migrate my integration to the latest model", the Skill fetches current guidance, runs the model-resolution script, and returns cited recommendations with a narrow, behavior-preserving upgrade plan. ## Quick Start Ask the assistant to look up the current recommended OpenAI model for your use case and cite the official documentation.

Frequently Asked Questions about openai-docs

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

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

The Skill fetches the latest-model guide from developers.openai.com first, then falls back to a bundled reference table mapping models like gpt-5.5, gpt-5.3-codex, and gpt-image-2 to use cases. Current remote docs always take priority over bundled references.

How do I migrate an existing integration to a newer OpenAI model?

Run the resolve-latest-model-info script to confirm the current target, then follow the bundled upgrade guide: replace the model string, preserve reasoning effort, and make only minimal prompt edits. Changes requiring API-surface or tool rewiring are reported as blocked.

What sources does this Skill use for Codex configuration questions?

Broad Codex questions go through a helper script that downloads and caches the official Codex manual with a generated outline. Docs MCP search and fetch are the next source, followed by official-domain web fallback, then bounded uncertainty.

What happens if the OpenAI Docs MCP server is not installed?

The Skill attempts to install it with the codex mcp add command, retries with escalated permissions if sandboxed, and only then asks the user to install and restart. Web search restricted to official OpenAI domains is the final fallback.

Does the model upgrade change my SDK, tools, or API surface?

No. Upgrades are limited to model-string replacements and directly related prompt edits. SDK migrations, tool-definition changes, structured-output rewiring, and provider migrations are explicitly out of scope and reported as blocked.