Official agent skill

Openai Knowledge

by openai in openai/openai-agents-python

Retrieve authoritative OpenAI API and platform documentation when an integration or claim needs current external evidence.

OfficialMITAuto-check passedAI & LLM Engineering

Install Openai Knowledge

skills CLI
$ npx skills add openai/openai-agents-python --skill openai-knowledge -a claude-code

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

GitHub CLI
$ gh skill install openai/openai-agents-python openai-knowledge --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/openai/openai-agents-python.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/openai-knowledge .claude/skills/openai-knowledge && 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-knowledge
GitHub stars
30k
Used in
1 other repo
Token cost
~408 tokens
SKILL.md length
172 words
Files
2
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

Retrieve authoritative OpenAI API and platform documentation when an integration or claim needs current external evidence.

  • Works in 3 steps: Check whether the Docs MCP server is… → Use MCP tools to pull exact docs → If MCP is not configured, guide setup…
  • Tasks that involve LLM API integration
  • SKILL.md covers Overview and Workflow
  • Calls codex; reaches developers.openai.com

What it does

Openai Knowledge is an agent skill from openai/openai-agents-python, published by the product's own GitHub organization. Retrieve authoritative OpenAI API and platform documentation when an integration or claim needs current external evidence.

Its SKILL.md is about 410 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in AI & LLM Engineering, covering LLM API integration and MCP servers. It works with OpenAI and Model Context Protocol. The repository describes itself as: A lightweight, powerful framework for multi-agent workflows. The licence is MIT.

When your agent uses it

  • Tasks that involve LLM API integration
  • Tasks that involve MCP servers

Example prompts

  • “/openai-knowledge”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Check whether the Docs MCP server is available
  2. Use MCP tools to pull exact docs
  3. If MCP is not configured, guide setup (do not change config unless asked)

What it can do on your machine

Read from SKILL.md and the folder at commit 71c2da4. 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 Knowledge loads about 408 tokens when it runs. Until then it costs about 35 tokens; SKILL.md has 172 words of instructions outside code blocks.

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

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 openai/openai-agents-python at commit 71c2da4, republished under its MIT licence (© openai). 172 words, ~408 tokens.

Download SKILL.mdSave it as .claude/skills/openai-knowledge/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
openai-knowledge
description
Retrieve authoritative OpenAI API and platform documentation when an integration or claim needs current external evidence.

OpenAI Knowledge

Overview

Use the OpenAI Developer Documentation MCP server to search and fetch exact docs (markdown), then base your answer on that text instead of guessing.

Workflow

1) Check whether the Docs MCP server is available

If the mcp__openaiDeveloperDocs__* tools are available, use them.

If you are unsure, run codex mcp list and check for openaiDeveloperDocs.

2) Use MCP tools to pull exact docs
  • Search first, then fetch the specific page or pages.
    • mcp__openaiDeveloperDocs__search_openai_docs → pick the best URL.
    • mcp__openaiDeveloperDocs__fetch_openai_doc → retrieve the exact markdown (optionally with an anchor).
  • When you need endpoint schemas or parameters, use:
    • mcp__openaiDeveloperDocs__get_openapi_spec
    • mcp__openaiDeveloperDocs__list_api_endpoints

Base your answer on the fetched text and quote or paraphrase it precisely. Do not invent flags, field names, defaults, or limits.

3) If MCP is not configured, guide setup (do not change config unless asked)

Provide one of these setup options, then ask the user to restart the Codex session so the tools load:

  • CLI:
    • codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
  • Config file (~/.codex/config.toml):
    • Add:
      toml
      [mcp_servers.openaiDeveloperDocs]
      url = "https://developers.openai.com/mcp"

Also point to: https://developers.openai.com/resources/docs-mcp#quickstart

© openai, MIT. 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 1 other file in .agents/skills/openai-knowledge of openai/openai-agents-python.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 71c2da4

Used in 2 other repositories

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

Compare with similar skills

Openai Knowledge 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 Knowledge compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Openai Knowledge this skillopenai/openai-agents-python30k1 repos~408Automated safety check: PassMIT
Codex Agent Provider for NanoClawnanocoai/nanoclaw31k—~2.3kAutomated safety check: NotesMIT
Openai Docs Skillaiskillstore/marketplace4302 repos~517Automated safety check: PassNone
Atomic Chat MCP Tool for NanoClawnanocoai/nanoclaw31k—~2.6kAutomated safety check: NotesMIT
Auto Review Loop LLMAI4Scientist/nano-scientist1284 repos~1.8kAutomated safety check: WarnNone
Openai Docsaafqaq/codex-lb-enhanced1023 repos~861Automated safety check: PassApache-2.0

Similar skills

  • Installs Codex as an agent provider for NanoClaw groups, with streaming, MCP tools, server-side history and vault-only credentials, next to or instead of Claude.

    31k GitHub stars~2.3k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check: notes
  • Openai Docs Skill

    aiskillstore/marketplace

    Query the OpenAI developer documentation via the OpenAI Docs MCP server using CLI (curl/jq).

    430 GitHub starsUsed in 2 repos~517 tokens
    AI & LLM EngineeringAuto-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 yesterday
    Agent WorkflowsAuto-check: notes
  • Auto Review Loop LLM

    AI4Scientist/nano-scientist

    Autonomous research review loop using any OpenAI-compatible LLM API.

    128 GitHub starsUsed in 4 repos~1.8k tokens
    Agent WorkflowsAuto-check: warnings
  • 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
  • Openma

    openma-ai/open-managed-agents

    Use the openma platform to build, deploy, and manage AI agents.

    315 GitHub stars~854 tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed

More from openai/openai-agents-python

All 14 skills in this repo
  • Implementation Final Review

    openai/openai-agents-python

    Official

    Review completed implementation changes before final verification.

    30k GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Sensitive Logging Audit

    openai/openai-agents-python

    Official

    Audit or fix sensitive-data exposure in Python SDK diagnostics, exceptions, logging, and telemetry.

    30k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Final Release Review

    openai/openai-agents-python

    Official

    Assess a Python SDK release candidate or release plan against the previous release and recommend ship or block.

    30k GitHub stars~5.4k tokensUpdated today
    Auto-check passed
  • Release Candidate Prep

    openai/openai-agents-python

    Official

    Prepare a local Python SDK release candidate in a dedicated worktree.

    30k GitHub stars~4.9k tokensUpdated today
    Auto-check passed
  • Code Change Verification

    openai/openai-agents-python

    Official

    Run the required final formatting, lint, type, and test checks after eligible SDK changes pass review.

    30k GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Examples Run Analysis

    openai/openai-agents-python

    Official

    Analyze logs and source from a completed manual examples run.

    30k GitHub stars~1.1k tokensUpdated today
    Auto-check passed

Questions about Openai Knowledge

What does Openai Knowledge do?

Retrieve authoritative OpenAI API and platform documentation when an integration or claim needs current external evidence. Openai Knowledge is an agent skill from openai/openai-agents-python, published by the product's own GitHub organization. Retrieve authoritative OpenAI API and platform documentation when an integration or claim needs current external evidence.

When should I use Openai Knowledge?

Openai Knowledge fits situations like: tasks that involve LLM API integration; tasks that involve MCP servers.

How do I install Openai Knowledge in Claude Code?

Run `npx skills add openai/openai-agents-python --skill openai-knowledge -a claude-code`. Or copy the skill folder (.agents/skills/openai-knowledge in openai/openai-agents-python) into .claude/skills/openai-knowledge in your project. Claude Code loads it when a task matches its description.

How do I install Openai Knowledge in Codex?

Run `npx skills add openai/openai-agents-python --skill openai-knowledge -a codex`. Or copy the skill folder (.agents/skills/openai-knowledge in openai/openai-agents-python) into .agents/skills/openai-knowledge in your project. Codex loads it when a task matches its description.

Can I use Openai Knowledge 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 openai/openai-agents-python --skill openai-knowledge -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-knowledge, .gemini/skills/openai-knowledge, .github/skills/openai-knowledge and .opencode/skills/openai-knowledge in your project.

What does Openai Knowledge need to run?

Going by SKILL.md and its folder, Openai Knowledge needs the command-line tools its instructions call (codex).

Does Openai Knowledge 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 Knowledge 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 Knowledge use?

Openai Knowledge is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Openai Knowledge use?

About 408 tokens (SKILL.md is roughly 1.6k 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 Knowledge?

Skills that share tags, products or a category with Openai Knowledge: Codex Agent Provider for NanoClaw (nanocoai/nanoclaw, 31k stars), Openai Docs Skill (aiskillstore/marketplace, 430 stars), Atomic Chat MCP Tool for NanoClaw (nanocoai/nanoclaw, 31k stars) and Auto Review Loop LLM (AI4Scientist/nano-scientist, 128 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Openai Knowledge?

openai (a GitHub organization, an official publisher) maintains it in openai/openai-agents-python, which has 29,873 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 7, 2026.

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