Claude Code Image Gen — Development skill for Claude Code

claude-code-image-gen

A [Claude Code](https://claude.com/claude-code) skill that generates images through OpenAI, Google Gemini, Higgsfield, Black Forest Labs FLUX, or any OpenAI-compatible endpoint — behind a single CLI with no dependencies.

Ask Claude for a hero image and it picks the provider you have keys for, writes the prompt, saves the PNG into your project, and shows it to you.

you  ▸ generate a hero image for the pricing page, dark, abstract, 16:9

        ↳ skill: image-gen
        ↳ python3 scripts/generate.py -p "..." -a 16:9 -o ./public/hero.png
        ↳ {"success": true, "provider": "openai", "model": "gpt-image-2.5-sunburst"}

Why

Most image-gen integrations pin one provider, or one model name that goes stale the next time the provider ships. This one routes across providers, reads the live model catalog instead of a hardcoded list, and degrades to a clear error instead of a wrong guess.

• No dependencies. Python 3.8+ standard library. No pip install, no Node, no MCP server to keep running.
• Provider-agnostic. Five backends, one flag. Anything OpenAI-shaped works without new code.
• Resilient parsing. The response walker finds a base64 blob or image URL anywhere in the payload, so a provider tweaking its schema does not break it.
• Async handled. Higgsfield and FLUX submit-then-poll jobs are wrapped; you just get a file path back.

Install

git clone https://github.com/behzadsp/claude-code-image-gen.git ~/.claude/skills/image-gen

Claude Code loads skills from `~/.claude/skills/` (personal) or `.claude/skills/` (per-project, committed to git). To keep the repo elsewhere while still having it discovered, clone where you like and symlink instead:

git clone https://github.com/behzadsp/claude-code-image-gen.git ~/src/image-gen
ln -s ~/src/image-gen ~/.claude/skills/image-gen

Restart Claude Code, then ask it for an image.

Optionally put the CLI on PATH so it also works as a plain c