Agent skill

Nanobanana Skill

by feiskyer in feiskyer/codex-settings

Generate, edit, or composite images with Gemini/Nanobanana. An agent skill from feiskyer/codex-settings.

MITAuto-check passed

Install Nanobanana Skill

skills CLI
$ npx skills add feiskyer/codex-settings --skill nanobanana-skill -a claude-code

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

GitHub CLI
$ gh skill install feiskyer/codex-settings nanobanana-skill --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/feiskyer/codex-settings.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/nanobanana-skill .claude/skills/nanobanana-skill && 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
nanobanana-skill
GitHub stars
244
Token cost
~1.2k tokens
SKILL.md length
459 words
Files
5
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Generate, edit, or composite images with Gemini/Nanobanana. An agent skill from feiskyer/codex-settings.

  • Works in 3 steps: GEMINI_API_KEY in ~/.nanobanana.env… → Python dependencies from requirements.txt. → The executable is nanobanana.py in this…
  • SKILL.md covers Requirements, Defaults, Run it and Prompting, plus 1 more section
  • Runs Python scripts from its folder; calls python3; needs GEMINI_API_KEY

What it does

Nanobanana Skill is an agent skill from feiskyer/codex-settings. Generate, edit, or composite images with Gemini/Nanobanana. Default for image requests without a named provider; do not override a different provider the user chose.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files (for example `agents/openai.yaml`, `nanobanana.py` and `tests/test_nanobanana.py`).

It works with Google Gemini. The repository describes itself as: Curated skills, profiles, and config templates that supercharge Codex CLI — multi-model, deep research, image gen & browser automation. The licence is MIT.

Example prompts

  • “/nanobanana-skill”

Requirements

  • Python 3
  • A credential in GEMINI_API_KEY

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. GEMINI_API_KEY in ~/.nanobanana.env (GEMINI_API_KEY=sk-dummy) or the shell environment.
  2. Python dependencies from requirements.txt.
  3. The executable is nanobanana.py in this same skill directory. Resolve its absolute path once before running it.

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    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:

    • python3

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

  • Network

    No URLs in SKILL.md.

    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

Nanobanana Skill loads about 1.2k tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 459 words of instructions outside code blocks.

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

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 feiskyer/codex-settings at commit d7f6570, republished under its MIT licence (© feiskyer). 459 words, ~1,189 tokens.

Download SKILL.mdSave it as .claude/skills/nanobanana-skill/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
nanobanana-skill
description
Generate, edit, or composite images with Gemini/Nanobanana. Default for image requests without a named provider; do not override a different provider the user chose.

Nanobanana Image Skill

Use the bundled nanobanana.py to generate or edit images with Gemini image models. The default path targets Nano Banana 2 (gemini-3.1-flash-image-preview) with thinking summaries and Google Search grounding on, because those defaults are the main reason to use this skill instead of a generic image prompt.

Requirements

  1. GEMINI_API_KEY in ~/.nanobanana.env (GEMINI_API_KEY=sk-dummy) or the shell environment.
  2. Python dependencies from requirements.txt.
  3. The executable is nanobanana.py in this same skill directory. Resolve its absolute path once before running it.

The CLI can print --help without credentials. It validates local input files before creating an API client and exits non-zero when the API returns no image.

Defaults

Model gemini-3.1-flash-image-preview, search grounding on, thinking summaries on at level high, resolution 1K, and no aspect ratio unless the request implies a shape. Do not make the user choose a model, search mode, or thinking mode unless they asked for that level of control.

Leaving aspect ratio unspecified is usually better for edits, because Gemini can match the input image shape. For text-only generation, set one only when the user implies a format such as poster, square post, banner, phone wallpaper, or ultrawide hero.

Worth overriding: --model gemini-3-pro-image-preview for very detail-heavy or typography-sensitive work (slower); --resolution 512px for quick ideation (Nanobanana 2 models only), 2K/4K for polished deliverables; --thinking-level low when latency beats refinement; search off when the user wants a purely imaginative result. Run python3 /absolute/path/to/nanobanana.py --help for the exact accepted values, including the full aspect-ratio and model lists.

Show full SKILL.md (210 more words)Show less

Run it

Generate from text:

bash
python3 /absolute/path/to/nanobanana.py \
  --prompt "Create a high-end coffee bag package design with tactile paper texture and clear typography" \
  --output /absolute/path/to/output/package.png

Edit or composite — pass every reference with --input. Nanobanana 2 mixes multiple references well, so do not narrow a blend, lineup, storyboard, or consistency pass down to a single image:

bash
python3 /absolute/path/to/nanobanana.py \
  --prompt "Turn these product photos into a clean ecommerce hero image with a soft studio shadow and subtle headline area" \
  --input /absolute/path/to/ref1.png /absolute/path/to/ref2.png \
  --aspect-ratio 4:5 \
  --output /absolute/path/to/output/hero.png

Grounded generation, saving the model's text and metadata alongside the image:

bash
python3 /absolute/path/to/nanobanana.py \
  --prompt "Use Google Search to ground an editorial illustration about the most recent lunar mission and create a clean magazine cover concept" \
  --text-output /absolute/path/to/output/cover.txt \
  --metadata-output /absolute/path/to/output/cover.json \
  --output /absolute/path/to/output/cover.png

Then report the saved path(s), whether search grounding stayed enabled, where any text or thought summaries landed, and any warning from the run. If the model returns text but no image, say so plainly and suggest a more explicitly image-focused prompt rather than presenting the run as a success.

Prompting

Good Nanobanana prompts are production briefs, not art wishes: subject, visual style, composition or camera framing, any required text, the output's use case, and constraints such as brand colors, negative space, or realism level.

text
Create a premium sparkling water can advertisement. Use a cold studio product-photo look, silver highlights, condensation droplets, and a clean dark-teal background. Leave negative space in the upper-right for headline copy.

For edits, say what to preserve as well as what to change:

text
Keep the shoe silhouette and logo placement intact. Replace the background with a bright outdoor basketball court, add dynamic afternoon shadows, and keep the image looking like a real sports campaign photo.

When a run fails

Check credential presence without printing its value, input readability, and output writability. For an unsupported option, consult the helper's accepted values. Correct assistant-chosen options within the requested result, but do not silently switch a user-selected model or provider. Before a bounded retry, check whether the earlier attempt already produced output; report the actual error if recovery would require new authority or changing the request.

© feiskyer, 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 4 other files in skills/nanobanana-skill of feiskyer/codex-settings.

  • SKILL.md
  • agents/openai.yaml
  • nanobanana.py
  • requirements.txt
  • tests/test_nanobanana.py

Open the folder on GitHubat commit d7f6570

Compare with similar skills

Nanobanana Skill 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.

Nanobanana Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Nanobanana Skill this skillfeiskyer/codex-settings244—~1.2kAutomated safety check: PassMIT
NotebookLM Research AssistantPleasePrompto/notebooklm-skill7.8k14 repos~2.4kAutomated safety check: NotesMIT
Brand and Design Toolkitnextlevelbuilder/ui-ux-pro-max-skill135k1 repos~3.5kAutomated safety check: PassMIT
AI Image Generation and Editingzhayujie/CowAgent47k—~1.3kAutomated safety check: PassMIT
OpenCLI Smart Search Routerjackwener/OpenCLI30k2 repos~753Automated safety check: PassApache-2.0
NotebookLM Automationteng-lin/notebooklm-py20k—~4.1kAutomated safety check: PassMIT

Similar skills

  • NotebookLM Research Assistant

    PleasePrompto/notebooklm-skill

    Lets Claude Code ask questions of your Google NotebookLM notebooks through browser automation and return answers grounded in your uploaded sources.

    7.8k GitHub starsUsed in 14 repos~2.4k tokens
    Knowledge ManagementAuto-check: notes
  • Brand and Design Toolkit

    nextlevelbuilder/ui-ux-pro-max-skill

    Bundles design tasks behind one skill: brand identity, tokens, UI styling, logos, corporate identity mockups, slides, banners, icons and social images.

    135k GitHub starsUsed in 1 repo~3.5k tokens
    Media & CreativeAuto-check passed
  • Generates or edits images from text prompts through a Python script that picks an image backend based on which API keys are configured.

    47k GitHub stars~1.3k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Routes a search question to the most suitable opencli source, normally one AI site plus up to two specialist sites, with call limits per question and a recap at the end.

    30k GitHub starsUsed in 2 repos~753 tokens
    Productivity & AutomationAuto-check passed
  • NotebookLM Automation

    teng-lin/notebooklm-py

    Installs, authenticates and operates Gemini Notebook (NotebookLM) through the notebooklm-py CLI or its typed async Python API, for notebooks, sources, grounded chat and generated artifacts.

    20k GitHub stars~4.1k tokensUpdated yesterday
    Knowledge ManagementAuto-check passed
  • Nano Banana Pro Prompts Recommend Skill

    YouMind-OpenLab/nano-banana-pro-prompts-recommend-skill

    Recommend suitable prompts from 10,000+ Nano Banana Pro image generation prompts based on user needs.

    1.9k GitHub starsUsed in 1 repo~4.1k tokens
    Media & CreativeAuto-check passed

More from feiskyer/codex-settings

All 11 skills in this repo
  • Youtube Transcribe Skill

    feiskyer/codex-settings

    Extract subtitles or a transcript from a YouTube URL and save normalized timestamped text locally.

    244 GitHub stars~745 tokensUpdated 13 days ago
    Auto-check passed
  • Claude Skill

    feiskyer/codex-settings

    Delegate a task to the Claude Code CLI, typically a headless claude -p run.

    244 GitHub stars~742 tokensUpdated 13 days ago
    Auto-check passed
  • Gpt Image Skill

    feiskyer/codex-settings

    Generate or edit images when the user names OpenAI, GPT Image, or a gpt-image model.

    244 GitHub stars~572 tokensUpdated 13 days ago
    Auto-check passed
  • Minimax Image Skill

    feiskyer/codex-settings

    Generate images when the user names MiniMax or image-01/image-01-live.

    244 GitHub stars~495 tokensUpdated 13 days ago
    Auto-check passed
  • Code Simplifier

    feiskyer/codex-settings

    Simplify existing code for clarity and maintainability without changing behavior.

    244 GitHub stars~521 tokensUpdated 13 days ago
    Auto-check passed
  • Deep Research

    feiskyer/codex-settings

    用 Codex CLI 子任务完成多来源深度调研并综合成带出处的报告。用于确实需要分头取证的研究,不用于单次查证或已给定材料的总结。

    244 GitHub stars~302 tokensUpdated 13 days ago
    Auto-check passed

Works with

Questions about Nanobanana Skill

What does Nanobanana Skill do?

Generate, edit, or composite images with Gemini/Nanobanana. An agent skill from feiskyer/codex-settings. Nanobanana Skill is an agent skill from feiskyer/codex-settings. Generate, edit, or composite images with Gemini/Nanobanana.

How do I install Nanobanana Skill in Claude Code?

Run `npx skills add feiskyer/codex-settings --skill nanobanana-skill -a claude-code`. Or copy the skill folder (skills/nanobanana-skill in feiskyer/codex-settings) into .claude/skills/nanobanana-skill in your project. Claude Code loads it when a task matches its description.

How do I install Nanobanana Skill in Codex?

Run `npx skills add feiskyer/codex-settings --skill nanobanana-skill -a codex`. Or copy the skill folder (skills/nanobanana-skill in feiskyer/codex-settings) into .agents/skills/nanobanana-skill in your project. Codex loads it when a task matches its description.

Can I use Nanobanana Skill 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 feiskyer/codex-settings --skill nanobanana-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nanobanana-skill, .gemini/skills/nanobanana-skill, .github/skills/nanobanana-skill and .opencode/skills/nanobanana-skill in your project.

What does Nanobanana Skill need to run?

Going by SKILL.md and its folder, Nanobanana Skill needs Python for the scripts in its folder, the command-line tools its instructions call (python3) and credentials named GEMINI_API_KEY. Our summary lists: Python 3; A credential in GEMINI_API_KEY.

Does Nanobanana Skill access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Nanobanana Skill 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 Nanobanana Skill use?

Nanobanana Skill 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 Nanobanana Skill use?

About 1.2k tokens (SKILL.md is roughly 4.8k 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 Nanobanana Skill?

Skills that share tags, products or a category with Nanobanana Skill: NotebookLM Research Assistant (PleasePrompto/notebooklm-skill, 7.8k stars), Brand and Design Toolkit (nextlevelbuilder/ui-ux-pro-max-skill, 135k stars), AI Image Generation and Editing (zhayujie/CowAgent, 47k stars) and OpenCLI Smart Search Router (jackwener/OpenCLI, 30k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nanobanana Skill?

feiskyer (a GitHub user) maintains it in feiskyer/codex-settings, which has 244 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on September 27, 2026.

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