SkillsAdd

am-will/codex-skills

openai-docs-skill

Query the OpenAI developer documentation via the OpenAI Docs MCP server using CLI (curl/jq).

All-time #8847 First seen Jan 23, 2026
8-week activity · all time api

Installation

$ npx skills add am-will/codex-skills --skill openai-docs-skill
View on skills.sh ↗ GitHub repository ↗

Summary

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

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

azure-rbac Shared topics
microsoft/azure-skills 489K installs
openai-docs Similar name
openai/skills

Use when the user asks how to build with OpenAI products or APIs, asks about Codex itself or ch…

4.3K installs
extension-openai Similar name
caffeinelabs/skills

>- MANDATORY recipe for every Caffeine build that calls OpenAI (ChatGPT, GPT-4o, an LLM, a chat…

18.5K installs
openai-whisper Similar name
openclaw/openclaw

Local speech-to-text with the Whisper CLI (no API key).

4.7K installs
openai-whisper-api Similar name
openclaw/openclaw

OpenAI Audio Transcriptions API via curl; gpt-4o-transcribe, mini, diarize, or whisper-1.

3.3K installs
openai-agents-sdk Similar name
laguagu/claude-code-nextjs-skills

OpenAI Agents SDK (Python) development. Use when building AI agents, multi-agent handoffs, func…

1.7K installs

Also in this package

Other skills from am-will/codex-skills · top by installs.

npx skills add am-will/codex-skills
frontend-design 1.4K frontend responsive design standards 1.2K context7 1.2K role-creator 1.2K vercel-react-best-practices 1.2K swarm-planner 1.2K gemini-computer-use 1.2K Agent Browser 1.2K plan-harder 1.2K llm-council 1.2K

Browse all from am-will/codex-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 1.0K
Default branch main
Open issues 3
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,068 B
  • docs SUMMARY.md 1,535 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 1,200 installs

SKILL.md

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

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