openai-docs

Retrieves official OpenAI documentation and guides model selection, migration, and prompt upgrades.

1|Updated Jul 6, 2015
One-click install
npx skills add https://github.com/ksolomon/dotfiles --skill openai-docs-ksolomon
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openai-docs
Source: https://github.com/ksolomon/dotfiles/tree/main/AI/.codex/skills/.system/openai-docs
Command: npx skills add https://github.com/ksolomon/dotfiles --skill openai-docs-ksolomon

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 updating prompts. This Skill grounds every answer in current official OpenAI developer documentation with citations, so guidance on models, APIs, and upgrades stays accurate. ## Core Features & Use Cases - Official Docs Lookup: Searches and fetches pages from the developers.openai.com MCP server, quoting exact sections with concise citations. - Model Selection & Migration: Resolves the latest recommended model, classifies upgrades as model-string-only, light prompt rewrite, or blocked, and keeps changes narrow and behavior-preserving. - Prompt-Upgrade Guidance: Applies bundled prompting and upgrade guides (with remote freshness checks) to adapt prompts for newer models without scope creep. - Use Case: A user asks to migrate a GPT-4o assistant to the latest model. The Skill fetches the current latest-model guide, recommends the target model string and reasoning effort, and suggests only the minimal prompt blocks needed. ## Quick Start Ask the assistant to look up the latest OpenAI model guidance and recommend how to upgrade your existing API integration with citations from 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, then quote or paraphrase exact sections with citations. Web search is only a fallback restricted to official OpenAI domains.

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

Fetch the latest-model guide from developers.openai.com first, which maps model IDs to use cases like reasoning, coding, image, audio, and embeddings. If remote docs are unavailable, the bundled latest-model reference serves as a disclosed fallback.

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

Inventory current model usage, pair each with its prompt surface, then classify the upgrade as model-string-only, model string plus light prompt rewrite, or blocked. Keep changes narrow and preserve explicitly requested target models.

What happens if the OpenAI docs MCP server is not installed?▼

The Skill attempts to install it with the codex mcp add command, retrying with escalated permissions if sandboxed. Only if that fails does it ask the user to install and restart, then re-runs the doc search.

When is a model upgrade marked as blocked instead of applied?▼

An upgrade is blocked when it requires API-surface changes, parameter rewrites, tool-definition rewiring, or provider migration beyond a literal model-string replacement and prompt edits. The blocker is reported rather than improvising broader changes.