Universal image generation skill for AI coding assistants (CLIProxy). Auto-installs to project, supports batch generation and ID consistency.
npm install image-nano> Universal image generation skill for AI coding assistants


A plug-and-play skill for AI coding assistants (Claude Code, Antigravity, OpenCode, Cursor) that enables high-quality image generation via CLIProxy.
- 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
``bashmacOS
brew install cliproxyapi
$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 ./outWith reference (ID lock)
python .../gen_image.py --prompt "Same person, new outfit" --ref anchor.jpgBatch 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 -gProject
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/` |- Installation
- Usage
- API Reference
- Troubleshooting
- Uninstall
MIT