Banana

Banana – generátor obrázků přes Gemini API v1.2

Kdy použít

• Uživatel chce vygenerovat obrázek, ilustraci, logo, banner, produktovou fotku
• Uživatel chce upravit existující obrázek (editace / img2img)
• Trigger fráze (generování): "vytvoř obrázek", "vygeneruj", "/banana", "generate image", "nakresli", "udělej obrázek"
• Trigger fráze (editace): "uprav tenhle obrázek", "změň pozadí", "edit", "odstraň z fotky", "přebarvi", "dej ten produkt do..."

Workflow

Krok 1: Pochop zadání

Z $ARGUMENTS urči tři věci:

1. Subjekt — co je na obrázku (produkt, osoba, scéna, abstrakce)
2. Typ obrázku — produktovka / lifestyle / banner / social post / blog / logo / ilustrace / portrét / krajina
3. Účel — kde to bude použité (web, Instagram, prezentace, tisk)

Default je zeptat se, ne hádat. Pokud si u subjektu, typu nebo účelu nejsi jistý na 100 % — $ARGUMENTS je prázdné nebo příliš vágní, popis by šel realizovat víc znatelně odlišnými způsoby — polož doplňující otázku, než začneš sestavovat prompt. Neptej se na detaily, které na výsledném obrázku nic nemění (přesný odstín v rámci jasně daného stylu); ptej se na to, kde by špatný odhad vedl k jinému obrázku, než uživatel chtěl. Otázku spoj s Krokem 2 do jedné zprávy (viz níže) — neptej se ve dvou kolech.

Generování vs. editace: Pokud uživatel odkazuje na existující obrázek („uprav tohle", „změň pozadí na téhle fotce", přiložený soubor), jde o editaci — použij --input a editační prompt (viz Krok 3). Ověř, že soubor existuje a je .jpg/.jpeg/.png/.webp. Pokud cestu neznáš, zeptej se na ni.

Krok 2: Parametry

Auto-doporučení (tabulka níže) použij bez ptaní jen když typ obrázku z Kroku 1 jednoznačně padne do jednoho řádku a uživatel nic dalšího nenaznačil. Ve všech ostatních případech — typ nejde k tabulce jasně přiřadit, zadání je vágní, nebo si nejsi jistý, jestli chce flash nebo pro, jaké rozlišení nebo poměr — zeptej se, nedomýšlej si to potichu.

Pokud potřebuješ doptat na cokoliv z Kroku 1 i z parametrů zároveň, polož jednu souhrnnou otázku, ne dvě zprávy po sobě:

Co přesně chceš vygenerovat (subjekt, kde to použiješ) + model (flash/pro), rozlišení (512/1K/2K/4K), poměr (1:1/16:9/9:16/3:2/2:3/4:3/3:4/4:5/5:4/21:9), počet — nebo potvrď navržené auto-doporučení: [vypiš konkrétní hodnoty, které bys použil].

Validní poměry jsou přesně: 1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9. Jiné (např. 2:1, 1:2) neexistují — vyber nejbližší validní a řekni to uživateli.

Volba modelu: text v obrázku (logo, banner s nápisem, infografika), požadavek na 4K, faktická přesnost (reálné produkty, mapy, diagramy) nebo konzistence napříč sérií → pro. Jinak flash — rychlý default pro fotorealismus a lifestyle bez textu.

Víc obrázků najednou:

• Varianty téhož motivu → --batch N (jeden prompt, N výsledků).
• Různé motivy najednou (sada bannerů, série produktovek) → zapiš prompty do souboru (jeden na řádek, # = komentář) a použij --prompts-file.

Krok 3: Sestav prompt

Nejdřív nahlédni do ~/.claude/skills/banana/prompt-library.md — pokud obsahuje osvědčený prompt pro stejný typ obrázku, použij ho jako výchozí bod a uprav jen subjekt/detaily. Knihovna poráží stavbu od nuly.

Prompt musí být anglicky, narativní (souvislé věty, NE tagy/klíčová slova) a přizpůsobený typu obrázku.

Pro generování od nuly platí anatomie 4 vrstev níže. Pro editaci (--input) platí jiná pravidla — viz sekce Editace obrázku.

Anatomie dobrého promptu (generování)

Každý prompt má 4 vrstvy. Skládej je v tomto pořadí:

Vrstva 1 — Scéna (CO vidím) Hlavní subjekt, akce, prostředí. Buď konkrétní a vizuální.

• Špatně: "hockey player"
• Dobře: "A hockey player mid-stride, stick raised for a slap shot, ice spray frozen in motion behind the blades"

Vrstva 2 — Technika (JAK to vypadá) Fotografické/designové parametry podle typu obrázku:

Vrstva 3 — Atmosféra (JAK to působí) Barvy, nálada, styl. Odvoď z kontextu projektu (CLAUDE.md) nebo ze zadání:

• Sportovní: "dynamic, energetic, high contrast, bold colors"
• Luxusní: "elegant, muted tones, subtle shadows, premium feel"
• Přátelský: "warm earth tones, inviting atmosphere, soft light"
• Technický: "clean, minimal, cool blue-gray palette, precise"

Vrstva 4 — Kvalita (technický uzávěr) Vždy zakonči jednou větou podle typu:

• Fotorealistické: "Photorealistic, high resolution, professional DSLR quality, crisp details."
• Grafika/logo: "Clean vector rendering, high resolution, print-ready quality."
• Ilustrace: "High detail digital art, clean rendering, professional illustration quality."

Negativní instrukce

Na konec promptu přidej relevantní záporné instrukce:

• Vždy: "No watermarks, no signatures, no artifacts."
• Produktovky: "No distracting background elements, no text unless specified."
• Portréty: "No distorted features, natural proportions."
• Loga: "No photorealistic elements, no gradients unless specified."
• Bannery: "No text in the image unless explicitly requested."

Editace obrázku (--input)

Model vezme existující obrázek a upraví ho podle promptu. Prompt stavěj jinak než při generování:

• Popiš JEN požadovanou změnu — model vstupní obrázek vidí, nepopisuj celou scénu od nuly.
• Explicitně řekni, co zachovat — např. "Keep the subject, composition and lighting unchanged."
• Stačí 1–3 věty. Anatomie 4 vrstev tu neplatí.

Typické úlohy a vzory:

Pravidla:

• U produktů a textu na obrázku preferuj pro — lépe drží detaily, nápisy a věrnost vstupu.
• --ratio/--size u editace zadávej, jen když uživatel chce jiný formát než má vstup.
• Spuštění: banana --input cesta/k/obrazku.png --prompt "edit instruction". Vstup: .jpg/.jpeg/.png/.webp.

Kontextové obohacení

Přečti CLAUDE.md aktuálního projektu. Hledej:

• Brandové barvy → vlož je explicitně do promptu
• Cílová skupina → ovlivní styl
• Typ produktu/služby → ovlivní rekvizity a prostředí
• Tón komunikace → ovlivní atmosféru

Krok 4: Ukaž a generuj

Před spuštěním VŽDY ukaž v tomto formátu:

Prompt: [celý anglický prompt]
Parametry: flash | 1K | 1:1 | 1 ks
Input: [cesta ke vstupnímu obrázku — jen u editace]

Pak spusť generování.

Krok 5: Iterace

Po vygenerování ukaž cestu k souboru a zeptej se:

Hotovo. Chceš:

1. Další variantu (stejný prompt, nový výsledek)
2. Upravit prompt (řekni co změnit)
3. Hotovo

Když uživatel potvrdí spokojenost („hotovo", „super", „to je ono"), přidej finální prompt do ~/.claude/skills/banana/prompt-library.md (formát viz hlavička souboru, nejnovější nahoru) a krátce to zmiň. Neukládej prompty, ke kterým se uživatel nevyjádřil kladně.

Parametry banana.py

--prompt "popis"          Anglický prompt
--prompts-file soubor.txt Dávka RŮZNÝCH promptů — jeden na řádek, # = komentář
--input cesta.png         Editace existujícího obrázku (.jpg/.jpeg/.png/.webp)
--mode standard|custom    Mód (default: standard)
--model flash|pro         Model (default: flash)
--size 512|1K|2K|4K       Rozlišení (default: 1K)
--ratio 1:1|16:9|9:16|... Poměr stran (default: 1:1), validní hodnoty viz Krok 2
--batch N                 N variant STEJNÉHO promptu (default: 1)
--output-dir cesta        Vlastní výstupní složka (default: aktuální složka)

--batch vs --prompts-file: batch generuje varianty jednoho promptu, prompts-file projede víc různých promptů najednou.

Modely

Spuštění

BANANA_DIR="$HOME/.claude/skills/banana"
source "$BANANA_DIR/.venv/bin/activate" && python3 "$BANANA_DIR/banana.py" [parametry]

První instalace:

cd ~/.claude/skills/banana
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env  # a vyplň GEMINI_API_KEY

Changelog

• 2026-07-28 — v1.2: Default otočen z "jeď rovnou, pokud uživatel neřekne jinak" na "zeptej se, kdykoli si nejsi 100% jistý" — platí pro obsah zadání (Krok 1: subjekt/typ/účel) i pro parametry (Krok 2: auto-doporučení se použije jen když typ obrázku jednoznačně padne do tabulky). Otázky na obsah i parametry se spojují do jedné zprávy, ne do dvou kol.
• 2026-07-23 — v1.1: Přidán workflow editace obrázku (--input, img2img) včetně vzorů promptů a trigger frází. Doplněn --prompts-file a odlišení od --batch. Sjednocen seznam validních poměrů stran. Zpřesněno rozhodovací pravidlo flash vs. pro (text/4K/přesnost → pro). Model IDs přepnuty na stabilní (GA) verze místo -preview. Přidána prompt-library.md — compound effect z osvědčených promptů (viz Krok 3 a 5).

$ARGUMENTS