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

Kdy použít

• Uživatel chce vygenerovat obrázek, ilustraci, logo, banner, produktovou fotku
• Trigger fráze: "vytvoř obrázek", "vygeneruj", "/banana", "generate image", "nakresli", "udělej obrázek"

Workflow

Krok 1: Pochop zadání

Pokud uživatel nezadal popis v $ARGUMENTS, zeptej se: "Co chceš vygenerovat?"

Z odpovědi 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)

Pokud je typ nebo účel nejasný, odhadni z kontextu. Neptej se na samozřejmosti.

Krok 2: Parametry

Standard mód (default — pokud uživatel neřekne jinak, jeď rovnou):

• Model: Flash, Rozlišení: 1K, Poměr: 1:1, Počet: 1

Custom mód (uživatel řekne "custom", "nastav", "chci vybrat" nebo zadá konkrétní parametr): Zeptej se jednou otázkou na vše, co nezadal:

Model (flash/pro), rozlišení (512/1K/2K/4K), poměr (1:1/16:9/9:16/3:2/4:3/4:5/21:9), počet

Auto-doporučení — na základě typu obrázku navrhni parametry:

Typ	Model	Poměr	Rozlišení
Produktovka	flash	1:1 nebo 4:5	1K–2K
Banner web	flash	21:9 nebo 16:9	2K
Instagram post	flash	1:1 nebo 4:5	1K
Instagram story/reel	flash	9:16	1K
Blog header	flash	16:9	1K
Logo / text v obrázu	pro	1:1	2K
Portrét	flash	3:4 nebo 4:5	2K
Krajina / panorama	flash	16:9 nebo 21:9	2K–4K
Prezentace	flash	16:9	2K

Pokud detekuješ text v zadání → automaticky doporuč pro model.

Krok 3: Sestav prompt

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

Anatomie dobrého promptu

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:

Typ	Technika
Produktovka	"product photography, clean white background, soft studio lighting, shot with 100mm macro lens, sharp focus, no shadows"
Lifestyle	"candid lifestyle photography, natural window light, shallow depth of field, 50mm lens, warm tones"
Banner	"wide-angle composition with generous negative space on the left for text overlay, dramatic lighting"
Social	"vibrant saturated colors, eye-level perspective, bright even lighting, Instagram-ready crop"
Portrét	"portrait photography, 85mm lens, f/1.8 aperture, soft bokeh background, Rembrandt lighting"
Krajina	"landscape photography, golden hour, wide-angle 24mm, deep depth of field, dramatic sky"
Logo	"minimalist logo design, flat vector style, clean geometric shapes, centered on solid background"
Ilustrace	"digital illustration, clean lines, modern flat design, limited color palette"

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."

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

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

Uživatel říká	Co udělat v promptu
"moc tmavé"	Změň lighting na "bright, high-key lighting, well-lit scene"
"moc generické"	Přidej specifické detaily — materiály, textury, prostředí
"chci jiný úhel"	Změň perspektivu — "bird's eye", "low angle", "close-up"
"víc prostoru na text"	Přidej "generous negative space on [left/right/top] for text overlay"
"jiný styl"	Zeptej se jaký, pak přepiš vrstvu 2 a 3
"líbí se, ale..."	Zachovej 90% promptu, uprav jen zmíněný detail

Parametry banana.py

--prompt "popis"          Anglický prompt
--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)
--batch N                 Počet obrázků (default: 1)
--output-dir cesta        Vlastní výstupní složka

Modely

Klíč	Model	Kdy použít
flash	gemini-3.1-flash-image-preview	Default. Rychlý, levný, dobrá kvalita.
pro	gemini-3-pro-image-preview	Text v obrázcích, loga, složité scény, maximální kvalita.

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

$ARGUMENTS