Nano Banana Assets

Production image assets for coding agents. This skill generates, edits, describes, and regenerates usable image assets for apps, sites, games, docs, and marketing work with Nano Banana 2 or Nano Banana Pro through the Gemini API.

Repo:

• GitHub: https://github.com/qpd-v/nano-banana-assets
• Clone URL: https://github.com/qpd-v/nano-banana-assets.git

What It Does

• Generate hero images, icons, logos, sprites, thumbnails, posters, mockups, empty states, UI surface materials, and social art.
• Edit existing assets with targeted instructions.
• Describe an image and turn it into a one-pass reconstruction prompt.
• Regenerate a prior result with focused improvement instructions.
• Default to Nano Banana 2 unless Pro is explicitly requested or clearly better suited.
• Save every run with a unique prompt-derived image filename plus prompt.txt and metadata.json.

Generated Examples

Generated with this skill and committed as README examples:

Compatibility

Works on Windows, macOS, and Linux as long as the host can:

• read a skill folder with SKILL.md
• run Node 20+ or equivalent shell tooling
• reach the Gemini API

Supported install/use paths in v1:

• Codex skill folders and GitHub/local skill installs
• Claude Code skill folders
• universal/manual skill folders such as .agent/skills
• direct local CLI usage from the repo root
• npm package install via npm install -g nano-banana-assets

See docs/compatibility.md.

Install

See docs/install.md for full instructions.

Fast path:

git clone https://github.com/qpd-v/nano-banana-assets.git
cd nano-banana-assets
npm install

Then either:

• install it into a host skill directory with node scripts/install.mjs --agent codex --scope user
• or run it directly from the repo with node scripts/cli.mjs ...

Published npm package:

npm install -g nano-banana-assets

Quick Start

1. Copy .env.example to .env.
2. Put your real GEMINI_API_KEY in .env.
3. Keep .env out of git and commit .env.example.
4. Run a first test:

node scripts/cli.mjs generate --prompt "A simple ripe banana on a clean white background"

Optional verification commands:

node scripts/doctor.mjs --check-env
npm run release:check

Model Routing

• Nano Banana 2 maps to gemini-3.1-flash-image-preview and is the default.
• Nano Banana Pro maps to gemini-3-pro-image-preview.
• Use Pro when you need higher fidelity, stricter constraint following, or more studio-style output.
• Use NB2 for cheaper iteration and most day-to-day asset work.

Natural language that triggers Pro:

• use Nano Banana Pro
• use Pro
• maximum fidelity
• highest precision

Common Commands

• generate
• plan-asset
• generate-asset
• edit-asset
• describe-image
• regenerate

Command aliases also exist for explicit model selection:

• generate-pro, generate-nb2
• plan-asset-pro, plan-asset-nb2
• generate-asset-pro, generate-asset-nb2
• edit-asset-pro, edit-asset-nb2
• describe-image-pro, describe-image-nb2
• regenerate-pro, regenerate-nb2

Modifiers And Controls

Use these when you need tighter control:

• --model
• --model-preference
• --pro / --nb2
• --aspect-ratio
• --image-size or --resolution
• --quality
• --candidate-count
• --temperature
• --top-p
• --top-k
• --seed
• --reasoning-level
• --google-search / --grounded

Tutorial Prompts

See docs/tutorial-prompts.md for copy-paste prompt patterns, including:

• hero image prompts
• icon and logo prompts
• UI surface material prompts
• edit and regenerate flows
• project-aware asset generation prompts

Output

Each run writes a timestamped folder under generated/ with:

• the rendered image file, renamed to a unique prompt-derived asset name
• prompt.txt
• metadata.json

Metadata records the model, model selection reason, controls, prompt, source references, and output path.

Examples

See:

• examples/README.md
• docs/tutorial-prompts.md

Publish And Distribution

This repo is structured for:

• GitHub-based skill installation
• local/manual installs
• npm publication

Current distribution notes:

• npm package is live as nano-banana-assets
• public listing targets and submission notes are documented in docs/where-to-list.md

Troubleshooting

See docs/troubleshooting.md.

Release Validation

Release validation commands:

npm test
npm run check:syntax
npm run check:skill
npm run release:check

Privacy And Safety

See docs/privacy-and-safety.md.