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.
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.
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.
.gemini/skills/<skill-name>/SKILL.md or .agents/skills/<skill-name>/SKILL.md
cursor
Adapter
.cursor/rules/<skill-name>.mdc
cli
Manual
AGENTS.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.
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.
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.
[](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).
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.
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.
Official LiveKit Agent Skills for AI coding agents building low-latency voice AI, LiveKit Agents workflows, handoffs, mandatory tests, and simulation scenario suites.
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.
✓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.
✓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 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.
✓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.