sketch-ai-provider-debug
Debug OpenAI/Gemini image generation failures for Sketch Magic. Use when `/api/convert` returns 500, when models are unsupported, when outputs are empty, or when provider timeouts/quota errors appear.
npx skills add majiayu000/claude-skill-registry --skill sketch-ai-provider-debug-joelklabo-markdowntown-cli-2 --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Sketch AI Provider Debug ## Overview Provide a consistent debug flow for image generation failures across OpenAI and Gemini providers without leaking secrets. ## Workflow ### 1) Verify configuration - Confirm `OPENAI_API_KEY` / `GEMINI_API_KEY` exist. - Confirm `DEFAULT_PROVIDER`, `OPENAI_IMAGE_MODEL`, `GEMINI_IMAGE_MODEL` match supported models. - Use `/api/health` to confirm defaults. ### 2) Reproduce with a controlled request - Use a tiny PNG and short prompt. - Use `curl` to hit `/api/convert` (multipart form data). - Keep logs visible (server + client). ### 3) Interpret common failures - **500**: provider error, missing key, quota, or model mismatch. - **400**: invalid image type, size, or prompt. - **Timeout**: provider latency or host timeout config. ### 4) Fix or adjust - Swap to a known-good model. - Reduce image size or prompt complexity. - Confirm provider SDK versions align with supported endpoints. ### 5) Report safely - Do not log API keys or raw image bytes. - Summarize error codes and timing only. ## References - `references/openai-image-api.md` - `references/gemini-image-api.md`
- Overview
- Workflow
- 1) Verify configuration
- 2) Reproduce with a controlled request
- 3) Interpret common failures
- 4) Fix or adjust
- 5) Report safely
- References
What does the sketch-ai-provider-debug skill do?
Debug OpenAI/Gemini image generation failures for Sketch Magic. Use when `/api/convert` returns 500, when models are unsupported, when outputs are empty, or when provider timeouts/quota errors appear.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill sketch-ai-provider-debug-joelklabo-markdowntown-cli-2 --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.