Skip to content
Back to search

nano-banana

SkillWorks with Gemini CLIGitHub

REQUIRED for all image generation requests. Generate and edit images using Nano Banana (Gemini CLI). Handles blog featured images, YouTube thumbnails, icons, diagrams, patterns, illustrations, photos, visual assets, graphics, artwork, pictures. Use this skill whenever the user asks to create, generate, make, draw, design, or edit any image or visual content.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kkoppenhaver-cc-nano-banana/badge.svg)](/listings/kkoppenhaver-cc-nano-banana)

HTML

<a href="/listings/kkoppenhaver-cc-nano-banana"><img src="/api/listings/kkoppenhaver-cc-nano-banana/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Install the Gemini CLI

npm install -g @google/gemini-cli

2. Set your API key

export NANOBANANA_GEMINI_API_KEY="your-api-key"

3. Install the nanobanana extension

gemini extensions install https://github.com/gemini-cli-extensions/nanobanana

4. Install this skill

Copy the `SKILL.md` file to your Claude Code skills directory:

mkdir -p ~/.claude/skills/nano-banana
cp SKILL.md ~/.claude/skills/nano-banana/

Or clone this repository directly:

git clone https://github.com/kkoppenhaver/cc-nano-banana ~/.claude/skills/nano-banana

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 150 lines · 5 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: nano-banana
  3. description: REQUIRED for all image generation requests. Generate and edit images using Nano Banana (Gemini CLI). Handles blog featured images, YouTube thumbnails, icons, diagrams, patterns, illustrations, photos, visual assets, graphics, artwork, pictures. Use this skill whenever the user asks to create, generate, make, draw, design, or edit any image or visual content.
  4. allowed-tools: Bash(gemini:*)
  5. ---
  6. # Nano Banana Image Generation
  7. Generate professional images via the Gemini CLI's nanobanana extension.
  8. ## When to Use This Skill
  9. ALWAYS use this skill when the user:
  10. - Asks for any image, graphic, illustration, or visual
  11. - Wants a thumbnail, featured image, or banner
  12. - Requests icons, diagrams, or patterns
  13. - Asks to edit, modify, or restore a photo
  14. - Uses words like: generate, create, make, draw, design, visualize
  15. Do NOT attempt to generate images through any other method.
  16. ## Before First Use
  17. 1. Verify extension is installed:
  18. ```bash
  19. gemini extensions list | grep nanobanana
  20. ```
  21. 2. If missing, install it:
  22. ```bash
  23. gemini extensions install https://github.com/gemini-cli-extensions/nanobanana
  24. ```
  25. 3. Verify API key is set:
  26. ```bash
  27. [ -n "$GEMINI_API_KEY" ] && echo "API key configured" || echo "Missing GEMINI_API_KEY"
  28. ```
  29. ## Command Selection
  30. | User Request | Command |
  31. |--------------|---------|
  32. | "make me a blog header" | `/generate` |
  33. | "create an app icon" | `/icon` |
  34. | "draw a flowchart of..." | `/diagram` |
  35. | "fix this old photo" | `/restore` |
  36. | "remove the background" | `/edit` |
  37. | "create a repeating texture" | `/pattern` |
  38. | "make a comic strip" | `/story` |
  39. ## Available Commands
  40. **Note:** Always use the `--yolo` flag to automatically approve all tool actions.
  41. | Command | Use Case |
  42. |---------|----------|
  43. | `gemini --yolo "/generate 'prompt'"` | Text-to-image generation |
  44. | `gemini --yolo "/edit file.png 'instruction'"` | Modify existing image |
  45. | `gemini --yolo "/restore old_photo.jpg 'fix scratches'"` | Repair damaged photos |
  46. | `gemini --yolo "/icon 'description'"` | App icons, favicons, UI elements |
  47. | `gemini --yolo "/diagram 'description'"` | Flowcharts, architecture diagrams |
  48. | `gemini --yolo "/pattern 'description'"` | Seamless textures and patterns |
  49. | `gemini --yolo "/story 'description'"` | Sequential/narrative images |
  50. | `gemini --yolo "/nanobanana prompt"` | Natural language interface |
  51. ## Common Options
  52. - `--yolo` - **Required.** Auto-approve all tool actions (no confirmation prompts)
  53. - `--count=N` - Generate N variations (1-8)
  54. - `--preview` - Auto-open generated images
  55. - `--styles="style1,style2"` - Apply artistic styles
  56. - `--format=grid|separate` - Output arrangement
  57. ## Common Sizes
  58. | Use Case | Dimensions | Notes |
  59. |----------|------------|-------|
  60. | YouTube thumbnail | 1280x720 | `--aspect=16:9` |
  61. | Blog featured image | 1200x630 | Social preview friendly |
  62. | Square social | 1080x1080 | Instagram, LinkedIn |
  63. | Twitter/X header | 1500x500 | Wide banner |
  64. | Vertical story | 1080x1920 | `--aspect=9:16` |
  65. ## Model Selection
  66. Default: `gemini-2.5-flash-image` (~$0.04/image)
  67. For higher quality (4K, better reasoning):
  68. ```bash
  69. export NANOBANANA_MODEL=gemini-3-pro-image-preview
  70. ```
  71. ## Blog Featured Image Examples
  72. ```bash
  73. # Modern illustration style
  74. gemini --yolo "/generate 'modern flat illustration of developer coding at laptop, purple and blue gradient background, minimalist style, no text' --preview"
  75. # Professional photography style
  76. gemini --yolo "/generate 'professional editorial photo of coffee cup next to laptop on wooden desk, morning sunlight, shallow depth of field, no text' --count=3"
  77. # Tech/abstract
  78. gemini --yolo "/generate 'abstract visualization of neural network connections, dark background with glowing blue nodes, futuristic style' --preview"
  79. ```
  80. ## Icon Generation
  81. ```bash
  82. gemini --yolo "/icon 'minimalist app logo for productivity tool' --sizes='64,128,256,512' --type='app-icon' --corners='rounded'"
  83. ```
  84. ## Diagram Generation
  85. ```bash
  86. gemini --yolo "/diagram 'user authentication flow with OAuth' --type='flowchart' --style='modern'"
  87. ```
  88. ## Output Location
  89. All generated images are saved to `./nanobanana-output/` in the current directory.
  90. ## Presenting Results
  91. After generation completes:
  92. 1. List contents of `./nanobanana-output/` to find generated files
  93. 2. Present the most recent image(s) to the user
  94. 3. Offer to regenerate with variations if needed
  95. ## Refinements and Iterations
  96. When the user asks for changes:
  97. - **"Try again" / "Give me options"**: Regenerate with `--count=3`
  98. - **"Make it more [adjective]"**: Adjust prompt and regenerate
  99. - **"Edit this one"**: Use `gemini --yolo "/edit nanobanana-output/filename.png 'adjustment'"`
  100. - **"Different style"**: Add `--styles="requested_style"` to the command
  101. ## Prompt Tips
  102. 1. **Be specific**: Include style, mood, colors, composition details
  103. 2. **Add "no text"**: If you don't want text rendered in the image
  104. 3. **Reference styles**: "editorial photography", "flat illustration", "3D render", "watercolor"
  105. 4. **Specify aspect ratio context**: "wide banner", "square thumbnail", "vertical story"
  106. ## Troubleshooting
  107. | Problem | Solution |
  108. |---------|----------|
  109. | `GEMINI_API_KEY` not set | `export GEMINI_API_KEY="your-key"` |
  110. | Extension not found | Run install command from setup section |
  111. | Quota exceeded | Wait for reset or switch to flash model |
  112. | Image generation failed | Check prompt for policy violations, simplify request |
  113. | Output directory missing | Will be created automatically on first run |
README.md · README · 108 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Nano Banana
  2. A Claude Code skill for generating and editing images using the Gemini CLI's nanobanana extension.
  3. ## Features
  4. - **Text-to-image generation** - Create images from natural language prompts
  5. - **Image editing** - Modify existing images with instructions
  6. - **Photo restoration** - Repair damaged or old photos
  7. - **Icon generation** - Create app icons and favicons
  8. - **Diagram creation** - Generate flowcharts and architecture diagrams
  9. - **Pattern generation** - Create seamless textures and patterns
  10. - **Story/sequential images** - Generate narrative image sequences
  11. ## Prerequisites
  12. 1. **Gemini CLI** - Install from [gemini-cli](https://github.com/google-gemini/gemini-cli)
  13. 2. **Gemini API Key** - Get one from [Google AI Studio](https://aistudio.google.com/)
  14. 3. **nanobanana extension** - Installed via Gemini CLI
  15. ## Installation
  16. ### 1. Install the Gemini CLI
  17. ```bash
  18. npm install -g @google/gemini-cli
  19. ```
  20. ### 2. Set your API key
  21. ```bash
  22. export NANOBANANA_GEMINI_API_KEY="your-api-key"
  23. ```
  24. ### 3. Install the nanobanana extension
  25. ```bash
  26. gemini extensions install https://github.com/gemini-cli-extensions/nanobanana
  27. ```
  28. ### 4. Install this skill
  29. Copy the `SKILL.md` file to your Claude Code skills directory:
  30. ```bash
  31. mkdir -p ~/.claude/skills/nano-banana
  32. cp SKILL.md ~/.claude/skills/nano-banana/
  33. ```
  34. Or clone this repository directly:
  35. ```bash
  36. git clone https://github.com/kkoppenhaver/cc-nano-banana ~/.claude/skills/nano-banana
  37. ```
  38. ## Usage
  39. Once installed, Claude Code will automatically use this skill when you ask for image generation. Examples:
  40. - "Generate a blog header image for a post about machine learning"
  41. - "Create a YouTube thumbnail for a coding tutorial"
  42. - "Make an app icon for a productivity tool"
  43. - "Draw a flowchart showing user authentication"
  44. - "Edit this image to remove the background"
  45. ## Available Commands
  46. | Command | Description |
  47. |---------|-------------|
  48. | `/generate` | Text-to-image generation |
  49. | `/edit` | Modify existing images |
  50. | `/restore` | Repair damaged photos |
  51. | `/icon` | Generate app icons |
  52. | `/diagram` | Create flowcharts and diagrams |
  53. | `/pattern` | Generate seamless patterns |
  54. | `/story` | Create sequential/narrative images |
  55. | `/nanobanana` | Natural language interface |
  56. ## Common Options
  57. | Option | Description |
  58. |--------|-------------|
  59. | `--count=N` | Generate N variations (1-8) |
  60. | `--preview` | Auto-open generated images |
  61. | `--styles="style1,style2"` | Apply artistic styles |
  62. | `--seed=N` | Seed for reproducible results |
  63. ## Output
  64. Generated images are saved to `./nanobanana-output/` in your current working directory.
  65. ## Model Selection
  66. Default model: `gemini-2.5-flash-image` (~$0.04/image)
  67. For higher quality output:
  68. ```bash
  69. export NANOBANANA_MODEL=gemini-3-pro-image-preview
  70. ```
  71. ## License
  72. MIT
  73. ## Contributing
  74. Contributions are welcome! Please open an issue or submit a pull request.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.