Agent Native

openai-knowledge

This skill connects an agent to OpenAI's official API documentation through an MCP server, enabling retrieval of current, authoritative information about…

by OpenAIOfficial publisherNot reviewed

Identity proven by GitHub's verified organisation badge (openai)

Agents
Codex
License
MIT (permissive)
Pin
125efa0pinned Oct 9, 2026
Context cost
about 370 tokenswhen the skill loads
GitHub stars
29,916on openai/openai-agents-python
Scripts
None found

What it does

“Retrieve authoritative OpenAI API and platform documentation when an integration or claim needs current external evidence.”
The author's description, from SKILL.md

Generated summary from the skill's own text

This skill connects an agent to OpenAI's official API documentation through an MCP server, enabling retrieval of current, authoritative information about OpenAI's platform and APIs. The agent searches and fetches exact documentation pages, endpoint schemas, and parameters to answer questions with verified facts instead of assumptions.

When to use it

  • Verifying OpenAI API features, parameters, or capabilities
  • Retrieving current endpoint schemas or field definitions
  • Answering questions requiring authoritative OpenAI platform documentation
  • Building integrations that need exact API specifications

When not to

  • The openaiDeveloperDocs MCP server is not configured or unavailable
  • Questions about general OpenAI news or company announcements
  • When cached knowledge of OpenAI APIs is sufficient

Install

These commands install from the publisher's repository and need no account.

skills CLI

npx skills add openai/openai-agents-python --skill openai-knowledge

Installs from the repository's default branch, which may have changed since the commit we checked.

GitHub CLI 2.90 or later

gh skill install openai/openai-agents-python openai-knowledge@125efa029b4bfd84238bd2c4fd69c3406f802663

Installs the commit we checked (125efa0).

Copy by hand

Download the folder at 125efa0 and put it in .claude/skills/openai-knowledge for Claude Code and in .agents/skills/openai-knowledge for Codex, Cursor, Gemini CLI, GitHub Copilot and OpenCode.

Skill folder on GitHub at 125efa0

Copy for your agent

A prompt for any coding agent. It installs this skill from GitHub at the pinned commit, copies the files as they are, and runs nothing unless you ask.

Prompt

Install the agent skill "openai-knowledge" by OpenAI.

Source, pinned to commit 125efa029b4bfd84238bd2c4fd69c3406f802663:
https://github.com/openai/openai-agents-python/tree/125efa029b4bfd84238bd2c4fd69c3406f802663/.agents/skills/openai-knowledge

1. Download that folder at exactly this commit. Do not use the default branch.
2. Copy every file unchanged, keeping the folder structure, into .claude/skills/openai-knowledge/ for Claude Code and .agents/skills/openai-knowledge/ for Codex, Cursor, Gemini CLI, GitHub Copilot and OpenCode. Create the folders if they do not exist.
3. Do not edit the files, and do not run any script in the folder unless I ask you to.
4. When you are done, list the files you copied and where you put them.

Listing and checks: https://www.agentnative.dev/skills/openai/openai-knowledge-openai-agents-python

SKILL.md at the pin

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

From openai/openai-agents-python at 125efa0, shown as plain text under its license: MIT (permissive). The license text is in LICENSE.

View SKILL.md on GitHub at 125efa0

Files

2 files, 1.9 KB in total. Each file has a sha256 in the pin's manifest; the first 12 characters are shown.

Skill folder on GitHub at 125efa0
All 50 skills from OpenAI

More from OpenAI

  • code-change-verification

    Runs formatting, linting, type checking, and test verification for SDK code changes after review.

    Contains scripts

    Codex · about 1.3K tokens · pinned 6 days ago

  • docs-sync

    This skill audits English SDK documentation by comparing features and configuration options in the codebase against the current docs, then proposes or…

    Claude Code, Codex, Cursor +4 · about 1.2K tokens · pinned 6 days ago

  • examples-run-analysis

    Analyzes logs and artifacts from manual examples runs to validate example behaviors, identify failures, and classify issues.

    Claude Code, Codex, Cursor +4 · about 1K tokens · pinned 6 days ago

  • final-release-review

    Audits Python SDK release candidates or plans against the previous release, comparing diffs for regressions, API changes, and version compatibility.

    Contains scripts

    Claude Code, Codex, Cursor +3 · about 5.4K tokens · pinned 6 days ago

  • implementation-final-review

    This skill guides agents through a structured review process for completed implementation changes before final verification.

    Contains scripts

    Claude Code, Codex, Cursor +3 · about 1.9K tokens · pinned 6 days ago

  • implementation-kickoff

    This skill manages an isolated implementation workflow using a dedicated git worktree, keeping the user's original checkout unchanged while building a…

    Contains scripts

    Codex · about 2.9K tokens · pinned 6 days ago

All AI and agents skills

Related in AI and agents

  • openai-knowledge

    This skill enables the agent to retrieve current OpenAI API documentation through an MCP server, search for specific topics, and fetch exact markdown pages or…

    by OpenAIOfficial publisher

    Codex · about 370 tokens · pinned 6 days ago

  • azure-ai

    This skill enables agents to use Azure AI services including Search for full-text and vector queries, Speech for transcription and synthesis, OpenAI for…

    by MicrosoftOfficial publisher

    Claude Code, Codex, Cursor +4 · about 750 tokens · pinned 6 days ago

  • neo4j-agent-memory-skill

    Provides authoritative reference for neo4j-agent-memory, a Python package that adds graph-native memory to AI agents through three distinct layers (short-term…

    by neo4j-contribCommunity

    Claude Code, Codex, Cursor +3 · about 5.5K tokens · pinned 6 days ago

  • -21risk-automation

    This skill automates 21risk operations by connecting to the 21risk toolkit through Composio's Rube MCP server.

    by ComposioOfficial publisher

    Claude Code, Codex, Cursor +3 · about 690 tokens · pinned 6 days ago

  • -2chat-automation

    This skill automates 2chat tasks by integrating with Composio's 2chat toolkit through Rube MCP.

    by ComposioOfficial publisher

    Agents not labelled yet · about 680 tokens · pinned 6 days ago

  • ably-automation

    This skill automates Ably messaging platform tasks by connecting to Composio's Ably toolkit through Rube MCP.

    by ComposioOfficial publisher

    Agents not labelled yet · about 680 tokens · pinned 6 days ago

Open roles at OpenAI

5 of 242 open roles on the jobs board

See all 242 roles at OpenAI on the jobs board

The skills listed here are third-party software, collected from public GitHub repositories as a catalog of recent skills and provided as is. Agent Native does not write or control them and is not responsible for any harm, loss or damage caused by installing or using them. Labels and checks describe what we saw at one commit and are not a guarantee. Read a skill's files before you run it. Terms of use