Openai API Troubleshooting — Agent Skill by OpenAI

From the author

Use when an OpenAI API request fails and Codex needs to classify the likely cause, explain the next step, and route to the right follow-up. Covers common runtime failures such as blocked outbound network access, invalid credentials, exhausted API quota or credits, rate limits, and model, project, or organization access issues; delegate key provisioning to openai-platform-api-key and current documentation lookups to openai-docs.

— the description by OpenAI

Install

Get the skill from its source (we cannot redistribute it):
https://github.com/openai/plugins/tree/d420d13051bffe4543ed39e30fa46b87148e47dd/plugins/openai-developers/skills/openai-api-troubleshooting

Documentation by OpenAI

The licence of this skill does not allow us to copy its documentation. Read it at the source

Files

SKILL.md(opens on GitHub)Not mirrored: opens on GitHub3.8 KiB
agents/openai.yaml(opens on GitHub)Not mirrored: opens on GitHub136 B
references/evals.md(opens on GitHub)Not mirrored: opens on GitHub8.0 KiB

Requirements and compatibility

Written for: OpenAI Codex

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Needs: Needs an API key

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Diagnosing Bugs
Matt Pocock· Community
A structured, six-phase discipline for systematically diagnosing and resolving complex software bugs and performance regressions.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITLow riskHas scriptsGitHub stars of the source repository317.5k
Systematic Debugging
Jesse Vincent (obra)· Community
A rigorous, four-phase framework for identifying and resolving technical issues by prioritizing root cause analysis over symptomatic fixes.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITLow riskHas scriptsGitHub stars of the source repository314k
Performance Optimization
Addy Osmani· Community
A rigorous, measurement-first workflow for identifying and fixing performance bottlenecks in frontend and backend applications.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository113.9k
Debugging And Error Recovery
Addy Osmani· Community
A systematic, six-step framework for triaging, reproducing, and resolving software bugs to ensure root-cause fixes.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository113.9k
Animation Performance
Emil Kowalski· Community
A diagnostic guide for identifying and fixing frame drops in web animations to ensure smooth, performant motion.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository54.3k
Parallel Debugging
Seth Hobson· Community
A structured framework for debugging complex issues using parallel hypothesis testing and evidence-based arbitration.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository42.3k