openai-docs-skill — скилл для Codex: документация OpenAI из CLI
Тянет актуальную документацию OpenAI для разработчиков через MCP-сервер из шелла. Пригодится, когда агент пишет код под Responses API, SDK или MCP и не должен додумывать параметры по памяти.
npx skills add am-will/codex-skills --skill openai-docs-skill -a claude-codeЧто делает openai-docs-skill
Скилл заставляет агента идти в официальную документацию OpenAI, а не полагаться на память или сторонние статьи. Работает через обёртку scripts/openai-docs-mcp.sh, которая дёргает https://developers.openai.com/mcp обычными curl и jq. Сами MCP-инструменты Codex при этом не используются — запросы идут из шелла.
Сценарий простой: сначала search по теме или list для просмотра индекса, потом fetch найденной страницы, при необходимости с якорем на конкретный раздел. Есть ещё endpoints и openapi — они отдают список эндпоинтов и схему OpenAPI с примерами кода. Ответ агент должен подкреплять ссылкой на использованную страницу.
Без curl и jq в системе обёртка не отработает, а адрес MCP-сервера можно переопределить переменной MCP_URL. Это скилл, а не MCP-сервер: он сам ходит в чужой сервер по HTTP.
Какие задачи решает
- уточнить схему эндпоинта Responses API перед написанием кода
- найти страницу про миграцию на Responses вместо Chat Completions
- свериться с лимитами и параметрами через официальный индекс docs
- получить OpenAPI-схему эндпоинта и примеры кода на нужном языке
- проверить поведение SDK или Apps SDK до того, как агент что-то придумает
Примеры запросов агенту
- Найди в документации OpenAI раздел про Realtime API и покажи, какие параметры сессии обязательные.
- Сверь схему эндпоинта через openapi и приведи пример запроса на Python.
- Проверь по официальным докам, как мигрировать с Chat Completions на Responses, и дай ссылку на страницу.
Как установить openai-docs-skill
1Через Skills CLI (Vercel)
npx skills add am-will/codex-skills --skill openai-docs-skill -a claude-code2Вручную: положить файлы
~/.claude/skills/openai-docs-skill/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/openai-docs-skill/
1Через Skills CLI (Vercel)
npx skills add am-will/codex-skills --skill openai-docs-skill -a codex2Вручную: положить файлы
.agents/skills/openai-docs-skill/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add am-will/codex-skills --skill openai-docs-skill -a cursor2Вручную: положить файлы
.cursor/skills/openai-docs-skill/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install am-will/codex-skills openai-docs-skill2Вручную: положить файлы
.github/skills/openai-docs-skill/SKILL.md1Через Skills CLI (Vercel)
npx skills add am-will/codex-skills --skill openai-docs-skill -a gemini-cli2Командой платформы
gemini skills install https://github.com/am-will/codex-skills --path skills/openai-docs-skillВручную: положить файлы
.devin/skills/openai-docs-skill/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add am-will/codex-skills --skill openai-docs-skill -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о openai-docs-skill
Как установить openai-docs-skill в Claude Code?
Выполните npx skills add am-will/codex-skills --skill openai-docs-skill -a claude-code. Скилл окажется в ~/.claude/skills/openai-docs-skill/SKILL.md.
Что делает openai-docs-skill?
Заставляет агента искать и читать документацию OpenAI для разработчиков через MCP-сервер из командной строки и ссылаться на источник в ответе. Покрывает API, SDK, ChatGPT Apps SDK, Codex и MCP-интеграции.
Что нужно, чтобы скилл заработал?
curl и jq в системе: обёртка scripts/openai-docs-mcp.sh построена на них. Адрес MCP-сервера задан по умолчанию, его можно заменить переменной MCP_URL.
