Openai Knowledge

Name: Openai Knowledge
Author: openai

openai/openai-agents-python

400 installs
28.4k repo stars
Updated August 4, 2026
openai/openai-agents-python

About

Use when working with the OpenAI API (Responses API) or OpenAI platform features (tools, streaming, Realtime API, auth, models, rate limits, MCP) and you need authoritative, up-to-date documentation (schemas, examples, limits, edge cases). Prefer the OpenAI Developer Documentation MCP server tools when available; otherwise guide the user to enable `openaiDeveloperDocs`. Use the OpenAI Developer Documentation MCP server to search and fetch exact docs (markdown), then base your answer on that text instead of guessing.

Use the OpenAI Developer Documentation MCP server to search and fetch exact docs (markdown), then base your answer on th
### 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

Openai Knowledge by the numbers

400 all-time installs (skills.sh)
+8 installs in the week ending Jul 26, 2026 (Skillselion tracking)
Ranked #1,953 of 16,556 AI & Agent Building skills by installs in the Skillselion catalog
Data as of Aug 4, 2026 (Skillselion catalog sync)

At a glance

openai-knowledge capabilities & compatibility

Capabilities: use the openai developer documentation mcp serve · ### 1) check whether the docs mcp server is avai · if the `mcp__openaideveloperdocs__*` tools are a · if you are unsure, run `codex mcp list` and chec
Use cases: documentation

From the docs

What openai-knowledge says it does

Use when working with the OpenAI API (Responses API) or OpenAI platform features (tools, streaming, Realtime API, auth, models, rate limits, MCP) and you need authoritative, up-to-date documentation (

SKILL.md

npx skills add https://github.com/openai/openai-agents-python --skill openai-knowledge

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/openai/openai-agents-python/openai-knowledge.svg)](https://skillselion.com/skills/openai/openai-agents-python/openai-knowledge)

Installs	400
repo stars	★ 28.4k
Last updated	August 4, 2026
Repository	openai/openai-agents-python ↗

How do I apply openai-knowledge using the workflow in its SKILL.md?

Use when working with the OpenAI API (Responses API) or OpenAI platform features (tools, streaming, Realtime API, auth, models, rate limits, MCP) and you need authoritative, up-to-date do...

Who is it for?

Developers following the openai-knowledge skill for the tasks it documents.

Skip if: Tasks outside the openai-knowledge scope described in SKILL.md.

When should I use this skill?

User mentions openai-knowledge or related triggers from the skill description.

What you get

Working openai-knowledge setup aligned with the documented patterns and constraints.

Doc-backed API answers
Endpoint schema references
MCP setup instructions when tools are missing

By the numbers

Uses 4 OpenAI Developer Documentation MCP tools for search, fetch, OpenAPI spec, and endpoint listing

Files

SKILL.mdMarkdownGitHub ↗

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:

    [mcp_servers.openaiDeveloperDocs]
    url = "https://developers.openai.com/mcp"

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

interface:
  display_name: "OpenAI Knowledge"
  short_description: "Pull authoritative OpenAI platform documentation"
  default_prompt: "Use $openai-knowledge to fetch the exact OpenAI docs needed for this API or platform question."

Related skills

Setup Matt Pocock SkillsScaffold the per-repo configuration that Matt Pocock’s engineering agent skills rely on so they understand the issue tracker, triage labels, and domain documentation la495k196k

Lark AppsConnect Claude, Cursor or custom agents directly to Lark (Feishu) for messaging, document automation, approval workflows and enterprise data access.402k

CavemanSlash token usage by roughly 75% while keeping every technical detail intact when working with Claude Code, Cursor or similar agents.391k94.7k

Lark Skill MakerQuickly turn any Lark/Feishu OpenAPI call or multi-step workflow into a reusable agent skill with its own SKILL.md.386k16k

Running Claude Code Via Litellm CopilotRun Claude Code at a fraction of the cost by routing requests through LiteLLM to the GitHub Copilot Chat API.270k72

Codex PetGenerate a complete Codex Pet spritesheet and metadata from one reference image without needing an OpenAI key or Codex Pro.246k10

How it compares

Pick openai-knowledge over general web search when OpenAI API field accuracy matters and the Developer Documentation MCP can supply authoritative markdown.

FAQ

What does openai-knowledge do?