skilld
All skills
openai avatar

/openai-docs

@12fe9f8
by openaiopenai/codex127k stars
19,934

Use for Codex models/pricing, scheduled tasks, skills, settings, setup, troubleshooting, customization, automations, and self-knowledge—including 'you,' 'your,' 'this app,' or 'this coding agent' when they refer to Codex—and for OpenAI APIs/products and ChatGPT Work. Also use for model choice/migration, prompting, SDKs, Responses, Realtime, agents, evals, and Chat/Work/Codex comparisons. Do not use for generic app/software tasks that merely mention Codex.

Ask your Agent

Use this Skill: https://skilld.dev/gh/openai/codex/openai-docs

This session only. Nothing lands on disk.

referencesmcp-diagnostics.md

≈580 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Local documentation MCP setup and diagnostics

Use this route only when the user explicitly asks to configure or troubleshoot the official OpenAI documentation MCP server in a supported local Codex client. A missing documentation tool during an ordinary documentation request is not a setup request: answer with the root skill's official-domain web fallback without installation, sandbox escalation, configuration changes, or restart.

Verify the supported local setup

  1. Search and fetch current official Codex MCP setup documentation when those tools are callable. Otherwise, search and fetch the relevant official OpenAI documentation directly.

  2. Confirm the documented endpoint is https://developers.openai.com/mcp and verify the supported command or configuration against that current documentation before recommending it.

  3. When the current documentation supports it, the local Codex CLI setup is:

    codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp

    The equivalent documented configuration is:

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

  4. Check the supported local client's MCP listing or configuration, its enabled state, relevant workspace/admin policy, and any documented authentication requirement. Verify success from the actual command result, configuration, or a callable documentation-tool search/fetch; never claim installation or access without evidence.

  5. Recommend a local-client restart or new local session only when current official documentation or observed client behavior requires it. Clearly identify which local client must refresh.

A skill dependency declaration, configured server, or local-client setup does not make a tool callable in an already running session. In particular, editing a hosted container's local configuration cannot install a tool into the host or model's current tool inventory. Never claim a local command installed the server into a current hosted session.

Only perform a local installation or configuration change when the user explicitly authorizes that change. Never request sandbox escalation, edit hosted configuration, install a dependency, or ask the user to restart a hosted session merely to answer an ordinary documentation question.

Source: SKILL.md on GitHub

Third-party checks

1 warning19d3 checks · Risk SAFE
  • Gen Agent Trust Hub19d

    This skill is designed to provide official OpenAI documentation and guidance. It includes some security considerations, such as prompt templates that instruct models to suppress safety warnings to increase autonomy, and scripts that fetch documentation from official remote sources.

  • Socket19d

    No alerts

  • Snyk19d

    Risk: MEDIUM · 1 issue

Provenance

Signed by skilld at 12fe9f8. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 8 hours ago.

Activeupdated 4 weeks ago

Capability

Other metadata
metadata
{
  "short-description": "Codex models/pricing, scheduled tasks, skills, settings, setup, troubleshooting, and self-knowledge; OpenAI APIs and ChatGPT Work. 'You'/'this app' means Codex only."
}

README badge

README badge for openai/codex/openai-docs