openai-api-troubleshooting

90 / 100 · Low risk

Fine to try. Some of what it can do is expected: a coding skill usually runs build and test commands.

By openai/plugins (GitHub) · coding · 7,836 stars · scanned at commit d420d13

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.

Works with any agent that supports SKILL.md skills.

What this skill can do

Can call paid AI services billed to you

This is disclosed by the author in the skill's SKILL.md or README.

Found in 4 places.

plugins/openai-developers/skills/openai-api-troubleshooting/SKILL.md, line 13- Look for transport failures before any OpenAI API response exists, such as DNS errors, connection timeouts, connection resets, or an execution environment tha
plugins/openai-developers/skills/openai-api-troubleshooting/references/evals.md, line 9- "My OpenAI API request fails with `ENOTFOUND api.openai.com` from inside a Codex sandbox before any HTTP response comes back. What should I do?"
plugins/openai-developers/skills/openai-api-troubleshooting/references/evals.md, line 30before any HTTP response with a DNS error while reaching api.openai.com. What

Show 1 more

plugins/openai-developers/skills/openai-api-troubleshooting/references/evals.md, line 126| T1 | `I am testing an app that calls the OpenAI API. Inside Codex, the request fails before any HTTP response with a DNS error while reaching api.openai.com.

Runs commands on your computer

The author does not mention this. It runs automatically when the plugin is installed. Expected for a coding skill.

Found in 1 place.

plugins/openai-developers/.mcp.json, line 5"command": "node",

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'openai-api-troubleshooting' ] || [ -L ~/.agents/skills/'openai-api-troubleshooting' ]; then echo 'A skill folder named openai-api-troubleshooting already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/openai/plugins' "$d" && git -C "$d" checkout --quiet 'd420d13051bffe4543ed39e30fa46b87148e47dd' -- 'plugins/openai-developers/skills/openai-api-troubleshooting' && mkdir -p ~/.agents/skills && cp -R "$d"/'plugins/openai-developers/skills/openai-api-troubleshooting' ~/.agents/skills/'openai-api-troubleshooting' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'openai-api-troubleshooting' ~/.claude/skills/'openai-api-troubleshooting' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for openai/plugins shows the score of its lowest-scoring skill.

SkillTrust badge for openai/plugins

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/openai/plugins.svg)](https://zalavijaysinh.github.io/skilltrust/repos/openai/plugins/)

Score history

Date	Version	Score
2026-11-07	`d420d13`	90

Also found in

Identical copies of this skill exist at:

zhongjingyun/codex-plugins/plugins/openai-developers/skills/openai-api-troubleshooting