Write, review, debug and migrate OpenAI API code with model tables and a request linter built from live probes of 29 models. Covers Responses, Chat Completions, tools, costs and tested scaffolds.
An Agent Skill for writing, reviewing, debugging and migrating code that calls the OpenAI API.
Its model tables and request linter were built by sending 55 request shapes (Responses API and Chat Completions) to each of 29 OpenAI text models and recording what the API accepted. The linter's verdict matched the API on all 1,594 recorded outcomes.
Not affiliated with OpenAI. "OpenAI" and "GPT" are trademarks of OpenAI.
| Path | Purpose |
|---|---|
SKILL.md | When to use the skill, the working loop, the rules that cause most failures |
references/models.md | Ids, context windows, output caps, prices (generated) |
references/request-rules.md | What each model accepts on each API, with exact error texts (generated) |
references/requests.md | Responses anatomy, streaming, structured outputs, files, embeddings, batches |
references/tools-and-agents.md | Function calling, the loop, hosted tools, the Agents SDK |
references/state-caching-cost.md | Conversation state, prompt caching, cost levers |
references/errors.md | Status codes and observed rejections with fixes |
scripts/openai-api.mjs | Offline CLI: models, lint, fix, convert, migrate, cost, compare, scaffold, guide |
The scripts use only the Node.js standard library, open no network connection and need no key.
skills install @spboucher/openai-api-toolkit --client claude-code # or codex, cursor, generic-agent-skills
See CHANGELOG.md for a with/without-skill evaluation against the live API, with its caveats.
A snapshot taken on the date in SKILL.md. Only text models visible to the probing key were
probed. Computer use, Realtime, fine-tuning, Assistants and Azure OpenAI were not probed. Cost
output is an estimate. When the API and this skill disagree, the API is right.
Destination: ~/.claude/skills/openai-api-toolkit · project scope: .claude/skills/openai-api-toolkit
1Install with the Skills CLI (verifies the checksum, previews the destination, never runs scripts)
skills install @spboucher/openai-api-toolkit@1.0.1 --client claude-codeAdd --project to install into .claude/skills/openai-api-toolkit instead of ~/.claude/skills/openai-api-toolkit.
2Or manually: download the release archive
curl -fsSLo openai-api-toolkit-1.0.1.tar.gz https://skills.spboucher.ai/api/v1/artifacts/spboucher/openai-api-toolkit/versions/1.0.1/download3Verify the SHA-256 checksum
echo "6d2fc4242de7d6179c65365cbbba1a731b8868e84987251a2909eb16b92b9d42 openai-api-toolkit-1.0.1.tar.gz" | shasum -a 256 -c -4Inspect the contents before extracting
tar -tzf openai-api-toolkit-1.0.1.tar.gz5Extract into ~/.claude/skills/openai-api-toolkit
mkdir -p ~/.claude/skills/openai-api-toolkit && tar -xzf openai-api-toolkit-1.0.1.tar.gz -C ~/.claude/skills/openai-api-toolkitInstalling only copies or configures. Nothing is executed for you. The Skills CLI verifies the checksum before writing files.
Select a file to preview it. Files are shown as plain text and never executed.
No advisory findings from static-1.0.0 on Nov 10, 2026. 7 informational notes.
Static checks are advisory. They never certify that a package is safe. Compatibility entries are publisher claims unless marked verified.
| Version | Published | Size | SHA-256 | State |
|---|---|---|---|---|
| 1.0.1latest | Nov 10, 2026 | 37 kB | 6d2fc4242de7… | published |
| 1.0.0 | Nov 10, 2026 | 36 kB | 4377ba24e79d… | published |
Fix: migrate now converts Chat Completions requests when the target model is Responses-only.
Drive Safari on macOS with AppleScript: reliable page waits, reading, forms, uploads, downloads with the page's session, screenshots. Works in a dedicated window with domain policy and sensitive-field guards.
Write, review, debug and migrate Claude API code with model tables and a request linter built from live API probes of 15 models. Includes cost estimates and tested agent scaffolds.
Checks that every in-text citation in a Markdown or LaTeX manuscript has a bibliography entry, and the reverse.