openai-api-troubleshooting — скилл для Codex: что делает и установка
Классифицирует сбои при вызовах OpenAI API в Codex и подсказывает точное действие для исправления. Пригодится, когда запрос падает с сетевой ошибкой, 401, 403 или исчерпанным балансом.
npx skills add openai/plugins --skill openai-api-troubleshooting -a codexЧто делает openai-api-troubleshooting
Скилл помогает агенту разобрать причины падения уже отправленного запроса к OpenAI API. Он делит проблемы на пять групп: сетевые блокировки, неверные ключи, исчерпание баланса, лимиты запросов и ошибки доступа к модели. Сетевые ошибки проверяются первыми. Если запуск в песочнице обрывается по таймауту или DNS, запрос повторяется с параметром sandbox_permissions=require_escalated.
Внутри заложены четкие правила маршрутизации. Ошибки с кодом 429 скилл строго разделяет на превышение частоты запросов и нехватку денег на счете. При исчерпании квоты агент отправляет в биллинг организации и предлагает проверить тестовую модель gpt-5.4-mini. Сам скилл ключи не генерирует: настройка ключей уходит в openai-platform-api-key, а поиск свежих параметров — в openai-docs.
Ответы формулируются коротко, без лишних технических пересказов. Ставить этот скилл нужно разработчикам, которые часто тестируют скрипты в Codex и не хотят вручную выяснять, почему упал API.
Какие задачи решает
- определить причину сбоя запроса к OpenAI API
- отличить исчерпание баланса insufficient_quota от превышения лимитов rate_limit_exceeded
- перезапустить упавший в песочнице сетевой запрос с повышенными правами
- выявить ошибки доступа к конкретной модели или проекту
Примеры запросов агенту
- Запрос к OpenAI API упал с кодом 429, разберись, это лимит частоты или кончились деньги на балансе
- Скрипт не может достучаться до api.openai.com из песочницы, проверь ошибку сети
- Получаю 403 model_not_found при вызове модели, что нужно исправить в правах?
Как установить openai-api-troubleshooting
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill openai-api-troubleshooting -a codex2Вручную: положить файлы
.agents/skills/openai-api-troubleshooting/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill openai-api-troubleshooting -a claude-code2Вручную: положить файлы
~/.claude/skills/openai-api-troubleshooting/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/openai-api-troubleshooting/
Вручную: положить файлы
.cursor/skills/openai-api-troubleshooting/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install openai/plugins openai-api-troubleshooting2Вручную: положить файлы
.github/skills/openai-api-troubleshooting/SKILL.mdКомандой платформы
gemini skills install https://github.com/openai/plugins --path plugins/openai-developers/skills/openai-api-troubleshootingВручную: положить файлы
.devin/skills/openai-api-troubleshooting/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Из того же набора201
Весь набор →Похожие
Вопросы о openai-api-troubleshooting
Как установить openai-api-troubleshooting в Codex?
Выполните в терминале команду npx skills add openai/plugins --skill openai-api-troubleshooting.
Что делает скилл openai-api-troubleshooting?
Он классифицирует ошибки вызовов OpenAI API, разделяя сбои сети в песочнице, неверные ключи, нулевой баланс, лимиты частоты и отсутствие доступа к моделям.
Может ли этот скилл сам выпустить новый API-ключ?
Нет, генерация и замена ключей вынесены в отдельный скилл openai-platform-api-key.