Agent skill

Openai Docs

by Haohao-end in Haohao-end/openagent

A skill your agent uses when the user asks how to build with OpenAI products or APIs and needs up-to-date official documentation with citations, help choosing the latest model for a use case, or…

Apache-2.0Auto-check passedAgent Workflows

Install Openai Docs

skills CLI
$ npx skills add Haohao-end/openagent --skill openai-docs -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Haohao-end/openagent openai-docs --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Haohao-end/openagent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/api/internal/core/skills/catalog/openai-docs .claude/skills/openai-docs && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
openai-docs
GitHub stars
808
Token cost
~1.7k tokens
SKILL.md length
857 words
Files
8 (incl. scripts, assets)
Skills in repo
6
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when the user asks how to build with OpenAI products or APIs and needs up-to-date official documentation with citations, help choosing the latest model for a use case, or…

  • Works in 7 steps: Apps SDK: Build ChatGPT apps by… → Responses API: A unified endpoint… → Chat Completions API: Generate a model… → …
  • The user asks how to build with OpenAI products
  • SKILL.md covers Quick start, OpenAI product snapshots, If MCP server is missing and Workflow, plus 3 more sections
  • Runs JavaScript scripts from its folder; calls node and codex; reaches developers.openai.com

What it does

Openai Docs is an agent skill from Haohao-end/openagent. Use when the user asks how to build with OpenAI products or APIs and needs up-to-date official documentation with citations, help choosing the latest model for a use case, or model upgrade and prompt-upgrade guidance; prioritize OpenAI docs MCP tools, use bundled references only as helper context, and restrict any fallback browsing to official OpenAI domains.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including scripts and assets (for example `agents/openai.yaml`, `manifest.yaml` and `scripts/resolve-latest-model-info.js`).

It sits in Agent Workflows, covering MCP servers and Citation management. It works with OpenAI and Model Context Protocol. The repository describes itself as: What if OpenAI Deep Research and Dify were one platform? OpenAgent — harness architecture for rapidly building vertical AI agents, with deep reasoning loops, visual workflows… The licence is Apache-2.0.

When your agent uses it

  • The user asks how to build with OpenAI products
  • APIs and needs up-to-date official documentation with citations
  • Help choosing the latest model for a use case
  • Model upgrade and prompt-upgrade guidance

Example prompts

  • “/openai-docs”

Requirements

  • Node.js

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Apps SDK: Build ChatGPT apps by providing a web component UI and an MCP server that exposes your app's tools to ChatGPT.
  2. Responses API: A unified endpoint designed for stateful, multimodal, tool-using interactions in agentic workflows.
  3. Chat Completions API: Generate a model response from a list of messages comprising a conversation.
  4. Codex: OpenAI's coding agent for software development that can write, understand, review, and debug code.
  5. gpt-oss: Open-weight OpenAI reasoning models (gpt-oss-120b and gpt-oss-20b) released under the Apache 2.0 license.
  6. Realtime API: Build low-latency, multimodal experiences including natural speech-to-speech conversations.
  7. Agents SDK: A toolkit for building agentic apps where a model can use tools and context, hand off to other agents, stream partial results…

What it can do on your machine

Read from SKILL.md and the folder at commit 4013ab2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • node
    • codex

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • developers.openai.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Openai Docs loads about 1.7k tokens when it runs. Until then it costs about 93 tokens; SKILL.md has 857 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~93
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from Haohao-end/openagent at commit 4013ab2, republished under its Apache-2.0 licence (© Haohao-end). 857 words, ~1,717 tokens.

Download SKILL.mdSave it as .claude/skills/openai-docs/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
openai-docs
description
Use when the user asks how to build with OpenAI products or APIs and needs up-to-date official documentation with citations, help choosing the latest model for a use case, or model upgrade and prompt-upgrade guidance; prioritize OpenAI docs MCP tools, use bundled references only as helper context, and restrict any fallback browsing to official OpenAI domains.

OpenAI Docs

Provide authoritative, current guidance from OpenAI developer docs using the developers.openai.com MCP server. Always prioritize the developer docs MCP tools over web.run for OpenAI-related questions. This skill also owns model selection, API model migration, and prompt-upgrade guidance. Only if the MCP server is installed and returns no meaningful results should you fall back to web search.

Quick start

  • Use mcp__openaiDeveloperDocs__search_openai_docs to find the most relevant doc pages.
  • Use mcp__openaiDeveloperDocs__fetch_openai_doc to pull exact sections and quote/paraphrase accurately.
  • Use mcp__openaiDeveloperDocs__list_openai_docs only when you need to browse or discover pages without a clear query.
  • For model-selection, "latest model", or default-model questions, fetch https://developers.openai.com/api/docs/guides/latest-model.md first. If that is unavailable, load references/latest-model.md.
  • For model upgrades or prompt upgrades, run node scripts/resolve-latest-model-info.js only when the target is latest/current/default or otherwise unspecified; otherwise preserve the explicitly requested target.
  • Preserve explicit target requests: if the user names a target model like "migrate to GPT-5.4", keep that requested target even if latest-model.md names a newer model. Mention newer guidance only as optional.
  • If current remote guidance is needed, fetch both the returned migration and prompting guide URLs directly. If direct fetch fails, use MCP/search fallback; if that also fails, use bundled fallback references and disclose the fallback.

OpenAI product snapshots

  1. Apps SDK: Build ChatGPT apps by providing a web component UI and an MCP server that exposes your app's tools to ChatGPT.
  2. Responses API: A unified endpoint designed for stateful, multimodal, tool-using interactions in agentic workflows.
  3. Chat Completions API: Generate a model response from a list of messages comprising a conversation.
  4. Codex: OpenAI's coding agent for software development that can write, understand, review, and debug code.
  5. gpt-oss: Open-weight OpenAI reasoning models (gpt-oss-120b and gpt-oss-20b) released under the Apache 2.0 license.
  6. Realtime API: Build low-latency, multimodal experiences including natural speech-to-speech conversations.
  7. Agents SDK: A toolkit for building agentic apps where a model can use tools and context, hand off to other agents, stream partial results, and keep a full trace.

If MCP server is missing

If MCP tools fail or no OpenAI docs resources are available:

  1. Run the install command yourself: codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
  2. If it fails due to permissions/sandboxing, immediately retry the same command with escalated permissions and include a 1-sentence justification for approval. Do not ask the user to run it yet.
  3. Only if the escalated attempt fails, ask the user to run the install command.
  4. Ask the user to restart Codex.
  5. Re-run the doc search/fetch after restart.
Show full SKILL.md (440 more words)Show less

Workflow

  1. Clarify whether the request is general docs lookup, model selection, a model-string upgrade, prompt-upgrade guidance, or broader API/provider migration.
  2. For model-selection or upgrade requests, prefer current remote docs over bundled references when the user asks for latest/current/default guidance.
    • Fetch https://developers.openai.com/api/docs/guides/latest-model.md.
    • Find the latest model ID and explicit migration or prompt-guidance links.
    • Prefer explicit links from the latest-model page over derived URLs.
    • For explicit named-model requests, preserve the requested model target and do not silently retarget to the latest model. Mention newer remote guidance only as optional.
    • For dynamic latest/current/default upgrades, run node scripts/resolve-latest-model-info.js, then fetch both returned guide URLs directly when possible.
    • If direct guide fetch fails, use the developer-docs MCP tools or official OpenAI-domain search to find the same guide content.
    • If remote docs are unavailable, use bundled fallback references and say that fallback guidance was used.
  3. For model upgrades, keep changes narrow: update active OpenAI API model defaults and directly related prompts only when safe.
  4. Leave historical docs, examples, eval baselines, fixtures, provider comparisons, provider registries, pricing tables, alias defaults, low-cost fallback paths, and ambiguous older model usage unchanged unless the user explicitly asks to upgrade them.
  5. Do not perform SDK, tooling, IDE, plugin, shell, auth, or provider-environment migrations as part of a model-and-prompt upgrade.
  6. If an upgrade needs API-surface changes, schema rewiring, tool-handler changes, or implementation work beyond a literal model-string replacement and prompt edits, report it as blocked or confirmation-needed.
  7. For general docs lookup, search docs with a precise query, fetch the best page and exact section needed, and answer with concise citations.

Reference map

Read only what you need:

  • https://developers.openai.com/api/docs/guides/latest-model.md -> current model-selection and "best/latest/current model" questions.
  • references/latest-model.md -> bundled fallback for model-selection and "best/latest/current model" questions.
  • references/upgrade-guide.md -> bundled fallback for model upgrade and upgrade-planning requests.
  • references/prompting-guide.md -> bundled fallback for prompt rewrites and prompt-behavior upgrades.

Quality rules

  • Treat OpenAI docs as the source of truth; avoid speculation.
  • Keep migration changes narrow and behavior-preserving.
  • Prefer prompt-only upgrades when possible.
  • Do not invent pricing, availability, parameters, API changes, or breaking changes.
  • Keep quotes short and within policy limits; prefer paraphrase with citations.
  • If multiple pages differ, call out the difference and cite both.
  • If official docs and repo behavior disagree, state the conflict and stop before making broad edits.
  • If docs do not cover the user’s need, say so and offer next steps.

Tooling notes

  • Always use MCP doc tools before any web search for OpenAI-related questions.
  • If the MCP server is installed but returns no meaningful results, then use web search as a fallback.
  • When falling back to web search, restrict to official OpenAI domains (developers.openai.com, platform.openai.com) and cite sources.

© Haohao-end, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 7 other files (scripts, assets) in api/internal/core/skills/catalog/openai-docs of Haohao-end/openagent.

  • SKILL.md
  • LICENSE.txt
  • agents/openai.yaml
  • assets/openai-small.svg
  • assets/openai.png
  • manifest.yaml
  • scripts/resolve-latest-model-info.js
  • skill.md

Open the folder on GitHubat commit 4013ab2

Compare with similar skills

Openai Docs next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Openai Docs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Openai Docs this skillHaohao-end/openagent808—~1.7kAutomated safety check: PassApache-2.0
Openai Docslingxling/awesome-skills-cn3011 repos~4.7kAutomated safety check: PassApache-2.0
Openai Docsdelorenj/mcp-server-trello445—~5.7kAutomated safety check: PassApache-2.0
Openai DocsJetBrains/skills366—~1.3kAutomated safety check: PassApache-2.0
Openai Docsaafqaq/codex-lb-enhanced1032 repos~861Automated safety check: PassApache-2.0
Atomic Chat MCP Tool for NanoClawnanocoai/nanoclaw31k—~2.6kAutomated safety check: NotesMIT

Similar skills

  • Openai Docs

    lingxling/awesome-skills-cn

    A skill your agent uses 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…

    301 GitHub starsUsed in 1 repo~4.7k tokens
    Agent WorkflowsAuto-check passed
  • Openai Docs

    delorenj/mcp-server-trello

    A skill your agent uses 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…

    445 GitHub stars~5.7k tokensUpdated 16 days ago
    Agent WorkflowsAuto-check passed
  • Openai Docs

    JetBrains/skills

    Official

    A skill your agent uses when the user asks how to build with OpenAI products or APIs and needs up-to-date official documentation with citations, help choosing the latest model for a use case, or…

    366 GitHub stars~1.3k tokensUpdated 3 mo ago
    Agent WorkflowsAuto-check passed
  • Openai Docs

    aafqaq/codex-lb-enhanced

    A skill your agent uses when the user asks how to build with OpenAI products or APIs and needs up-to-date official documentation with citations (for example: Codex, Responses API, Chat Completions…

    103 GitHub starsUsed in 2 repos~861 tokens
    DevOps & CloudAuto-check passed
  • Adds an MCP server to NanoClaw so its container agent can list and prompt local models served by the Atomic Chat desktop app.

    31k GitHub stars~2.6k tokensUpdated 3 days ago
    Agent WorkflowsAuto-check: notes
  • Mcpa Certification

    fancyboi999/ai-engineering-from-scratch-zh

    AI Engineering from Scratch 中文版中的 MCPA(Model Context Protocol Associate)AI 原生导师与入门流程。学习者需要备考 MCPA、继续认证路线、 交互式学习下一课、运行并验证实践实验、参加诊断或全真模拟、根据薄弱领域 补弱时使用。适用于 Claude Code、Codex、ChatGPT、Cursor 或其他 agent。

    1.2k GitHub stars~1.4k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from Haohao-end/openagent

  • Chatgpt Apps

    Haohao-end/openagent

    Build, scaffold, refactor, and troubleshoot ChatGPT Apps SDK applications that combine an MCP server and widget UI.

    808 GitHub starsUsed in 1 repo~4.9k tokens
    Auto-check passed
  • Migrate To Codex

    Haohao-end/openagent

    Migrate supported instruction files, skills, agents, and MCP config into Codex project and global files.

    808 GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Playwright Interactive

    Haohao-end/openagent

    Persistent browser and Electron interaction through jsrepl for fast iterative UI debugging.

    808 GitHub starsUsed in 1 repo~7.9k tokens
    Auto-check passed
  • Creative

    Haohao-end/openagent

    A skill your agent uses when the user wants a less default, more original solution for code, design, writing, naming, architecture, debugging, or strategy, especially when progress is stuck.

    808 GitHub stars~230 tokensUpdated 2 mo ago
    Auto-check passed
  • Frontend Design

    Haohao-end/openagent

    A skill your agent uses when the user wants a distinctive, production-ready frontend interface with clear visual direction, strong hierarchy, and polished interaction details.

    808 GitHub stars~270 tokensUpdated 2 mo ago
    Auto-check passed

Questions about Openai Docs

What does Openai Docs do?

A skill your agent uses when the user asks how to build with OpenAI products or APIs and needs up-to-date official documentation with citations, help choosing the latest model for a use case, or…. Openai Docs is an agent skill from Haohao-end/openagent. Use when the user asks how to build with OpenAI products or APIs and needs up-to-date official documentation with citations, help choosing the latest model for a use case, or model upgrade and prompt-upgrade guidance; prioritize OpenAI docs MCP tools, use bundled references only as helper context, and restrict any fallback browsing to official OpenAI domains.

When should I use Openai Docs?

Openai Docs fits situations like: the user asks how to build with OpenAI products; APIs and needs up-to-date official documentation with citations; help choosing the latest model for a use case; model upgrade and prompt-upgrade guidance.

How do I install Openai Docs in Claude Code?

Run `npx skills add Haohao-end/openagent --skill openai-docs -a claude-code`. Or copy the skill folder (api/internal/core/skills/catalog/openai-docs in Haohao-end/openagent) into .claude/skills/openai-docs in your project. Claude Code loads it when a task matches its description.

How do I install Openai Docs in Codex?

Run `npx skills add Haohao-end/openagent --skill openai-docs -a codex`. Or copy the skill folder (api/internal/core/skills/catalog/openai-docs in Haohao-end/openagent) into .agents/skills/openai-docs in your project. Codex loads it when a task matches its description.

Can I use Openai Docs in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Haohao-end/openagent --skill openai-docs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/openai-docs, .gemini/skills/openai-docs, .github/skills/openai-docs and .opencode/skills/openai-docs in your project.

What does Openai Docs need to run?

Going by SKILL.md and its folder, Openai Docs needs JavaScript for the scripts in its folder and the command-line tools its instructions call (node and codex). Our summary lists: Node.js.

Does Openai Docs access the network?

SKILL.md names 1 domain. In commands or code: developers.openai.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Openai Docs safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Openai Docs use?

Openai Docs is published under the Apache-2.0 licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Openai Docs use?

About 1.7k tokens (SKILL.md is roughly 6.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Openai Docs?

Skills that share tags, products or a category with Openai Docs: Openai Docs (lingxling/awesome-skills-cn, 301 stars), Openai Docs (delorenj/mcp-server-trello, 445 stars), Openai Docs (JetBrains/skills, 366 stars) and Openai Docs (aafqaq/codex-lb-enhanced, 103 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Openai Docs?

Haohao-end (a GitHub user) maintains it in Haohao-end/openagent, which has 808 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on July 17, 2026.

Source: Haohao-end/openagent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.