Dev & Engineering ✓ OpenAI · Official

OpenAI Official Docs Assistant

Provides current, official-source guidance for OpenAI products, APIs, Codex, and model migrations.

52/ 100
Use with care

Useful, but reliability, evidence or controls still have material gaps.

See how it was scored ↓
Works as-is in
Codex · Claude Code
Stars
★ 129k
Last updated
11d ago
License
Apache-2.0
openai-docsapi-referencemodel-selectionprompt-upgrades
+2codexmcp

What does this skill do, and when should you use it?

This Agent Skill from the openai/codex repository handles questions about OpenAI products and APIs. It prioritizes the OpenAI Developer Docs MCP and uses a Codex manual helper first for broad Codex questions. It also owns model selection, API model migration, and prompt-upgrade guidance, with fallback web searches restricted to official OpenAI domains. The repository is licensed under Apache-2.0, but the source does not document a standalone installation process for this Skill.

Classifies requests and selects the Codex manual helper, OpenAI Developer Docs MCP, or official-domain web search; searches and fetches relevant official documentation; uses an OpenAPI specification tool for API reference, schema, parameter, or required-field questions when available; runs a model resolver to obtain current model, migration-guide, and prompting-guide URLs; and may read or write temporary cache files before producing cited guidance.

Good fit
  • A developer needs to verify how to call an OpenAI API or configure API parameters.
  • A Codex user needs guidance on Codex configuration, customization, skills, plugins, MCP, or other product behavior.
  • A team is selecting a current model or planning an API model migration.
  • An engineer needs prompting guidance for a named GPT-5-family model.
  • A reader wants an OpenAI documentation answer supported by official citations.

How do you install this skill?

Before you use it
  • Core retrieval depends on the OpenAI Docs MCP and developers.openai.com; restricted mainland-China connectivity or an uninstalled MCP server may make key functionality unavailable.
  • The bundled model and prompting references explicitly may drift; current documentation must be checked before presenting current recommendations.
  • The script, MCP calls, and migration workflow were not executed in this static review; documented procedures should not be treated as tested behavior.
  • The helper writes a temporary cache and accesses remote services; deployment-specific review is still needed for data flow, proxy configuration, and cached content.
Before you start
Your agent needs
  • Shell / CLI
  • Network access
  • Local filesystem
  • MCP Server
Install first
  • Node.js 18+

The source only documents installation for the overall Codex CLI collection: on macOS or Linux run curl -fsSL https://chatgpt.com/codex/install.sh | sh; on Windows run powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"; or use npm install -g @openai/codex or brew install --cask codex. It does not document how to install this Skill independently into another client.

Generic route: install into Claude Code manually (macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/openai/codex.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/codex-rs/skills/src/assets/samples/openai-docs" ~/.claude/skills/
rm -rf "$tmp"

Generated from the source repository and skill path; it copies only this skill's folder. If the author's install steps above differ, follow those first. To scope it to one project, replace ~/.claude/skills with that project's .claude/skills.

How do you use this skill?

Try saying

Once installed, send your agent any of these to trigger it:

  • Using current official OpenAI documentation, explain how the Responses API supports a multimodal tool-using workflow and provide citations.

In an installed Codex environment, submit a focused request such as: “Using current official OpenAI documentation, explain how the Responses API supports a multimodal tool-using workflow and provide citations.” For Codex questions, ask directly about Codex configuration, skills, or MCP. The source does not specify an independent-client enablement command or complete trigger syntax.

What are this skill's strengths and limitations?

Pros
  • Explicitly prioritizes official OpenAI documentation and the Codex manual.
  • Covers API documentation, Codex self-knowledge, model selection, model migration, and prompt upgrades.
  • Can verify API references and OpenAPI specifications when the relevant tool is available.
  • Restricts web fallback to official OpenAI domains.
Limitations
  • Depends on the OpenAI Developer Docs MCP, the Codex manual helper, or official network access.
  • The model-resolution workflow requires Node.js 18 or newer.
  • Temporary caching requires filesystem access.
  • No standalone installation procedure, test suite, or cross-client validation evidence is provided.

How does this skill compare with similar options?

Side by side with related skills; every score comes from the same FSRS standard.

Skill FS score Stars Last updated License
OpenAI Official Docs Assistant this page ✓ OpenAI · Official 52 · Use with care ★ 129k 11d ago Apache-2.0
OpenAI Developer Docs Assistant ✓ OpenAI · Official 55 · Use with care ★ 28k 4mo ago —
Azure OpenAI Deployment Assistant ✓ Microsoft · Official 52 · Use with care ★ 2.7k 3mo ago MIT
Engram Persistent Memory Protocol 68 · Recommended ★ 7.2k 11d ago MIT
Xberg API Server & MCP Protocol Integration 52 · Use with care ★ 9.4k 11d ago MIT

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Use with care
52/ 100 5-point scale 2.6 / 5
The upstream repository has new commits since this review. The score still applies to the reviewed revision shown and may not cover the latest changes.
1Trust16 / 25 · 3.2/5

The skill restricts retrieval to the official OpenAI Docs MCP and official-domain fallback, and describes an API-key gate plus read-only retrieval boundaries. Deductions apply because MCP data flows, sensitive-credential handling, user confirmation, rollback, and network-dependency risks are not fully specified.

2Reliability8 / 20 · 2.0/5

Routing rules, fallbacks, cache validation, timeouts, and error handling are detailed, and the script implements hash verification and atomic writes. Static review cannot execute key paths; MCP availability, Windows/proxy behavior, and remote-response compatibility are not demonstrated by tests, so the score remains below the static ceiling.

3Adaptability8 / 15 · 2.7/5

The audience and core scenarios are reasonably clear: OpenAI documentation, Codex self-knowledge, model selection, and migration guidance, with some non-fit boundaries. Deductions apply because triggering is complex, Chinese-language output is not specified, and core functionality depends on the developers.openai.com MCP and official network access, which may be difficult from mainland China.

4Convention9 / 15 · 3.0/5

The skill has clear structure, dependency declaration, references, fallback rules, and Apache-2.0 licensing, with substantial progressive disclosure. Deductions apply for the absence of an independent version, changelog, named maintenance owner, and explicit update process; the bundled references also acknowledge drift risk.

5Effectiveness7 / 15 · 2.3/5

For current OpenAI documentation, Codex self-knowledge, and model-migration tasks, the routing and guidance are directly useful and include compatibility and validation checklists. No representative outputs or execution evidence are included, and remote-tool failure may require manual handling, so this is limited to the static-review effectiveness ceiling.

6Verifiability4 / 10 · 2.0/5

The helper provides HTTP hash checks, cache status, and auditable local manual paths, while tool names and source URLs are specific. Deductions apply because there is no committed key-path test suite, CI execution evidence, or independent corroboration; much of the behavior depends on runtime MCP and network conditions.

1 2 3 4 5 6

Open a dimension to read why it scored that way

Reviewed Jul 19, 2026 Reviewed revision 678157acaa81 Review evidence[1][2][3][4][5][6][7][8][9][10]

Evidence confidence:Low — Mostly static review, author material or a limited demo; useful for discovery, not high-risk decisions.

See the full review method →

FAQ

Is it only for Codex CLI?
The source places it in the Codex repository and references a Codex manual helper, but provides no standalone installation or enablement instructions for other clients.
Which sources does it use?
It prioritizes OpenAI Developer Docs MCP for non-Codex documentation questions, the Codex manual for broad Codex questions, and official OpenAI domains for web fallback.
Does it require network access or MCP?
Its design requires access to official documentation or the network; non-Codex documentation questions explicitly use the OpenAI Developer Docs MCP.
Can it answer any software-development question?
Not necessarily. Its documented scope is OpenAI products, APIs, Codex, model selection and migration, and prompt upgrades.

More skills from this repository

All from openai/codex

Design & Frontend ✓ OpenAI · Official

Codex Image Generation Skill (imagegen)

Generate or edit bitmap assets — photos, illustrations, textures, UI and product mockups — directly in Codex, with local transparent-background processing.

★ 129k FS 56 Use with care 11d ago
Dev & Engineering ✓ OpenAI · Official

Codex Issue Digest

Turns recent openai/codex bugs and enhancement requests into focused, owner-ready digests.

★ 129k FS 57 Use with care 11d ago
Dev & Engineering ✓ OpenAI · Official

Codex Plugin Builder

Scaffold, validate, and maintain standards-shaped plugins for Codex.

★ 129k FS 55 Use with care 11d ago
Dev & Engineering ✓ OpenAI · Official

Codex Bug Triage Assistant

Determines whether an openai/codex GitHub bug should be verified, clarified, or explained as expected behavior.

★ 129k FS 40 Not recommended 11d ago
Dev & Engineering ✓ OpenAI · Official

Breaking Change Reviewer

Systematically detect compatibility risks across external integration surfaces before they reach users.

★ 129k FS 37 Not recommended 11d ago
Dev & Engineering ✓ OpenAI · Official

Codex TUI Interactive Testing Guide

A focused workflow for launching Codex TUI and validating changes with trace logs.

★ 129k FS 37 Not recommended 11d ago
Dev & Engineering ✓ OpenAI · Official

Context Governance

Keep coding-agent context incremental, cache-stable, and strictly bounded.

★ 129k FS 35 Not recommended 11d ago
Dev & Engineering ✓ OpenAI · Official

PR Babysitter

Continuously track a GitHub pull request’s reviews, CI, and mergeability while handling safe fixes.

★ 129k FS 57 Use with care 11d ago
Dev & Engineering ✓ OpenAI · Official

Codex Bundled Skill Installer

Install curated or repository-hosted Codex skills without manually assembling their files and paths.

★ 129k FS 53 Use with care 11d ago
Dev & Engineering ✓ OpenAI · Official

Review Agent Code Review Skill

Find actionable regressions in code changes through a read-only, defect-first review.

★ 129k FS 52 Use with care 11d ago
Dev & Engineering ✓ OpenAI · Official

Codex Pull Request Editor

Professionally update one or more GitHub pull request titles and bodies around motivation, net changes, and verification.

★ 129k FS 50 Use with care 11d ago
Dev & Engineering ✓ OpenAI · Official

Remote Executor Integration Tests

Validate Codex integration behavior across local and remote execution environments.

★ 129k FS 50 Use with care 11d ago
Dev & Engineering ✓ OpenAI · Official

V8 Version Maintainer

Updates Codex’s pinned V8 versions and validates release-candidate and build-failure paths.

★ 129k FS 50 Use with care 11d ago
Dev & Engineering ✓ OpenAI · Official

Change Size Review Guide

Keep code changes reviewable by enforcing practical size limits and staging oversized work.

★ 129k FS 48 Use with care 11d ago
Dev & Engineering ✓ OpenAI · Official

Codex Path Types Guide

Choose Rust path types that preserve cross-platform URI handling and local filesystem behavior in Codex.

★ 129k FS 47 Use with care 11d ago
Dev & Engineering ✓ OpenAI · Official

Codex Sample Skill Creator Guide

A practical guide to designing, validating, and refining reusable Agent Skills.

★ 129k FS 46 Use with care 11d ago
Automation & Ops ✓ OpenAI · Official

CI Push Approval Assistant

Handle CI configuration push blocks and approval handoffs

★ 129k FS 45 Not recommended 11d ago
Dev & Engineering ✓ OpenAI · Official

Code Review and Testing Guidance

Helps coding agents choose and structure tests for logic changes.

★ 129k FS 43 Not recommended 11d ago
Dev & Engineering ✓ OpenAI · Official

Pull Request Code Review

Orchestrate a final pull request review and consolidate every actionable finding from specialized reviewers.

★ 129k FS 33 Not recommended 11d ago

Related skills