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.

Features

• 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

1. Install CLIProxy

# macOS
brew install cliproxyapi

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

# Windows - Download from GitHub releases

2. Authenticate

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

3. Install Skill

Option A: Global (all projects)

npm install -g image-nano
image-nano init -g
# Skill installed to ~/.claude/skills/image-nano/

Option B: Project-level

cd my-project
npm install image-nano
npx image-nano init
# Skill installed to .agent/skills/image-nano/

4. Verify

python ~/.claude/skills/image-nano/scripts/gen_image.py --check
# ✅ Ready! Model: gemini-3-pro-image-preview

Usage

With AI Assistant

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.

Automatic Skill Collaboration (Decision Tree)

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.

CLI

# 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.

# 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