openai-docs-skill — Codex skill: OpenAI docs from the shell
Pulls current OpenAI developer documentation through an MCP server without leaving the terminal. Handy when the agent writes Responses API or SDK code and guessing parameters is not an option.
npx skills add am-will/codex-skills --skill openai-docs-skill -a claude-codeWhat openai-docs-skill does
The skill points the agent at official OpenAI docs instead of letting it work from memory or random blog posts. A shell wrapper at scripts/openai-docs-mcp.sh talks to https://developers.openai.com/mcp using curl and jq. Codex MCP tools are skipped on purpose; every call comes from the command line.
The loop is short. Run search with a narrow query, or list to skim the index, then fetch the page you picked, optionally with an anchor for one section. Two more subcommands cover API work: endpoints lists OpenAPI endpoints, openapi returns a schema or code samples for one of them. The agent is told to show the doc URL it relied on.
curl and jq have to be installed, otherwise the wrapper has nothing to run. The endpoint is configurable through MCP_URL if you need a different host. Note the distinction: this is a skill that queries a remote MCP server over HTTP, not a server you register yourself.
What it helps with
- confirm an endpoint schema before the agent writes the request
- locate the migration guide from Chat Completions to Responses
- check parameter and limit details in the official docs index
- grab an OpenAPI schema plus code samples for one endpoint
- verify SDK or Apps SDK behaviour instead of trusting recall
Example prompts for the agent
- Search the OpenAI docs for the Realtime API and list the required session parameters.
- Fetch the OpenAPI schema for this endpoint and show a Python request example.
- Check the official guide on moving from Chat Completions to Responses and cite the page.
How to install openai-docs-skill
1Skills CLI (Vercel)
npx skills add am-will/codex-skills --skill openai-docs-skill -a claude-code2Manually: put the files in place
~/.claude/skills/openai-docs-skill/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/openai-docs-skill/
1Skills CLI (Vercel)
npx skills add am-will/codex-skills --skill openai-docs-skill -a codex2Manually: put the files in place
.agents/skills/openai-docs-skill/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add am-will/codex-skills --skill openai-docs-skill -a cursor2Manually: put the files in place
.cursor/skills/openai-docs-skill/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install am-will/codex-skills openai-docs-skill2Manually: put the files in place
.github/skills/openai-docs-skill/SKILL.md1Skills CLI (Vercel)
npx skills add am-will/codex-skills --skill openai-docs-skill -a gemini-cli2Platform CLI
gemini skills install https://github.com/am-will/codex-skills --path skills/openai-docs-skillManually: put the files in place
.devin/skills/openai-docs-skill/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add am-will/codex-skills --skill openai-docs-skill -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about openai-docs-skill
How do I install Anthropic-docs-skill in Claude Code?
Run npx skills add am-will/codex-skills --skill openai-docs-skill -a claude-code. The skill lands at ~/.claude/skills/openai-docs-skill/SKILL.md.
What does openai-docs-skill do?
It makes the agent search and read OpenAI developer documentation through an MCP server from the shell, then cite the page it used. The scope covers the API, SDKs, ChatGPT Apps SDK, Codex and MCP integrations.
What does the skill need to run?
curl and jq, since the wrapper script is built on both. The MCP endpoint has a default and can be overridden with the MCP_URL variable.