Skip to main content
skill GitHub Copilot official · GitHub

nano-banana-pro-openrouter — GitHub Copilot skill

Generates and edits images through OpenRouter with Gemini 3 Pro Image. Use it for text-to-image work, file edits, and multi-image compositions.

Install into GitHub Copilot · Skills CLI (Vercel) All methods and platforms ↓
npx skills add github/awesome-copilot --skill nano-banana-pro-openrouter
Open on GitHub

What nano-banana-pro-openrouter does

This skill runs scripts/generate_image.py with uv and sends requests to google/gemini-3-pro-image-preview. It can create an image from a prompt, alter one source image, or combine several files into one composition. Output supports 1K, 2K, and 4K; the default is 1K.

You can pass up to 3 files by repeating --input-image. --filename accepts relative and absolute paths, while multiple returned images get -1, -2, and similar suffixes. The script prints each saved result as MEDIA: .

The skill requires uv and OPENROUTER_API_KEY. Its image-generation behaviour can be adjusted in assets/SYSTEM_TEMPLATE. Install it if your image workflow already uses OpenRouter; it will not run without an API key.

What it helps with

  • generate an image from a text prompt
  • replace a background or detail in an input image
  • combine up to 3 images into one portrait
  • save output to a relative or absolute path
  • choose 1K, 2K, or 4K output

Example prompts for the agent

  • Create an image of snow-capped mountains at sunset and save it as `sunset.png`.
  • Replace the sky in `input.jpg` with an aurora and write the result to `aurora.png`.
  • Combine `face1.jpg` and `face2.jpg` into a studio portrait at `2K` resolution.

How to install nano-banana-pro-openrouter

1Skills CLI (Vercel)

npx skills add github/awesome-copilot --skill nano-banana-pro-openrouter

2GitHub CLI

gh skill install github/awesome-copilot nano-banana-pro-openrouter

3Manually: put the files in place

.github/skills/nano-banana-pro-openrouter/SKILL.md

From the same set554

The whole set →
git-commit official github This skill reviews Git changes, stages related files, and creates Conventional Commits. Use it when you want an agent to make one commit or split work into separate commits. GitHub Copilot 47,165installs excalidraw-diagram-generator official github Turn a plain-language description into an Excalidraw diagram. Useful for mapping processes, system structure, and relationships between entities. GitHub Copilot 31,639installs multi-stage-dockerfile official github This skill guides GitHub Copilot in writing multi-stage Dockerfiles for different languages and frameworks. Use it when the final runtime image should contain fewer build dependencies. GitHub Copilot 29,688installs documentation-writer official github Skill that turns the agent into a technical writer following the Diátaxis framework: tutorials, how-to guides, reference, and explanation. Proposes structure before writing. GitHub Copilot 27,757installs prd official github Turns a feature idea into a structured PRD with user stories, technical requirements, and risks. Use it when planning a software feature or an AI-powered one. GitHub Copilot 24,035installs refactor official github This skill reshapes existing code without changing its external behavior. Use it for gradual cleanup of large functions, duplication, weak types, and code smells. GitHub Copilot 22,321installs java-springboot official github Gives GitHub Copilot Spring Boot development practices, from project layout to tests and security. Use it when writing or reviewing Java application code. GitHub Copilot 21,272installs create-readme official github This skill reviews a project and creates a structured README.md. Use it when the repository needs clear documentation based on its actual files and code. GitHub Copilot 19,081installs

Similar

hatch-pet official openai Creates and packages animated pets and spritesheets for Codex. Use it to turn a character concept, reference image, or brand cues into a pet. Claude Code CX Codex Cursor +1 3,300installs winui-app official openai This skill helps create, configure, and review WinUI 3 apps built with C# and the Windows App SDK. Use it for new projects or XAML issues. Claude Code CX Codex Cursor +1 3,200installs text-to-lottie diffusionstudio Generates, edits, and debugs Lottie JSON animations for the local Skia Skottie player. Helps create UI microinteractions, loaders, and animated charts. Claude Code CX Codex Cursor +1 10,600installs shadcn-svelte huntabyte A skill for working with shadcn-svelte: adding components, building interfaces, fixing styles, and debugging projects. Use it if you're building UI with shadcn-svelte on Svelte or planning to start. Claude Code CX Codex Cursor +1 6,700installs frontend-design official anthropics This skill guides intentional visual design for new interfaces and redesigns. Use it when a generic generated UI is not enough. Claude Code Claude.ai 1,025,790installs grill-me Matt Pocock grill-me interviews you about a plan or design to expose gaps and sharpen decisions. Use it before implementation starts. Claude Code 1,424,476installs design-taste-frontend Leonxlnx This skill directs the design of public pages and work screens, then checks the result in a browser through screenshots. Use it when an interface feels generic or unfinished. Claude Code CX Codex Cursor +1 673,100installs prototype Matt Pocock Creates throwaway prototypes for checking state logic or exploring UI before committing the decision to the main codebase. Claude Code 986,201installs

Questions about nano-banana-pro-openrouter

How do I install nano-banana-pro-openrouter in GitHub Copilot?

Install the skill with npx skills add github/awesome-copilot --skill nano-banana-pro-openrouter. You can also use gh skill install github/awesome-copilot nano-banana-pro-openrouter.

What does nano-banana-pro-openrouter do?

It generates images through OpenRouter, edits one input image, and builds compositions from multiple images. It uses google/gemini-3-pro-image-preview for generation.

What does nano-banana-pro-openrouter need to run?

It requires uv and the OPENROUTER_API_KEY environment variable. The skill accepts up to 3 input images and supports 1K, 2K, and 4K output.

Source text

SKILL.md · MIT
---
name: nano-banana-pro-openrouter
description: 'Generate or edit images via OpenRouter with the Gemini 3 Pro Image model. Use for prompt-only image generation, image edits, and multi-image compositing; supports 1K/2K/4K output.'
metadata:
  emoji: 🍌
  requires:
    bins:
      - uv
    env:
      - OPENROUTER_API_KEY
  primaryEnv: OPENROUTER_API_KEY
---


# Nano Banana Pro OpenRouter

## Overview

Generate or edit images with OpenRouter using the `google/gemini-3-pro-image-preview` model. Support prompt-only generation, single-image edits, and multi-image composition.

### Prompt-only generation

```
uv run {baseDir}/scripts/generate_image.py \
  --prompt "A cinematic sunset over snow-capped mountains" \
  --filename sunset.png
```

### Edit a single image

```
uv run {baseDir}/scripts/generate_image.py \
  --prompt "Replace the sky with a dramatic aurora" \
  --input-image input.jpg \
  --filename aurora.png
```

### Compose multiple images

```
uv run {baseDir}/scripts/generate_image.py \
  --prompt "Combine the subjects into a single studio portrait" \
  --input-image face1.jpg \
  --input-image face2.jpg \
  --filename composite.png
```

## Resolution

- Use `--resolution` with `1K`, `2K`, or `4K`.
- Default is `1K` if not specified.

## System prompt customization

The skill reads an optional system prompt from `assets/SYSTEM_TEMPLATE`. This allows you to customize the image generation behavior without modifying code.

## Behavior and constraints

- Accept up to 3 input images via repeated `--input-image`.
- `--filename` accepts relative paths (saves to current directory) or absolute paths.
- If multiple images are returned, append `-1`, `-2`, etc. to the filename.
- Print `MEDIA: <path>` for each saved image. Do not read images back into the response.

## Troubleshooting

If the script exits non-zero, check stderr against these common blockers:

| Symptom | Resolution |
|---------|------------|
| `OPENROUTER_API_KEY is not set` | Ask the user to set it. PowerShell: `$env:OPENROUTER_API_KEY = "sk-or-..."` / bash: `export OPENROUTER_API_KEY="sk-or-..."` |
| `uv: command not found` or not recognized | macOS/Linux: <code>curl -LsSf https://astral.sh/uv/install.sh &#124; sh</code>. Windows: <code>powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 &#124; iex"</code>. Then restart the terminal. |
| `AuthenticationError` / HTTP 401 | Key is invalid or has no credits. Verify at <https://openrouter.ai/settings/keys>. |

For transient errors (HTTP 429, network timeouts), retry once after 30 seconds. Do not retry the same error more than twice — surface the issue to the user instead.

© github · MIT · github/awesome-copilot

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor