gemini-imagelisted
Install: claude install-skill BryceEWatson/claude-global-skills
# gemini-image
The maintained, machine-wide core for **image generation and editing with
Google Gemini**. One zero-dependency Python file — runs on any machine with
`python`, no per-project install. It is the canonical successor to the
`gemini-client` plugin (strict superset; that plugin is retired in its favour).
## Quick start
```bash
GEM=~/.claude/skills/gemini-image/scripts/gemini_image.py
# Generate
python "$GEM" --image -o castle.png "A watercolor painting of a medieval castle"
# Pick a model / aspect ratio / resolution
python "$GEM" --image -o hero.png --model gemini-3-pro-image \
--aspect-ratio 2:3 --image-size 2K "Botanical oil painting of peonies"
# Edit or compose from reference image(s) — repeat -i (3-pro up to 8, 3.1-flash up to 14)
python "$GEM" --image -o staged.png -i room.png -i sofa.png \
"Place this sofa in this room with warm afternoon light"
# See which image models your key can use
python "$GEM" --list-models --images-only
```
Auth resolves in order: `--api-key` → `GEMINI_API_KEY` → `GOOGLE_API_KEY` →
`.env` (cwd, then next to the script). The key is sent as `x-goog-api-key`.
## Models (verified against the live API, 2026-06)
| Model | Status | Use for |
|---|---|---|
| `gemini-3-pro-image` / `-preview` | GA / preview | **Auto-selected default** — highest fidelity, accurate text rendering, up to 8 reference images. Mockups, design, data-viz. |
| `gemini-3.1-flash-image` / `-preview` | GA / preview | Balanced (~half the cost, close to Pr