openai/openai-knowledge
.agents/skills/openai-knowledge/SKILL.md
Use when working with the OpenAI API (Responses API) or OpenAI platform features (tools, streaming, Realtime API, auth, models, rate limits, MCP) and you need authoritative, up-to-date documentation (schemas, examples, limits, edge cases). Prefer the OpenAI Developer Documentation MCP server tools when available; otherwise guide the user to enable `openaiDeveloperDocs`.
$ install --global
skillsauthnpx skillsauth add openai/openai-agents-python openai-knowledgeInstall 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%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 10, 2026, 8:42 AM6.9s2 files scanned
SKILL.md
- name:
- openai-knowledge
- description:
- Use when working with the OpenAI API (Responses API) or OpenAI platform features (tools, streaming, Realtime API, auth, models, rate limits, MCP) and you need authoritative, up-to-date documentation (schemas, examples, limits, edge cases). Prefer the OpenAI Developer Documentation MCP server tools when available; otherwise guide the user to enable `openaiDeveloperDocs`.
OpenAI Knowledge
Overview
Use the OpenAI Developer Documentation MCP server to search and fetch exact docs (markdown), then base your answer on that text instead of guessing.
Workflow
1) Check whether the Docs MCP server is available
If the mcp__openaiDeveloperDocs__* tools are available, use them.
If you are unsure, run codex mcp list and check for openaiDeveloperDocs.
2) Use MCP tools to pull exact docs
- Search first, then fetch the specific page or pages.
mcp__openaiDeveloperDocs__search_openai_docs→ pick the best URL.mcp__openaiDeveloperDocs__fetch_openai_doc→ retrieve the exact markdown (optionally with ananchor).
- When you need endpoint schemas or parameters, use:
mcp__openaiDeveloperDocs__get_openapi_specmcp__openaiDeveloperDocs__list_api_endpoints
Base your answer on the fetched text and quote or paraphrase it precisely. Do not invent flags, field names, defaults, or limits.
3) If MCP is not configured, guide setup (do not change config unless asked)
Provide one of these setup options, then ask the user to restart the Codex session so the tools load:
- CLI:
codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
- Config file (
~/.codex/config.toml):- Add:
[mcp_servers.openaiDeveloperDocs] url = "https://developers.openai.com/mcp"
- Add:
Also point to: https://developers.openai.com/resources/docs-mcp#quickstart
Related Skills
openai/playwright
testing
VerifiedTrustedCommunity
Use when the task requires capturing or automating a real browser from the terminal.
21,873SKILL.mdUpdated Apr 18, 2026
openai/prior-auth-packet-builder
development
VerifiedTrustedCommunity
Build a concise prior authorization packet from local case files and payer policy docs.
21,443SKILL.mdUpdated Apr 17, 2026
openai/credit-note-fixer
development
VerifiedTrustedCommunity
Fix the tiny credit-note formatting bug and rerun the exact targeted test command.
20,863SKILL.mdUpdated Apr 16, 2026
openai/csv-workbench
testing
VerifiedTrustedCommunity
Analyze CSV files in /mnt/data and return concise numeric summaries.
20,679SKILL.mdUpdated Apr 10, 2026