openai-docs

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

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

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, migrating integrations, or configuring Codex. This Skill grounds answers in current official OpenAI documentation with citations, eliminating guesswork about model IDs, API parameters, and prompting practices. ## Core Features & Use Cases - Official docs lookup with citations: Searches and fetches pages from the OpenAI Developer Docs MCP server, with fallback to official-domain web search. - Codex self-knowledge: Fetches and caches the Codex manual via a helper script to answer questions about Codex configuration, skills, plugins, MCP, hooks, and product surfaces. - Model selection and migration guidance: Resolves the latest model, fetches live migration and prompting guides, and provides tier-aware upgrade workflows (Sol, Terra, Luna) with compatibility checks for reasoning effort, caching, and tool use. - Use Case: When asked to migrate a repository from GPT-5.4 to the latest model, the Skill runs its resolver script, fetches the live migration guide, inventories model usage sites, and produces a scoped upgrade plan with validation steps. ## Quick Start Ask how to migrate your OpenAI API integration to the latest model 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 find the latest OpenAI model for my use case?

The Skill fetches the official latest-model guide from developers.openai.com or runs its resolver script to get the current model ID plus migration and prompting guide URLs. Bundled fallback references are used only when remote docs are unavailable.

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

The Skill inventories model usage sites, maps each role to the appropriate GPT-5.6 tier (Sol, Terra, or Luna), preserves effective reasoning effort, and runs compatibility checks for caching, tools, and multimodal inputs before editing.

What sources does this Skill use for OpenAI documentation?

It uses the OpenAI Developer Docs MCP server (search, fetch, and OpenAPI spec tools) as the primary source, the Codex manual helper for Codex self-knowledge, and official-domain web search only as a fallback.

Does this Skill work without the OpenAI docs MCP server installed?

It attempts to install the MCP server with the codex mcp add command, retrying with escalated permissions if needed. If installation fails, it falls back to bundled reference files and official-domain web search.

What are the limitations of the bundled model reference files?

The bundled latest-model and prompting references can drift from current docs and are explicitly marked as fallbacks. Live documentation from developers.openai.com is always treated as canonical when available.