Index of every page on this site: llms.txt
All skills
github avatar

/nano-banana-pro-openrouter

@f10fdb8 official
by githubgithub/awesome-copilot41k stars
5,399
Run it yourself

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.

Use this Skill: https://skilld.dev/gh/github/awesome-copilot/nano-banana-pro-openrouter

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈52 tokens for metadata: the name and description. ≈574 when used: this file.

Description uses 2.6% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈208 characters, or 2.6%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning2mo5 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    The skill is safe. It allows users to generate, edit, or composite images using the Gemini 3 Pro Image model via the OpenRouter API. Dependencies and API integrations follow standard development practices.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: LOW · No issues

  • Runlayer9mo

    3/3 files flagged

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at f10fdb8. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 9 months ago
Other metadata
metadata
{
  "emoji": "🍌",
  "requires": {
    "bins": [
      "uv"
    ],
    "env": [
      "OPENROUTER_API_KEY"
    ]
  },
  "primaryEnv": "OPENROUTER_API_KEY"
}
  • API
  • image-generation
  • image-editing
  • openrouter
  • gemini
  • generative-ai
  • composition
  • uv

README badge

README badge for github/awesome-copilot/nano-banana-pro-openrouter

Generates or edits images via OpenRouter using the Gemini 3 Pro Image model, supporting prompt-only generation, single-image edits, and multi-image composition at 1K/2K/4K resolutions. Requires an OpenRouter API key and the uv package manager.

Generated from the current SKILL.md.

What image generation model does this skill use?
The skill uses the google/gemini-3-pro-image-preview model via OpenRouter. It supports prompt-only generation, single-image edits, and multi-image composition up to 3 images.
What output resolutions are supported?
The skill supports 1K, 2K, and 4K output resolutions via the --resolution flag. If not specified, it defaults to 1K.
Do I need to set up an API key?
Yes. You must set the OPENROUTER_API_KEY environment variable with a valid OpenRouter API key before running the skill.
Can I customize the image generation behavior?
Yes. The skill reads an optional system prompt from assets/SYSTEM_TEMPLATE to customize behavior without modifying code.
What should I do if I get an AuthenticationError?
Your API key is invalid or has no credits. Verify your key at https://openrouter.ai/settings/keys and ensure it has available balance.

Generated from the current SKILL.md. These answers refresh after source changes.