skilld
All skills
openai avatar

/openai-docs

@972cb86 official
by openaiopenai/skills28k stars
1,891

Use when the user asks how to build with OpenAI products or APIs, asks about Codex itself or choosing Codex surfaces, needs up-to-date official documentation with citations, help choosing the latest model for a use case, or model upgrade and prompt-upgrade guidance; use OpenAI docs MCP tools for non-Codex docs questions, use the Codex manual helper first for broad Codex self-knowledge, and restrict fallback browsing to official OpenAI domains.

Ask your Agent

Use this Skill: https://skilld.dev/gh/openai/skills/openai-docs

This session only. Nothing lands on disk.

referenceslatest-model.md

≈490 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Latest model guide

This file is a curated helper. Every recommendation here must be verified against current OpenAI docs before it is repeated to a user.

Current model map

Model ID Use for
gpt-5.5 Latest/default text and reasoning model for most new apps, including coding and tool-heavy workflows
gpt-5.5-pro Maximum reasoning or quality when latency and cost matter less
gpt-5.4 Previous default text and reasoning model; use for existing GPT-5.4 integrations
gpt-5.4-mini Lower-cost testing and lighter production workflows
gpt-5.4-nano High-throughput simple tasks and classification
gpt-5.5 Explicit no-reasoning text path via reasoning.effort: none
gpt-4.1-mini Cheaper no-reasoning text
gpt-4.1-nano Fastest and cheapest no-reasoning text
gpt-5.3-codex Agentic coding, code editing, and tool-heavy coding workflows
gpt-5.1-codex-mini Cheaper coding workflows
gpt-image-2 Best image generation and edit quality
gpt-image-1.5 Less expensive image generation and edit quality
gpt-image-1-mini Cost-optimized image generation
gpt-4o-mini-tts Text-to-speech
gpt-4o-mini-transcribe Speech-to-text, fast and cost-efficient
gpt-realtime-1.5 Realtime voice and multimodal sessions
gpt-realtime-mini Cheaper realtime sessions
gpt-audio Chat Completions audio input and output
gpt-audio-mini Cheaper Chat Completions audio workflows
sora-2 Faster iteration and draft video generation
sora-2-pro Higher-quality production video
omni-moderation-latest Text and image moderation
text-embedding-3-large Higher-quality retrieval embeddings; default in this skill because no best-specific row exists
text-embedding-3-small Lower-cost embeddings

Maintenance notes

  • This file will drift unless it is periodically re-verified against current OpenAI docs.
  • If this file conflicts with current docs, the docs win.

Source: SKILL.md on GitHub

Third-party checks

2 warnings16d5 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    This skill includes security considerations related to privilege escalation and command execution. It instructs the agent to request escalated permissions if standard operations fail and executes local scripts to manage documentation. While these patterns support the skill's purpose of providing up-to-date documentation, they warrant review.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: MEDIUM · 1 issue

  • Runlayer6mo

    1/3 files flagged

  • ZeroLeaks5mo

    1 finding · Score: 69/100

Provenance

Signed by skilld at 972cb86. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 months ago.

Activeupdated 4 months ago

Topics

README badge

README badge for openai/skills/openai-docs

What it does

Provides authoritative OpenAI API documentation, model selection guidance, and migration advice through the developers.openai.com MCP server. Covers Chat Completions, Realtime, Responses, and Agents SDKs, with special handling for Codex product questions and model upgrade paths.

Generated from the current SKILL.md.

Frequently asked

Does this skill work with non-OpenAI models?
No. This skill is specific to OpenAI products and APIs, including the Chat Completions API, Realtime API, Responses API, and Codex. It does not cover other model providers.
How do I get help with Codex-specific questions?
For broad Codex questions about configuration, setup, or behavior, the skill runs a local helper script first to fetch the Codex manual before falling back to Docs MCP or web search.
Can this skill help me choose which OpenAI model to use?
Yes. The skill owns model selection and can provide guidance on choosing the latest model for a use case, including API model migration and prompt-upgrade recommendations.
What happens if the OpenAI docs are unavailable?
The skill falls back to official-domain web search after Docs MCP tools are unavailable or unhelpful, and uses bundled reference files as a last resort with disclosure.

Generated from the current SKILL.md. These answers refresh after source changes.