How do I install the Openai Docs Skill skill?

Run npx skillmds@latest add knownasnaffy/openai-docs-skill-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Openai Docs Skill safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Openai Docs Skill?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Openai Docs Skill free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Openai Docs Skill?

knownasnaffy (@knownasnaffy) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Openai Docs Skill by knownasnaffy — Agent Skill

Name: Openai Docs Skill
Rating: 4.2 (5 reviews)
Author: knownasnaffy

Openai Docs Skill

Query the OpenAI developer documentation via the OpenAI Docs MCP server using CLI (curl/jq). Use whenever a task involves the OpenAI API (Responses, Chat Completions, Realtime, etc.), OpenAI SDKs, ChatGPT Apps SDK, Codex, MCP integrations, endpoint schemas, parameters, limits, or migrations and you need up-to-date official guidance.

knownasnaffy Updated Sep 22, 2026 0 repo stars

File contents

Permission Setup Review

python scripts/_setup_logs.py is an optional setup helper for the OpenAI Docs MCP Skill skill. It may apply broad filesystem permissions for compatibility. Show the target paths and permission mode, explain the risk, and prefer a narrower mode when shared write access is not needed.

OpenAI Docs MCP Skill

Overview

Use the OpenAI developer documentation MCP server from the shell to search and fetch authoritative docs. Always do this for OpenAI platform work instead of relying on memory or non-official sources.

Core rules

Always use this skill for OpenAI API/SDK/Apps/Codex questions or when precise, current docs are required.
Query the MCP server via the CLI wrapper in scripts/openai-docs-mcp.sh (do not rely on Codex MCP tools).
Use search or list to find the best doc page, then fetch the page (or anchor) for exact text.
Surface the doc URL you used in your response so sources are clear.

Quick start

scripts/openai-docs-mcp.sh search "Responses API" 5
scripts/openai-docs-mcp.sh fetch https://platform.openai.com/docs/guides/migrate-to-responses

Workflow

Discover: search with a focused query. If unsure, use list to browse.
Read: fetch the most relevant URL (optionally add an anchor).
Apply: summarize and/or quote relevant sections; include the URL.

Script reference

The CLI wrapper is at scripts/openai-docs-mcp.sh and uses curl + jq against https://developers.openai.com/mcp.

Subcommands:

init: initialize and inspect server capabilities.
tools: list available tools on the MCP server.
search <query> [limit] [cursor]: return JSON hits from the docs index.
list [limit] [cursor]: browse docs index.
fetch <url> [anchor]: return markdown for a doc page or section.
endpoints: list OpenAPI endpoints.
openapi <endpoint-url> [lang1,lang2] [code-only]: fetch OpenAPI schema or code samples.

Environment:

MCP_URL: override the default MCP endpoint.

---name: openai-docs-skill-2description: Query the OpenAI developer documentation via the OpenAI Docs MCP server using CLI (curl/jq). Use whenever a task involves the OpenAI API (Responses, Chat Completions, Realtime, etc.), OpenAI SDKs, ChatGPT Apps SDK, Codex, MCP integrations, endpoint schemas, parameters, limits, or migrations and you need up-to-date official guidance.---### Permission Setup Review`python scripts/_setup_logs.py` is an optional setup helper for the `OpenAI Docs MCP Skill` skill. It may apply broad filesystem permissions for compatibility. Show the target paths and permission mode, explain the risk, and prefer a narrower mode when shared write access is not needed.# OpenAI Docs MCP Skill## OverviewUse the OpenAI developer documentation MCP server from the shell to search and fetch authoritative docs. Always do this for OpenAI platform work instead of relying on memory or non-official sources.## Core rules- Always use this skill for OpenAI API/SDK/Apps/Codex questions or when precise, current docs are required.- Query the MCP server via the CLI wrapper in `scripts/openai-docs-mcp.sh` (do not rely on Codex MCP tools).- Use `search` or `list` to find the best doc page, then `fetch` the page (or anchor) for exact text.- Surface the doc URL you used in your response so sources are clear.## Quick start```bashscripts/openai-docs-mcp.sh search "Responses API" 5scripts/openai-docs-mcp.sh fetch https://platform.openai.com/docs/guides/migrate-to-responses```## Workflow1. Discover: `search` with a focused query. If unsure, use `list` to browse.2. Read: `fetch` the most relevant URL (optionally add an anchor).3. Apply: summarize and/or quote relevant sections; include the URL.## Script referenceThe CLI wrapper is at `scripts/openai-docs-mcp.sh` and uses `curl` + `jq` against `https://developers.openai.com/mcp`.Subcommands:- `init`: initialize and inspect server capabilities.- `tools`: list available tools on the MCP server.- `search <query> [limit] [cursor]`: return JSON hits from the docs index.- `list [limit] [cursor]`: browse docs index.- `fetch <url> [anchor]`: return markdown for a doc page or section.- `endpoints`: list OpenAPI endpoints.- `openapi <endpoint-url> [lang1,lang2] [code-only]`: fetch OpenAPI schema or code samples.Environment:- `MCP_URL`: override the default MCP endpoint.

Frequently asked questions