image-nano

> Universal image generation skill for AI coding assistants


Overview

A plug-and-play skill for AI coding assistants (Claude Code, Antigravity, OpenCode, Cursor) that enables high-quality image generation via CLIProxy.

$3

- Gemini-optimized - Nano Banana prompting techniques built-in
- Easy Init - Simple command to copy skill to project or user home
- Preflight auth check - Verify CLIProxy before generating
- Batch generation - Multiple images from prompt file
- ID consistency - Reference images for character preservation

- Skill collaboration - Works seamlessly with ai-artist for prompt enhancement

Quick Start

$3

``bash


macOS

brew install cliproxyapi

Linux

curl -fsSL https://raw.githubusercontent.com/brokechubb/cliproxyapi-installer/master/cliproxyapi-installer | bash

Windows - Download from GitHub releases

`

$3

Open http://localhost:8713 and login with Google.

$3

Option A: Global (all projects)
`bash
npm install -g image-nano
image-nano init -g


Skill installed to ~/.claude/skills/image-nano/


`

Option B: Project-level
`bash
cd my-project
npm install image-nano
npx image-nano init


Skill installed to .agent/skills/image-nano/


`

$3

`bash
python ~/.claude/skills/image-nano/scripts/gen_image.py --check


✅ Ready! Model: gemini-3-pro-image-preview


`

Usage

$3

Simply ask natural language requests. Claude will automatically apply Gemini-specific techniques:

`
> "Create a photorealistic portrait of a cyberpunk hacker with neon lighting"
`

Claude enhances your prompt and generates via CLIProxy.

$3

Claude follows this workflow:
`
1. Check for ai-artist skill
IF available: Search curated prompts via ai-artist
ELSE: Use built-in Nano Banana techniques from references/
2. Enhance prompt with matched/narrative style
3. Generate via CLIProxy
`

No manual configuration needed! Claude detects and composes skills intelligently.

$3

`bash


Single image

python .../gen_image.py --prompt "Enhanced prompt here" --output ./out

With reference (ID lock)

python .../gen_image.py --prompt "Same person, new outfit" --ref anchor.jpg

Batch generation

python .../gen_image.py --prompts prompts.txt --concurrent 4
`

Release Highlights (v1.0.2)

- Improved Clarity - SKILL.md now has explicit decision tree workflow.
- ai-artist Integration - Clear IF/ELSE logic for prompt enhancement.
- Reduced Tokens - SKILL.md reduced from 99 to 68 lines.
- Zero-Dependency - Pure Python urllib implementation.


`bash


Global

image-nano uninstall -g

Project

npx image-nano uninstall
`

Supported Frameworks

| Framework | Global Path | Project Path |
|:---|:---|:---|
| Claude Code | ~/.claude/skills/ | .agent/skills/ |
| Antigravity | ~/.gemini/antigravity/global_skills/ | .agent/skills/ |
| OpenCode | ~/.config/opencode/skills/ | .opencode/skills/ |
| Cursor | ~/.cursor/skills/ | .cursor/skills/` |

Documentation

- Installation
- Usage
- API Reference
- Troubleshooting
- Uninstall

License

MIT