Skip to main content
skillsSource-backed
OpenAI logo

OpenAI Docs Skill

Official OpenAI skill that tells agents to use the OpenAI developer documentation MCP server first for API, Codex, Apps SDK, model-selection, and migration questions.

Level:foundationalType:generalVerified:validated
Review first review before installing

Open the source and read safety notes before installing.

Citation facts

Source-backed facts for citing this resource, derived directly from the registry — also available as plain text for AI assistants.

Source URLs
https://developers.openai.com/learn/docs-mcp, https://github.com/openai/skills
Brand
OpenAI
Brand domain
openai.com
Brand asset source
brandfetch
Safety notes
The skill is read-only guidance; it does not call OpenAI APIs, create API keys, modify accounts, or execute code by itself., Do not use the skill as proof that a model, API parameter, entitlement, or product feature exists; it routes the agent to official docs so the answer can be verified., Keep model upgrade work narrow unless the user explicitly asks for SDK, auth, environment, or provider migration changes.
Privacy notes
Documentation queries can reveal what product, API, model, migration, or customer workflow the user is researching., Avoid sending private prompts, customer data, secrets, internal repository names, or unreleased product plans through docs-search queries., Skill text, fetched docs, citations, and agent transcripts can persist in local logs or conversation history depending on the client.
Platform compatibility
claude-code (native-skill), codex (native-skill), windsurf (native-skill), gemini (native-skill), cursor (adapter), cli (manual-context)
Author
OpenAI
Submitted by
JSONbored
Claim status
unclaimed
Last verified
2026-06-05

Decision playbook

Review trust signals before you adopt

Signals are present but mixed. Use the checklist below to confirm the source and operational safety for your environment.

Compare context
Selected

0

Current score

71

Baseline

Delta

No baseline selected

No major trust-signal divergence detected in the current selection.

Source and provenance checks

Needs review

Confirm ownership and provenance before trusting install instructions.

  • Source link availableRequired

    Open the canonical repository and verify ownership.

    Done
  • Source provenance statusRequired

    Marked as source-backed.

    Done
  • Metadata reviewed

    No reviewed flag detected in metadata.

    Pending

Safety and privacy checks

Complete

Validate risk disclosures before installation or API wiring.

  • Safety notes presentRequired

    Review the listed safety guidance before running commands.

    Done
  • Privacy notes presentRequired

    Review data handling notes before connecting accounts or secrets.

    Done
  • Trust level risk gateRequired

    Trust level does not block evaluation.

    Done

Package and install checks

Needs review

Check package metadata and artifact integrity signals.

  • Install payload available

    Install or copy payload is available for review.

    Done
  • Package verification flag

    No package verification flag provided.

    Pending
  • Checksum metadata

    No checksum provided for downloaded artifact.

    Pending

Compare-driven decision checks

Needs review

Use compare context to validate trade-offs before adoption.

  • Compare tray has multiple entries

    Add at least one more entry to compare trust differences.

    Pending
  • Baseline comparison available

    No baseline peer selected yet.

    Pending
  • Diverging trust signals identified

    No major trust-signal divergence found.

    Pending

Setup at a glance

Package install

Copy-ready — paste the snippet to get started.

Adoption plan

Balanced adoption plan

Current risk score 24/100. Use staged verification before broader rollout.

Risk 24

Pre-adoption checks

Validate source and review signals before any execution.

  • Confirm source provenanceRequired

    Source URL/provenance metadata is present.

    Done
  • Confirm metadata review state

    No review metadata found; increase manual validation.

    Pending
  • Verify install payload

    Install/config payload exists and can be inspected.

    Done

Security checks

Confirm safety, privacy, and package integrity signals.

  • Review safety notesRequired

    Safety notes are present.

    Done
  • Review privacy notesRequired

    Privacy notes are present.

    Done
  • Verify package integrity metadata

    No package verification/checksum metadata.

    Pending

Rollout

Adopt in controlled steps based on the selected plan.

  • Run in isolated sandbox firstRequired

    Use a constrained sandbox and observe behavior across multiple tasks.

    Pending
  • Roll out graduallyRequired

    Roll out to a small cohort before wider usage.

    Pending
  • Set monitoring and fallback

    Define rollback path and monitor errors after adoption.

    Pending

Evidence readiness

Evidence readiness matrix · balanced

Missing required evidence: Metadata review. Risk score 31.

Risk 31

Source provenance

Present

Source repository/provenance is listed.

Required in this preset

Metadata review

Missing

Review metadata is missing.

Required in this preset

Safety notes

Present

Safety notes are present.

Required in this preset

Privacy notes

Present

Privacy notes are present.

Optional in this preset

Package integrity

Missing

Package integrity metadata is missing.

Optional in this preset

Install payload

Present

Install payload is available.

Required in this preset

Required gaps: Metadata review

Decision timeline

Decision timeline · balanced

Blocking gaps: Check metadata review status. Risk 28.

Risk 28

triage

Confirm source provenanceRequired

Source/provenance metadata is available.

Done

triage

Check metadata review statusRequired

Review metadata is missing.

Pending

verify

Review safety notesRequired

Safety notes are available.

Done

verify

Review privacy notes

Privacy notes are available.

Done

verify

Validate package integrity metadata

Package integrity metadata is missing.

Pending

rollout

Verify install payload and commandsRequired

Install payload is available.

Done

Blockers: Check metadata review status

Prerequisite readiness

Prerequisite readiness

4 prerequisites to line up before setup.

0/4 ready
Configuration1Permissions & scopes1Network & hosting1General1

Safety & privacy surface

Safety & privacy surface

3 safety and 3 privacy notes across 4 risk areas. Review closely: credentials & tokens, third-party handling.

4 areas
  • SafetyCredentials & tokensThe skill is read-only guidance; it does not call OpenAI APIs, create API keys, modify accounts, or execute code by itself.
  • SafetyGeneralDo not use the skill as proof that a model, API parameter, entitlement, or product feature exists; it routes the agent to official docs so the answer can be verified.
  • SafetyThird-party handlingKeep model upgrade work narrow unless the user explicitly asks for SDK, auth, environment, or provider migration changes.
  • PrivacyGeneralDocumentation queries can reveal what product, API, model, migration, or customer workflow the user is researching.
  • PrivacyCredentials & tokensAvoid sending private prompts, customer data, secrets, internal repository names, or unreleased product plans through docs-search queries.
  • PrivacyExecution & processesSkill text, fetched docs, citations, and agent transcripts can persist in local logs or conversation history depending on the client.

Safety notes

  • The skill is read-only guidance; it does not call OpenAI APIs, create API keys, modify accounts, or execute code by itself.
  • Do not use the skill as proof that a model, API parameter, entitlement, or product feature exists; it routes the agent to official docs so the answer can be verified.
  • Keep model upgrade work narrow unless the user explicitly asks for SDK, auth, environment, or provider migration changes.

Privacy notes

  • Documentation queries can reveal what product, API, model, migration, or customer workflow the user is researching.
  • Avoid sending private prompts, customer data, secrets, internal repository names, or unreleased product plans through docs-search queries.
  • Skill text, fetched docs, citations, and agent transcripts can persist in local logs or conversation history depending on the client.

Prerequisites

  • OpenAI developer documentation MCP server configured at `https://developers.openai.com/mcp`.
  • An agent environment that supports reusable skills, project instructions, or equivalent workflow rules.
  • Permission to install or reference the `openai/skills` repository in the target agent tooling.
  • A habit of requesting citations or source URLs when the answer depends on current OpenAI product behavior.

Schema details

Install type
package
Reading time
6 min
Troubleshooting
No
Source repository stats
Scope
Source repo
Skill and platform metadata
Skill type
general
Skill level
foundational
Verification
validated
Verified at
2026-06-05
Retrieval sources
https://developers.openai.com/learn/docs-mcphttps://github.com/openai/skills/tree/main/skills/.curated/openai-docshttps://raw.githubusercontent.com/openai/skills/main/skills/.curated/openai-docs/SKILL.md
Tested platforms
CodexClaudeCursorVS CodeGeneric AGENTS
PlatformSupportInstall path
claude-codeNative.claude/skills/<skill-name>/SKILL.md
codexNative.agents/skills/<skill-name>/SKILL.md
windsurfNative.windsurf/skills/<skill-name>/SKILL.md
geminiNative.gemini/skills/<skill-name>/SKILL.md or .agents/skills/<skill-name>/SKILL.md
cursorAdapter.cursor/rules/<skill-name>.mdc
cliManualAGENTS.md or tool-specific context file
Full copyable content
Use the OpenAI Docs Skill when answering OpenAI product or API questions.
Search and fetch official OpenAI developer docs through the configured
`openaiDeveloperDocs` MCP server first, then fall back only to official
OpenAI domains when the MCP source is unavailable.

About this resource

Content

OpenAI Docs Skill is an official skill from the openai/skills repository. It helps agents answer OpenAI product and API questions from current official documentation instead of stale memory. The skill is designed to pair with OpenAI's public developer documentation MCP server at https://developers.openai.com/mcp.

Use it when a workflow needs source-backed answers about the OpenAI API, Responses API, ChatGPT Apps SDK, Codex, model selection, model migration, prompt upgrades, Realtime, Agents SDK, or adjacent OpenAI developer surfaces.

Features

  • Routes OpenAI API and product questions to official developer docs first.
  • Names the expected Docs MCP tools for search, fetch, and API reference lookup when available.
  • Separates broad Codex self-knowledge from ordinary OpenAI API documentation lookup.
  • Includes source-priority rules for model selection, model upgrades, and prompt-upgrade guidance.
  • Encourages bounded uncertainty when public docs do not establish a claim.
  • Restricts web-search fallback to official OpenAI domains.
  • Pairs directly with OpenAI's public Docs MCP server setup instructions.

Use Cases

  • Ask an agent to verify the current Responses API tool schema before changing code.
  • Answer Codex setup, customization, skill, plugin, hook, MCP, or AGENTS.md questions with a source route instead of guessing from memory.
  • Check current model-selection guidance before changing an OpenAI model default.
  • Draft an API migration plan while preserving explicitly requested target models or products.
  • Require citations for OpenAI API, Apps SDK, or Codex answers in code review and support workflows.

Installation

This listing does not package a local archive. Use the source repository and your agent's supported skill-install workflow.

  1. Configure the OpenAI developer Docs MCP server:
codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
  1. Install or reference the skill source from:
https://github.com/openai/skills/tree/main/skills/.curated/openai-docs
  1. Add a project instruction telling the agent to use the skill for OpenAI product and API questions.

Compatibility

Native

  • Codex workflows with skills and MCP enabled.
  • Agent setups that can load SKILL.md-style instructions and call the OpenAI developer Docs MCP server.

Manual Adaptation

  • Claude, Cursor, VS Code, and generic AGENTS.md workflows can adapt the routing rules as durable project instructions when their skill runtime differs.

Boundary Notes

The skill does not authenticate to OpenAI, operate accounts, create keys, or perform production API calls. It is a retrieval and source-priority rule for agents. Keep private data out of documentation searches and verify claims with official docs before changing production code.

Related Resources

Source citations

Add this badge to your README

Show that OpenAI Docs Skill is listed on HeyClaude. Paste this Markdown into your README — it renders the badge and links back to this page.

Listed on HeyClaude
[![Listed on HeyClaude](https://heyclau.de/badge/skills/openai-docs-skill.svg)](https://heyclau.de/entry/skills/openai-docs-skill)

How it compares

OpenAI Docs Skill side by side with 3 alternatives on trust, install, platform support, and disclosed safety notes — all from reviewed registry metadata.

1 trust signal differ across this comparison (Submitter).

Field

Official OpenAI skill that tells agents to use the OpenAI developer documentation MCP server first for API, Codex, Apps SDK, model-selection, and migration questions.

Open dossier

Google Agent Skills catalog for AI agents working with Google Cloud, Gemini Enterprise Agent Platform, Gemini APIs, Skill Registry, Cloud Run, BigQuery, Firebase, GKE, Cloud SQL, AlloyDB, gcloud, auth, onboarding, and Well-Architected Framework guidance.

Open dossier

Official LiveKit Agent Skills for AI coding agents building low-latency voice AI, LiveKit Agents workflows, handoffs, mandatory tests, and simulation scenario suites.

Open dossier

Agent Skill from mcp-use for turning OpenAPI or Swagger specs into MCP servers with operation-to-tool mapping, auth wiring, Zod schema generation, inspector testing, and streamable HTTP deployment.

Open dossier
Next steps
Trust
Review statusNot reviewedNot reviewedNot reviewedNot reviewed
Package trustPackage not verifiedPackage not verifiedPackage not verifiedPackage not verified
Source provenanceSource-backedSource-backedSource-backedSource-backed
SubmitterDiffersJSONbored
Install riskReview firstReview firstReview firstReview first
Notes Safety ✓ Privacy ✓ Safety ✓ Privacy ✓ Safety ✓ Privacy ✓ Safety ✓ Privacy ✓
BrandOpenAI logoOpenAIGoogle logoGoogle
Categoryskillsskillsskillsskills
SourceSource-backedSource-backedSource-backedSource-backed
AuthorOpenAIGoogleLiveKitmcp-use
Added2026-06-052026-06-182026-06-182026-06-18
Platforms
Harness
Source repo
Safety notesThe skill is read-only guidance; it does not call OpenAI APIs, create API keys, modify accounts, or execute code by itself. Do not use the skill as proof that a model, API parameter, entitlement, or product feature exists; it routes the agent to official docs so the answer can be verified. Keep model upgrade work narrow unless the user explicitly asks for SDK, auth, environment, or provider migration changes.Google Cloud skills can create, update, delete, deploy, query, or configure cloud resources, datasets, IAM policies, service accounts, APIs, containers, jobs, and networking. The gcloud skill requires command validation and safety guardrails before invoking Google Cloud CLI commands; do not let agents improvise cloud commands from memory. Skill Registry guidance includes skill lifecycle management such as upload, update, and permanent delete operations; validate environment and approval before use. Cloud Run, GKE, BigQuery, Firebase, Cloud SQL, AlloyDB, and Gemini API workflows can create cost, expose endpoints, alter data, or change production behavior. The repository notes active development, so verify exact commands, product names, API availability, and launch-stage limits before production use.The livekit-agents skill intentionally pushes agents toward implementation work for voice AI systems that can join realtime rooms, call tools, speak to users, and route calls; generated code still needs human review. The skill requires tests for agent behavior, but tests do not prove latency, safety, consent, telephony legality, privacy, or production readiness by themselves. The livekit-simulations skill includes private-beta caveats for simulation commands and requires current CLI help or docs verification before running `lk agent simulate`. Do not let a coding agent invent LiveKit API signatures from memory; the skill repeatedly requires MCP/docs verification because the SDK changes quickly. Voice agent handoffs, tasks, tool calls, and simulation scenarios can influence real user conversations if deployed; validate in staging rooms before production.Generated MCP tools can expose every selected REST operation from a source API, including destructive or account-changing endpoints if the operation filter is too broad. Large OpenAPI specs can create noisy tool surfaces. Filter by tag or operation list when the API has many endpoints. Auth wiring may include API keys, bearer tokens, basic auth, OAuth bearer tokens, and environment variables; never put secret values in the spec, generated source, prompts, or PR text. The skill recommends streamable HTTP for generated mcp-use servers; review deployment auth, CORS, rate limits, logs, and public reachability before publishing. Human review is needed for generated schemas, tool descriptions, error handling, and write operations before giving an agent access to real accounts.
Privacy notesDocumentation queries can reveal what product, API, model, migration, or customer workflow the user is researching. Avoid sending private prompts, customer data, secrets, internal repository names, or unreleased product plans through docs-search queries. Skill text, fetched docs, citations, and agent transcripts can persist in local logs or conversation history depending on the client.Google Cloud workflows may expose project IDs, service account emails, OAuth tokens, API keys, ADC credentials, Terraform state, dataset names, table schemas, query text, logs, traces, prompts, model outputs, embeddings, and customer data. BigQuery, Firebase, Cloud SQL, AlloyDB, GKE, and Agent Platform workflows may process regulated or proprietary data; review data residency, IAM, retention, audit logging, and sharing rules before use. Gemini API and Agent Platform skills can send prompts, files, images, audio, video, tool inputs, structured outputs, cached contexts, and batch datasets to Google services. Keep credentials, project IDs when sensitive, private queries, logs, trace payloads, Terraform state, customer data, and generated datasets out of public prompts, issues, PRs, and screenshots.LiveKit voice agent work can involve audio, video, transcripts, room metadata, participant identities, phone call details, test personas, tool inputs, tool outputs, and logs. The skills are prompt/instruction assets, but the implementations they guide may send data to LiveKit, STT providers, LLM providers, TTS providers, MCP servers, telephony providers, and observability backends. Keep LIVEKIT_API_SECRET, provider keys, SIP credentials, room tokens, recordings, transcripts, and generated scenario files containing sensitive business logic out of prompts, public issues, screenshots, and committed configs. The simulations skill says scenario generation reads the user's local agent code and should not upload that code; preserve that local-only boundary when using it.OpenAPI specs can expose private endpoint names, internal domains, auth schemes, schemas, object fields, customer concepts, and operational workflows. Tool calls can send prompts, arguments, request bodies, auth-scoped API responses, error payloads, and logs through the MCP server, model provider, and deployment platform. Keep API keys, tokens, OAuth secrets, cookies, private base URLs, customer data, and internal spec comments out of public examples, repository files, issue comments, and screenshots. For third-party or customer APIs, confirm data retention and logging behavior across the MCP client, mcp-use deployment target, model provider, and API provider.
Prerequisites
  • OpenAI developer documentation MCP server configured at `https://developers.openai.com/mcp`.
  • An agent environment that supports reusable skills, project instructions, or equivalent workflow rules.
  • Permission to install or reference the `openai/skills` repository in the target agent tooling.
  • A habit of requesting citations or source URLs when the answer depends on current OpenAI product behavior.
  • AI coding assistant or skill host compatible with the Agent Skills standard and the skills CLI.
  • Google Cloud project, credentials, billing, enabled APIs, IAM roles, and target region when a selected skill touches cloud resources.
  • Current gcloud, bq, kubectl, Terraform, SDK, or product-specific tooling required by the selected Google Cloud workflow.
  • Clear approval boundary before any agent runs cloud deployment, IAM, data, billing, registry, or destructive operations.
  • AI coding agent or skill installer compatible with Agent Skill-style repositories.
  • LiveKit Agents project or planned voice AI implementation.
  • LiveKit Cloud project credentials when using the recommended LiveKit Cloud path.
  • LiveKit Docs MCP server or current docs access for API signatures, CLI commands, model support, deployment, and configuration facts.
  • An OpenAPI 3.x or Swagger 2.0 spec from a local file, URL, or pasted source.
  • Node.js and npm or pnpm for `create-mcp-use-app`, TypeScript, swagger-parser, Zod, and mcp-use tooling.
  • An MCP client or coding agent that can install and use Agent Skills from GitHub.
  • Known target API base URL, authentication scheme, operation filter, and deployment intent before broad tool generation.
Install
codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
npx skills add google/skills
npx skills add livekit/agent-skills
npx skills add https://github.com/mcp-use/mcp-use --skill openapi-to-mcp
Config
Citations
ClaimUnclaimedUnclaimedUnclaimedUnclaimed
Open 4 picks in the interactive comparison tool

Related guides

Signals

Loading live community signals…

More like this, weekly

A short, calm digest of reviewed Claude resources. Unsubscribe any time.