New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Official agent skill

Openai Docs

by JetBrains in JetBrains/skills

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…

OfficialApache-2.0Auto-check passedAgent Workflows

Install Openai Docs

skills CLI
$ npx skills add JetBrains/skills --skill openai-docs -a claude-code

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

GitHub CLI
$ gh skill install JetBrains/skills 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/JetBrains/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/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
364
Used in
1 other repo
Token cost
~1.3k tokens
SKILL.md length
644 words
Files
8 (incl. references, assets)
Skills in repo
77
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
  • Calls codex; reaches developers.openai.com

What it does

Openai Docs is an agent skill from JetBrains/skills, published by the product's own GitHub organization. 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 explicit GPT-5.4 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.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including reference files and assets (for example `agents/openai.yaml`, `references/gpt-5p4-prompting-guide.md` and `references/latest-model.md`).

It sits in Agent Workflows, covering MCP servers and Citation management. It works with OpenAI and Model Context Protocol. The repository describes itself as: Curated agent skills collection verified by JetBrains. 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
  • Explicit GPT-5.4 upgrade and prompt-upgrade guidance

Example prompts

  • “/openai-docs”

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 e0f258b. 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

    Shell commands in SKILL.md call:

    • 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.3k tokens when it runs, and up to ~8.4k if it reads all its reference files. Until then it costs about 96 tokens; SKILL.md has 644 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~96
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~8.4k

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from JetBrains/skills at commit e0f258b, republished under its Apache-2.0 licence (© JetBrains). 644 words, ~1,327 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 explicit GPT-5.4 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.
metadata.short-description
Reference official OpenAI docs, including upgrade guidance
metadata.author
OpenAI
metadata.source
https://github.com/openai/skills/tree/main/skills/.curated/openai-docs

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 may also load targeted files from references/ for model-selection and GPT-5.4-specific requests, but current OpenAI docs remain authoritative. 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.
  • Load only the relevant file from references/ when the question is about model selection or a GPT-5.4 upgrade.

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 (308 more words)Show less

Workflow

  1. Clarify the product scope and whether the request is general docs lookup, model selection, a GPT-5.4 upgrade, or a GPT-5.4 prompt upgrade.
  2. If it is a model-selection request, load references/latest-model.md.
  3. If it is an explicit GPT-5.4 upgrade request, load references/upgrading-to-gpt-5p4.md.
  4. If the upgrade may require prompt changes, or the workflow is research-heavy, tool-heavy, coding-oriented, multi-agent, or long-running, also load references/gpt-5p4-prompting-guide.md.
  5. Search docs with a precise query.
  6. Fetch the best page and the exact section needed (use anchor when possible).
  7. For GPT-5.4 upgrade reviews, always make the per-usage-site output explicit: target model, starting reasoning recommendation, phase assessment when relevant, prompt blocks, and compatibility status.
  8. Answer with concise guidance and cite the doc source, using the reference files only as helper context.

Reference map

Read only what you need:

  • references/latest-model.md -> model-selection and "best/latest/current model" questions; verify every recommendation against current OpenAI docs before answering.
  • references/upgrading-to-gpt-5p4.md -> only for explicit GPT-5.4 upgrade and upgrade-planning requests; verify the checklist and compatibility guidance against current OpenAI docs before answering.
  • references/gpt-5p4-prompting-guide.md -> prompt rewrites and prompt-behavior upgrades for GPT-5.4; verify prompting guidance against current OpenAI docs before answering.

Quality rules

  • Treat OpenAI docs as the source of truth; avoid speculation.
  • Keep quotes short and within policy limits; prefer paraphrase with citations.
  • If multiple pages differ, call out the difference and cite both.
  • Reference files are convenience guides only; for volatile guidance such as recommended models, upgrade instructions, or prompting advice, current OpenAI docs always win.
  • 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.

© JetBrains, 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 (references, assets) in openai-docs of JetBrains/skills.

  • SKILL.md
  • LICENSE.txt
  • agents/openai.yaml
  • assets/openai-small.svg
  • assets/openai.png
  • references/gpt-5p4-prompting-guide.md
  • references/latest-model.md
  • references/upgrading-to-gpt-5p4.md

Open the folder on GitHubat commit e0f258b

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in JetBrains/skills, which our catalogue first saw on October 7, 2026.

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 skillJetBrains/skills3641 repos~1.3kAutomated safety check: PassApache-2.0
Openai Docslingxling/awesome-skills-cn2991 repos~4.7kAutomated safety check: PassApache-2.0
Openai DocsHaohao-end/openagent807—~1.7kAutomated safety check: PassApache-2.0
Openai Docsdelorenj/mcp-server-trello445—~5.7kAutomated safety check: PassApache-2.0
Openai Docsaafqaq/codex-lb-enhanced1023 repos~861Automated safety check: PassApache-2.0
Codex with ChatGPT Planning LoopXiaoDuoYa/codex-with-chatgpt7.1k—~11kAutomated 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…

    299 GitHub starsUsed in 1 repo~4.7k tokens
    Agent WorkflowsAuto-check passed

  • Openai Docs

    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…

    807 GitHub stars~1.7k tokensUpdated 2 mo ago
    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 14 days 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…

    102 GitHub starsUsed in 3 repos~861 tokens
    DevOps & CloudAuto-check passed

  • Codex with ChatGPT Planning Loop

    XiaoDuoYa/codex-with-chatgpt

    Uses ChatGPT in the browser as the planning and review brain for a Codex session, with Codex keeping all execution and ChatGPT reading the workspace through a bridge.

    7.1k GitHub stars~11k tokensUpdated 7 days ago
    Agent WorkflowsAuto-check: notes

  • Annotate Paper

    54yyyu/zotero-mcp

    Read the open paper and write study annotations into its PDF with zotero-cli - a context box on the title, a four-part summary on the abstract, role-coded abstract highlights, one box per figure…

    5.3k GitHub stars~1.5k tokensUpdated today
    Research & ScienceAuto-check passed

More from JetBrains/skills

All 77 skills in this repo

  • Playwright

    JetBrains/skills

    Official

    A skill your agent uses when the task requires automating a real browser from the terminal (navigation, form filling, snapshots, screenshots, data extraction, UI-flow debugging) via playwright-cli…

    364 GitHub starsUsed in 12 repos~986 tokens
    Auto-check passed

  • Skill Creator

    JetBrains/skills

    Official

    Guide for creating effective skills. An agent skill from JetBrains/skills.

    364 GitHub starsUsed in 122 repos~4.7k tokens
    Auto-check passed

  • Transcribe

    JetBrains/skills

    Official

    Transcribe audio files to text with optional diarization and known-speaker hints.

    364 GitHub starsUsed in 5 repos~776 tokens
    Auto-check passed

  • Imagegen

    JetBrains/skills

    Official

    A skill your agent uses when the user asks to generate or edit images via the OpenAI Image API (for example: generate image, edit/inpaint/mask, background removal or replacement, transparent…

    364 GitHub starsUsed in 4 repos~2.5k tokens
    Auto-check passed

  • Speech

    JetBrains/skills

    Official

    A skill your agent uses when the user asks for text-to-speech narration or voiceover, accessibility reads, audio prompts, or batch speech generation via the OpenAI Audio API; run the bundled CLI…

    364 GitHub starsUsed in 4 repos~1.9k tokens
    Auto-check passed

  • Screenshot

    JetBrains/skills

    Official

    A skill your agent uses when the user explicitly asks for a desktop or system screenshot (full screen, specific app or window, or a pixel region), or when tool-specific capture capabilities are…

    364 GitHub starsUsed in 6 repos~2k tokens
    Auto-check passed

Works with

Categories

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 JetBrains/skills, published by the product's own GitHub organization.4 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; explicit GPT-5.4 upgrade and prompt-upgrade guidance.

How do I install Openai Docs in Claude Code?

Run `npx skills add JetBrains/skills --skill openai-docs -a claude-code`. Or copy the skill folder (openai-docs in JetBrains/skills) 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 JetBrains/skills --skill openai-docs -a codex`. Or copy the skill folder (openai-docs in JetBrains/skills) 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 JetBrains/skills --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 the command-line tools its instructions call (codex).

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. Review the folder before installing.

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.3k tokens (SKILL.md is roughly 5.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 7.1k tokens, read only when the agent opens those files.

What are the alternatives to Openai Docs?

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

Who maintains Openai Docs?

JetBrains (a GitHub organization, an official publisher) maintains it in JetBrains/skills, which has 364 GitHub stars. The repository holds 77 skills in this directory. The repository was last updated on June 29, 2026.

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