Agent skill
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.
Install this agent skill to your Project
npx add-skill https://github.com/am-will/codex-skills/tree/main/skills/openai-docs-skill
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
searchorlistto find the best doc page, thenfetchthe 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:
searchwith a focused query. If unsure, uselistto browse. - Read:
fetchthe 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.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
am-will/codex-skills
markdown-url
Route any website you need to visit through markdown.new by prefixing the URL. **WHEN TO USE:** - You would normally open a website link to read content (docs, blog posts, changelogs, GitHub issues, etc.) - You need a cleaner, Markdown-friendly view for copying notes or summarizing
am-will/codex-skills
Frontend Responsive Design Standards
Build responsive, mobile-first layouts using fluid containers, flexible units, media queries, and touch-friendly design that works across all screen sizes. Use this skill when creating or modifying UI layouts, responsive grids, breakpoint styles, mobile navigation, or any interface that needs to adapt to different screen sizes. Apply when working with responsive CSS, media queries, viewport settings, flexbox/grid layouts, mobile-first styling, breakpoint definitions (mobile, tablet, desktop), touch target sizing, relative units (rem, em, %), image optimization for different screens, or testing layouts across multiple devices. Use for any task involving multi-device support, responsive design patterns, or adaptive layouts.
am-will/codex-skills
super-swarm-spark
Only to be triggered by explicit super-swarm-spark commands.
am-will/codex-skills
pluginstaller
Add a Codex plugin from a GitHub repo to a repo or personal marketplace using the current Codex plugin layout and marketplace metadata.
am-will/codex-skills
vercel-react-best-practices
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.
am-will/codex-skills
plan-harder
Use when user specfically says 'plan harder'.
Didn't find tool you were looking for?