happy-image-gen

Q: How do I install happy-image-gen?

Run npx skills add https://github.com/iamzhihuix/happy-claude-skills --skill happy-image-gen in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/happy-image-gen/ (personal) or .claude/skills/happy-image-gen/ (project).

by iamzhihuixMedia & Creative

Universal AI image generation supporting OpenAI DALL·E / gpt-image, Google Gemini Image / Imagen, Replicate (Flux / SDXL / any model), Stability AI, FAL, Ark (Seedream 4.5), Bailian (qwen-image / wanx), and SiliconFlow. Use this skill whenever the user asks to generate, create, draw, illustrate, render, or synthesize images from text prompts or reference images. Typical phrases include "draw a ...", "generate an image of ...", "画一张 ...", "给我来张图", "make a poster of ...", "create an illustration ...", or any mention of image-generation model families like DALL·E, gpt-image, Flux, SDXL, Seedream, Imagen, Gemini image, Kolors, or Wanx. Always use this skill even if the user does not name a specific model — pick a provider based on their EXTEND.md defaults or available API keys in the environment. Do NOT use this skill when the user explicitly mentions 即梦 / Dreamina / Jimeng — those go to happy-dreamina instead.

Installs: 155
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/iamzhihuix/happy-claude-skills --skill happy-image-gen

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads happy-image-gen automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

happy-image-gen

Generates still images across 8 providers through one CLI: bun scripts/main.ts .... The same CLI handles text-to-image and image-to-image (reference-driven) edits.

Quick usage

bun scripts/main.ts --prompt "A calico cat on green grass, cinematic light" --ar 16:9 --image ./out.png

When to invoke this skill

Invoke this skill whenever the user:

Asks to generate, create, draw, render, illustrate, or synthesize an image from text.
Asks to restyle or transform an existing image they provide a path to.
Names any image-generation model (DALL·E, gpt-image, Flux, SDXL, Gemini Image, Imagen, Seedream, Kolors, Wanx, Stable Diffusion) without specifying 即梦/Dreamina/Jimeng.

Route to happy-dreamina instead when the user explicitly names 即梦, Jimeng, or the dreamina CLI.

Step 0: Preflight (BLOCKING — run before any generation)

Run these checks:

Locate EXTEND.md config. Check in order:
- ./.happy-skills/happy-image-gen/EXTEND.md (project)
- $XDG_CONFIG_HOME/happy-skills/happy-image-gen/EXTEND.md
- ~/.happy-skills/happy-image-gen/EXTEND.md (user)
If none exist, run bun scripts/main.ts --setup and follow references/config/first-time-setup.md to create one. Do not proceed to generation until the user has at least one provider configured.
Verify a provider is usable. Confirm either an env var is set (e.g., OPENAI_API_KEY) or EXTEND.md references an api_key_env / api_key_source that resolves. If nothing resolves, loop back to setup.
Verify Bun is available. Run command -v bun. If missing, fall back to npx -y bun scripts/main.ts ....

Step 1: Choose a provider

Pick in this order of preference:

--provider <id> explicitly passed by the user.
The default_provider in EXTEND.md.
The first provider whose API key is present in the environment. Priority when auto-detecting: openai → google → replicate → stability → fal → ark → bailian → siliconflow.

See references/providers.md for each provider's required env vars, default models, and strengths (e.g., prefer google for text-in-image, replicate for Flux-family photorealism, ark for Chinese text fidelity).

Step 2: Fill in parameters

--prompt: the user's full request, trimmed. Always double-quote.
--ar: aspect ratio — 1:1 / 16:9 / 9:16 / 3:4 / 4:3. See references/aspect_ratio_map.md for how each provider interprets this.
--quality: draft (fastest + cheapest), hd (default), or ultra (4K-class, slower).
--ref <path>: repeat for multiple reference images. Not every provider supports this — see providers.md.
--model: override the default model for the chosen provider. Omit unless the user asked for a specific one.
--image <path>: REQUIRED — output file path. Use a descriptive name (e.g., ./out/hero-landscape.png).

Step 3: Run

bun scripts/main.ts \
  --prompt "..." \
  --image ./out.png \
  --provider openai \
  --ar 1:1 \
  --quality hd

On success the CLI prints the resolved absolute path and byte count. In --json mode it emits:

{ "success": true, "provider": "openai", "model": "gpt-image-1", "image": "/abs/path.png", "size_bytes": 1416341, "format": "png" }

Echo the path back to the user.

Step 4: Handle errors

config: No provider selected ... — no API key in env and no EXTEND.md. Loop back to Step 0.
[openai] OpenAI images API 401 ... — key invalid or expired. Ask the user to refresh it.
[openai] ... 400 ... content_policy_violation — prompt blocked. Show the raw error to the user; do not paraphrase.
Timeouts / network errors — retry once. If still failing, surface the raw message and provider so the user knows what to check.

See references/error_codes.md for a per-provider error table.

References

Read on demand:

references/providers.md — all 8 providers, required env vars, default models, strengths.
references/aspect_ratio_map.md — how each provider interprets --ar.
references/error_codes.md — common errors per provider and fixes.
references/config/first-time-setup.md — step-by-step for --setup.
references/config/extend-schema.md — EXTEND.md schema reference.

Template for EXTEND.md: assets/EXTEND.template.md.

FAQ

What does the happy-image-gen skill do?

How do I install happy-image-gen?

Run npx skills add https://github.com/iamzhihuix/happy-claude-skills --skill happy-image-gen in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/happy-image-gen/ (personal) or .claude/skills/happy-image-gen/ (project).

Which AI agents can use happy-image-gen?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is happy-image-gen safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains happy-image-gen?

It is published by iamzhihuix in iamzhihuix/happy-claude-skills. It has 155 recorded installs.