Skip to main content
affpapa.org
RU EN
skill CX Codex GP ChatGPT official · OpenAI

openai-api-troubleshooting — Codex skill: what it does and install

Diagnoses failed OpenAI API requests in Codex and pinpoints the immediate next action. Covers network blocks, invalid keys, depleted quota, rate limits, and model access issues.

Install into Codex · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add openai/plugins --skill openai-api-troubleshooting -a codex
Open on GitHub

What openai-api-troubleshooting does

This skill handles runtime failures that occur after sending a request to the OpenAI API. It routes problems into five clear groups: sandboxed network blockers, authentication errors, credit depletion, rate limits, and access restrictions. Transport failures come first. When a sandboxed run hits DNS errors or connection resets, the skill tests the network route by retrying the call with sandbox_permissions=require_escalated.

The routing logic separates tricky edge cases. Both rate limits and an empty balance can produce HTTP 429, but the skill treats them differently. For rate_limit_exceeded, it suggests pacing or exponential backoff. For insufficient_quota, it directs you to organization billing and points to gpt-5.4-mini as an initial testing option. It leaves key provisioning to openai-platform-api-key and documentation lookups to openai-docs.

Explanations stay brief and actionable. Install this skill if you run automated tasks through Codex and want immediate clarity on API failures without digging through logs.

What it helps with

  • diagnose runtime failures from OpenAI API requests
  • distinguish insufficient_quota billing stops from rate_limit_exceeded pauses
  • rerun sandboxed calls that hit DNS or connection timeouts with escalated permissions
  • identify 403 model or organization access permissions

Example prompts for the agent

  • My OpenAI API call failed with a 429 error, check if this is a rate limit or a billing issue
  • The script cannot reach api.openai.com from the sandbox, help me fix the connection
  • I received a 403 model_not_found error, tell me what permissions or project settings are missing

How to install openai-api-troubleshooting

1Skills CLI (Vercel)

npx skills add openai/plugins --skill openai-api-troubleshooting -a codex

2Manually: put the files in place

.agents/skills/openai-api-troubleshooting/SKILL.md

For all projects use ~/.agents/skills/

From the same set201

The whole set →
supabase official supabase Guides the agent through database configuration and strict RLS policies in Supabase. CX Codex GP ChatGPT 8installs remotion-render official Remotion Exports videos and static stills from Remotion projects using CLI commands. CX Codex GP ChatGPT 3installs figma-create-new-file official Figma Creates blank Figma, FigJam, or Slides files inside draft folders. It resolves planKey and editor types before invoking Figma MCP tools. CX Codex GP ChatGPT 6installs swiftui-performance-audit official OpenAI Pinpoints SwiftUI runtime issues like frame drops, unresponsive taps, and excessive view body computations. Works code-first and guides Instruments profiling. CX Codex GP ChatGPT 109installs swiftui-liquid-glass official OpenAI This skill helps build and review SwiftUI Liquid Glass interfaces for iOS 26+. Use it when adopting the API or checking fallbacks, interaction, and design fit. CX Codex GP ChatGPT 121installs swiftui-ui-patterns official OpenAI This skill helps build and refactor SwiftUI interfaces, from navigation and state to layouts and controls. Use it for new screens or changes to an existing project. CX Codex GP ChatGPT 114installs swiftui-view-refactor official OpenAI Refactors SwiftUI view files into clean, testable structures with dedicated subview types and proper Observation ownership. CX Codex GP ChatGPT 113installs ios-memgraph-leaks official OpenAI Captures and inspects iOS leaks from a simulator process or .memgraph. Useful for tracing retained objects and checking a fix with before-and-after evidence. CX Codex GP ChatGPT 1,054installs

Similar

java-development official github Guides plain Java development without frameworks, matching idioms to the target JDK release and running checks via Maven or Gradle. GitHub Copilot 3installs mcp-builder official anthropics This skill walks through building an MCP server in TypeScript or Python, from reading the protocol spec to writing tests and evaluation questions. Claude Code Claude.ai 130,949installs google-agents-cli-adk-code official Google A reference skill for building ADK agents with tools, callbacks, state, and workflows. Use it when an agent project needs concrete API patterns or code examples. Claude Code CX Codex Cursor +1 511,400installs lark-im larksuite This skill lets an agent work with Lark IM messages, chats, files, and interactive cards. Use it when coding tasks need access to team conversations. Claude Code CX Codex Cursor +1 472,300installs lark-event larksuite Listens to Lark/Feishu events and streams them as NDJSON. Use it for bots, message processing, and long-running subscribers. Claude Code CX Codex Cursor +1 466,200installs caveman-discover JuliusBrussee Finds and labels every LLM workflow in your repository so Caveman Cloud breaks down spend by actual job rather than grouping everything into one bucket. Claude Code CX Codex Cursor +1 103,500installs migration JuliusBrussee Enforces reversible, compatibility-safe transitions for schema, data, and API updates. Useful whenever data loss or rollout downtime is unacceptable. Claude Code CX Codex Cursor +1 102,900installs

Questions about openai-api-troubleshooting

How do I install openai-api-troubleshooting in Codex?

Run npx skills add openai/plugins --skill openai-api-troubleshooting in your terminal.

What does openai-api-troubleshooting do?

It categorizes failed OpenAI API calls into network issues, authentication errors, quota exhaustion, rate limits, or project permission mismatches.

Does this skill create or rotate API keys?

No, creating and configuring API keys is delegated to the openai-platform-api-key skill.

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor