Agent skill

Nano Banana Pro

by nicepkg in nicepkg/ai-workflow

Generate images using Google's Nano Banana Pro (gemini-3-pro-image-preview).

MITAuto-check passedMedia & Creative

Install Nano Banana Pro

skills CLI
$ npx skills add nicepkg/ai-workflow --skill nano-banana-pro -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install nicepkg/ai-workflow nano-banana-pro --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/nicepkg/ai-workflow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/workflows/talk-to-slidev-workflow/.claude/skills/nano-banana-pro .claude/skills/nano-banana-pro && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
nano-banana-pro
GitHub stars
285
Token cost
~806 tokens
SKILL.md length
234 words
Files
2
Skills in repo
75
Repo updated
First seen
Licence
MIT

At a glance

Generate images using Google's Nano Banana Pro (gemini-3-pro-image-preview).

  • User asks to create
  • SKILL.md covers Prerequisites, Usage, Model Capabilities and Output
  • Runs Python scripts from its folder; calls uv; needs GEMINI_API_KEY
  • Tasks that involve Image generation

What it does

Nano Banana Pro is an agent skill from nicepkg/ai-workflow. Generate images using Google's Nano Banana Pro (gemini-3-pro-image-preview). Accepts text prompts and optionally images (for editing/transformation) as INPUT. Returns generated IMAGES as OUTPUT. Use when user asks to create, generate, edit, or draw images, infographics, visualizations, diagrams, charts, or illustrations. Excellent for data-accurate infographics and text rendering.

Its SKILL.md is about 810 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `generate_image.py`).

It sits in Media & Creative, covering Image generation and Infographics. It works with Google Gemini. The repository describes itself as: 🚀 170+ pre-built skills for Claude Code, Cursor, Codex & 14+ AI tools. Stop re-teaching your AI the same things. One command → instant domain expertise. Marketing, SEO, Trading… The licence is MIT.

When your agent uses it

  • User asks to create
  • Tasks that involve Image generation
  • Tasks that involve Infographics

Example prompts

  • “/nano-banana-pro”

Requirements

  • Python 3
  • A credential in GEMINI_API_KEY
  • Pre-approved tools (allowed-tools): Bash(uv:*), Write, Read

What it can do on your machine

Read from SKILL.md and the folder at commit d167b41. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(uv:*)
    • Write
    • Read

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • GEMINI_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Nano Banana Pro loads about 806 tokens when it runs. Until then it costs about 100 tokens; SKILL.md has 234 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~100
When it runs · the whole SKILL.md, loaded when a task matches
~806

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from nicepkg/ai-workflow at commit d167b41, republished under its MIT licence (© nicepkg). 234 words, ~806 tokens.

Download SKILL.mdSave it as .claude/skills/nano-banana-pro/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
nano-banana-pro
description
Generate images using Google's Nano Banana Pro (gemini-3-pro-image-preview). Accepts text prompts and optionally images (for editing/transformation) as INPUT. Returns generated IMAGES as OUTPUT. Use when user asks to create, generate, edit, or draw images, infographics, visualizations, diagrams, charts, or illustrations. Excellent for data-accurate infographics and text rendering.
allowed-tools
Bash(uv:*), Write, Read

Nano Banana Pro Image Generator

Generate images using Google's advanced Nano Banana Pro model (gemini-3-pro-image-preview).

Prerequisites

The user must have GEMINI_API_KEY environment variable set with a valid Google AI API key.

Usage

The script is located in the same directory as this SKILL.md file. Run it with uv run:

bash
uv run /path/to/skills/nano-banana-pro/generate_image.py "your prompt" -o output.png

When this skill is invoked, locate generate_image.py in the skill directory and run it.

Parameters
ParameterRequiredDescription
promptYesText description of the image to generate or transformation to apply
-o, --outputYesOutput filename (you decide the path based on context)
-i, --imageNoInput image(s) for editing/transformation or as context/reference (can be used multiple times)
--aspect-ratioNoOne of: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 (default: 1:1)
--sizeNoImage size: 1K, 2K, 4K (default: 1K)
Examples

Basic image generation:

bash
uv run generate_image.py "A sunset over mountains" -o sunset.png

Infographic with specific aspect ratio:

bash
uv run generate_image.py "Infographic showing the water cycle with labeled stages" -o water_cycle.png --aspect-ratio 9:16

High-resolution ultrawide:

bash
uv run generate_image.py "Professional photo of a modern office space" -o office.png --aspect-ratio 21:9 --size 4K

Edit an existing image:

bash
uv run generate_image.py "Add a sunset sky to this image" -i photo.png -o edited.png

Transform with style:

bash
uv run generate_image.py "Make this look like a watercolor painting" -i input.jpg -o watercolor.png

Combine multiple images:

bash
uv run generate_image.py "Create a collage blending these images together" -i img1.png -i img2.png -o collage.png

Use image as context/reference:

bash
uv run generate_image.py "Generate a new landscape in the same style as this reference" -i reference.png -o new_landscape.png

Model Capabilities

Nano Banana Pro excels at:

  • Accurate infographics with real data (uses Google Search grounding)
  • Text rendering in images
  • Image editing and transformation from input images
  • Context-aware generation using reference images for style, composition, or subject
  • Cartographic visualizations and maps
  • Detailed instruction following
  • Chain-of-thought reasoning for complex visual tasks

Output

The script prints:

  • Progress message while generating
  • Path to saved image on success
  • Any text response from the model
  • Error message if no image was generated

© nicepkg, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in workflows/talk-to-slidev-workflow/.claude/skills/nano-banana-pro of nicepkg/ai-workflow.

  • SKILL.md
  • generate_image.py

Open the folder on GitHubat commit d167b41

Compare with similar skills

Nano Banana Pro next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Nano Banana Pro compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Nano Banana Pro this skillnicepkg/ai-workflow285—~806Automated safety check: PassMIT
SEO Image GeneratorAgriciDaniel/claude-seo19k2 repos~2.1kAutomated safety check: PassMIT
Gemini Carouselcharlie947/social-media-skills3.8k—~1.7kAutomated safety check: PassMIT
Tech Article Diagramwwwzhouhui/skills_collection283—~1.8kAutomated safety check: PassNone
Create Explanatory ImageAbilityai/cornelius109—~2.8kAutomated safety check: NotesMIT
InfographicsK-Dense-AI/scientific-agent-skills48k1 repos~3.8kAutomated safety check: NotesMIT

Similar skills

  • SEO Image Generator

    AgriciDaniel/claude-seo

    Generates Open Graph previews, blog hero images, product photos and infographics for SEO use through Gemini image tools and the banana extension.

    19k GitHub starsUsed in 2 repos~2.1k tokens
    Media & CreativeAuto-check passed
  • Gemini Carousel

    charlie947/social-media-skills

    Generate a branded slide-by-slide LinkedIn carousel using Gemini.

    3.8k GitHub stars~1.7k tokensUpdated 25 days ago
    Media & CreativeAuto-check passed
  • Tech Article Diagram

    wwwzhouhui/skills_collection

    为技术长文自动识别插图位置,并生成 16:9 概念图/流程图/对比图/架构图。支持七种风格:手绘网格笔记本风(notebook)、专业扁平信息图(infographic)、现代高级科技商务风(executive-tech)、温暖手绘卡片风(cozy-handdrawn)、技术简笔画风(tech-doodle)、卡通信息图风(cartoon-infographic)和白板手绘风(whiteboar…

    283 GitHub stars~1.8k tokensUpdated 4 days ago
    Media & CreativeAuto-check passed
  • Create Explanatory Image

    Abilityai/cornelius

    Generate explanatory diagrams and infographics that visually communicate concepts.

    109 GitHub stars~2.8k tokensUpdated 2 days ago
    Media & CreativeAuto-check: notes
  • Infographics

    K-Dense-AI/scientific-agent-skills

    Creates and reviews infographics with Nano Banana 2 via OpenRouter.

    48k GitHub starsUsed in 1 repo~3.8k tokens
    Media & CreativeAuto-check: notes
  • Nano Banana

    social-media-skills/skills

    A skill your agent uses to write great prompts for Nano Banana (Google's Gemini image model: Nano Banana Pro = Gemini 3 Pro Image) to generate or edit images for social media — the…

    134 GitHub stars~1.6k tokensUpdated 8 days ago
    Media & CreativeAuto-check passed

More from nicepkg/ai-workflow

All 75 skills in this repo
  • Capture Triage

    nicepkg/ai-workflow

    Processes Drafts Pro captures from the Inbox folder. An agent skill from nicepkg/ai-workflow.

    285 GitHub stars~3k tokensUpdated 8 mo ago
    Auto-check passed
  • Legacy To AI Ready

    nicepkg/ai-workflow

    Transform legacy codebases into AI-ready projects with Claude Code configurations.

    285 GitHub stars~2.2k tokensUpdated 8 mo ago
    Auto-check: notes
  • Newsletter Coach

    nicepkg/ai-workflow

    Writing coach that extracts educational content from your daily experiences and turns it into publish-ready newsletter drafts.

    285 GitHub stars~3.7k tokensUpdated 8 mo ago
    Auto-check passed
  • Webfluence

    nicepkg/ai-workflow

    Content web architecture framework. An agent skill from nicepkg/ai-workflow.

    285 GitHub stars~1.4k tokensUpdated 8 mo ago
    Auto-check passed
  • Workflow Creator

    nicepkg/ai-workflow

    Create complete Claude Code workflow directories with curated skills.

    285 GitHub stars~2.6k tokensUpdated 8 mo ago
    Auto-check passed
  • Media Processing

    nicepkg/ai-workflow

    Video/audio/image processing with FFmpeg and ImageMagick. An agent skill from nicepkg/ai-workflow.

    285 GitHub stars~2.4k tokensUpdated 8 mo ago
    Auto-check: notes

Works with

Questions about Nano Banana Pro

What does Nano Banana Pro do?

Generate images using Google's Nano Banana Pro (gemini-3-pro-image-preview). Nano Banana Pro is an agent skill from nicepkg/ai-workflow. Generate images using Google's Nano Banana Pro (gemini-3-pro-image-preview).

When should I use Nano Banana Pro?

Nano Banana Pro fits situations like: user asks to create; tasks that involve Image generation; tasks that involve Infographics.

How do I install Nano Banana Pro in Claude Code?

Run `npx skills add nicepkg/ai-workflow --skill nano-banana-pro -a claude-code`. Or copy the skill folder (workflows/talk-to-slidev-workflow/.claude/skills/nano-banana-pro in nicepkg/ai-workflow) into .claude/skills/nano-banana-pro in your project. Claude Code loads it when a task matches its description.

How do I install Nano Banana Pro in Codex?

Run `npx skills add nicepkg/ai-workflow --skill nano-banana-pro -a codex`. Or copy the skill folder (workflows/talk-to-slidev-workflow/.claude/skills/nano-banana-pro in nicepkg/ai-workflow) into .agents/skills/nano-banana-pro in your project. Codex loads it when a task matches its description.

Can I use Nano Banana Pro in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add nicepkg/ai-workflow --skill nano-banana-pro -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nano-banana-pro, .gemini/skills/nano-banana-pro, .github/skills/nano-banana-pro and .opencode/skills/nano-banana-pro in your project.

What does Nano Banana Pro need to run?

Going by SKILL.md and its folder, Nano Banana Pro needs Python for the scripts in its folder, the command-line tools its instructions call (uv) and credentials named GEMINI_API_KEY. Our summary lists: Python 3; A credential in GEMINI_API_KEY. Its frontmatter pre-approves these tools: Bash(uv:*), Write, Read.

Does Nano Banana Pro access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Nano Banana Pro safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Nano Banana Pro use?

Nano Banana Pro is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Nano Banana Pro use?

About 806 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Nano Banana Pro?

Skills that share tags, products or a category with Nano Banana Pro: SEO Image Generator (AgriciDaniel/claude-seo, 19k stars), Gemini Carousel (charlie947/social-media-skills, 3.8k stars), Tech Article Diagram (wwwzhouhui/skills_collection, 283 stars) and Create Explanatory Image (Abilityai/cornelius, 109 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nano Banana Pro?

nicepkg (a GitHub organization) maintains it in nicepkg/ai-workflow, which has 285 GitHub stars. The repository holds 75 skills in this directory. The repository was last updated on January 20, 2026.

Source: nicepkg/ai-workflow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.