0xharryriddle/openai-docs-skill
archive/upstream/examples/codex-skills/skills/openai-docs-skill/SKILL.md
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 --global
skillsauthnpx skillsauth add 0xharryriddle/codex-field-kit openai-docs-skillInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Error
VirusTotalMulti-engine malware detection
70%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Mar 24, 2026, 9:53 AM41.8s2 files scanned
SKILL.md
- name:
- openai-docs-skill
- description:
- 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.
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.
Related Skills
0xharryriddle/vercel-react-best-practices
development
VerifiedTrustedCommunity
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.
2SKILL.mdUpdated Mar 24, 2026
0xharryriddle/swarm-planner
testing
VerifiedTrustedCommunity
[EXPLICIT INVOCATION ONLY] Creates dependency-aware implementation plans optimized for parallel multi-agent execution.
2SKILL.mdUpdated Mar 24, 2026
0xharryriddle/super-swarm-spark
testing
VerifiedTrustedCommunity
Only to be triggered by explicit super-swarm-spark commands.
2SKILL.mdUpdated Mar 24, 2026
0xharryriddle/role-creator
development
VerifiedTrustedCommunity
Create and install Codex custom agent roles in ~/.codex/config.toml, generate role config files, enforce supported keys, and guide users through required role inputs (model, reasoning effort, developer_instructions).
2SKILL.mdUpdated Mar 24, 2026