nano-banana
Skill1 starsChanged 16 days agoMITView on GitHub
Renderiza imágenes vía la extensión nanobanana del Gemini CLI (gemini-2.5-flash-image, gemini-3-pro-image). Úsalo como MOTOR DE EJECUCIÓN cuando la dirección de arte YA está definida — por brandkit, imagegen-frontend-web, imagegen-frontend-mobile, banner-design, design o image-to-code. NO decide criterio visual: recibe un prompt ya dirigido y lo renderiza. Si el usuario pide una imagen sin dirección de arte previa, carga primero el skill correspondiente y usa este al final para producir el archivo.
- Reads credentials
40 other projects use a version of this.
Adopted by
Most recently taken up by
- okou-ai/okou-skillstheir own version, first seen Nov 11, 2026
- runapi-ai/nano-bananatheir own version, first seen Nov 8, 2026
- hwangx/claude-skill-nano-bananatheir own version, first seen Nov 6, 2026
- agentrix-ai/skillstheir own version, first seen Oct 20, 2026
- Samueladewole/claude-skillstheir own version, first seen Oct 13, 2026
- ruizrica/agent-pitheir own version, first seen Oct 9, 2026
Used with
Projects with it also use agency-docs-updater, brand-agency and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
KISHOR403Skillagency-docs-updater
End-to-end pipeline for publishing Claude Code lab meetings. Automatically finds/creates Fathom transcript, downloads video, uploads to YouTube, generates fact-checked Russian summary, creates MDX documentation, and pushes to agency-docs for Vercel deployment. Single invocation replaces 5+ manual steps.
Also in 3 projects that use this
KISHOR403Skillbrand-agency
Applies Agency brand colors and typography to artifacts including presentations, SVG graphics, documents, and web interfaces. This skill should be used when brand colors, visual formatting, neobrutalism style, or Agency design standards apply. Keywords - branding, corporate identity, visual identity, styling, brand colors, typography, visual formatting, visual design, neobrutalism.
Also in 3 projects that use this
krishagelSkillelevenlabs-tts
Generate high-quality audio from text using Eleven Labs API. Use for podcasts, narration, voice-overs, and audio summaries.
Also in 5 projects that use this
- +9 more from KISHOR403
Other versions40 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 40
- OpenMinis/MinisSkills★ 612same name
- EvoScientist/EvoSkills★ 486same name
- glebis/claude-skills★ 414same name
- kkoppenhaver/cc-nano-banana★ 368same name
- mikeOnBreeze/cc-crossbeam★ 297same name
- ruizrica/agent-pi★ 274same name
- LichAmnesia/lich-skills★ 233same name
- refly-ai/refly-skills★ 204same name
- okou-ai/okou-skills★ 81same name
- vm0-ai/vm0-skills★ 81same name
30 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository17 other files it gives its agents.
- anuncios-eficienciaSkill
- ah-brand-bookSkill
- conversion-medicionSkill
- crm-client-deliverySkill
- estrategia-digitalSkill
- estrategia-lightSkill
- market-differentiationSkill
- os-routerSkill
- ah-pitch-deck-systemSkill
- research-workflowSkill
- ah-social-listeningSkill
- web-design-workflowSkill
- brand-to-websiteSkill
- clone-to-framerSkill
- edit-style-applySkill
- edit-style-extractSkill
- entregable-legibleSkill
The file
We split this skill into the rules it gives an agent
5 rules. 0 are common, 1 is distinctive, and 4 are very specific to this project.
0
Common
Most of the 36 edited versions we read keep these.
1
Distinctive
This author's own choices. Worth a look.
4
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 38
No verifiques con [ -n "$GEMINI_API_KEY" ] desde Bash — la variable vive en el .env, no exportada al shell, y daría un falso negativo.
- Distinctive: line 40
Esto se cobra por uso: No hay suscripción que lo cubra por esta vía.
- Very specific: line 79
Default gemini-2.5-flash-image.
- Very specific: line 109
--seedfijo para toda la serie: No garantiza coherencia con prompts distintos, pero reduce la varianza. - Very specific: line 127
No dispares el lote en paralelo.
“Common” is measured: kept by at least 6 in 10 of the 36 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Nano Banana — motor de render
Ejecuta la generación de imagen. No define dirección de arte.
Posición en el flujo
Dirección de arte → Render
(brandkit, imagegen-*, (este skill)
banner-design, design)- Con dirección previa: recibe el prompt ya construido y lo renderiza tal cual.
- Sin dirección previa: carga primero el skill de dirección que corresponda al encargo. Solo salta ese paso si el usuario pide explícitamente un render crudo o una prueba rápida.
- Este skill nunca inventa paleta, tipografía ni composición por su cuenta. Ese criterio vive en los skills de dirección y, para trabajo de cliente, en el design system del proyecto.
Antes del primer uso
- Extensión instalada:
Si falta, se instala de forma interactiva (pide confirmación, no corre headless):gemini extensions list | grep nanobananagemini extensions install https://github.com/gemini-cli-extensions/nanobanana Credenciales. Esta máquina va por API key (
security.auth.selectedType: "gemini-api-key"en~/.gemini/settings.json). La key vive en~/.gemini/.envbajo dos nombres,GEMINI_API_KEYyNANOBANANA_GEMINI_API_KEY, porque el CLI y la extensión piden nombres distintos.No intentes cambiar esto a OAuth. Google descontinuó Gemini Code Assist for individuals en el Gemini CLI; el login con Google falla con
IneligibleTierErrory remite a Antigravity. La API key es la única vía funcional.No verifiques con
[ -n "$GEMINI_API_KEY" ]desde Bash — la variable vive en el.env, no exportada al shell, y daría un falso negativo. El CLI la carga solo.Esto se cobra por uso. No hay suscripción que lo cubra por esta vía.
Comandos
Siempre con --yolo para evitar prompts de confirmación que cuelgan la ejecución.
| Comando | Uso |
gemini --yolo "/generate 'prompt'" | Texto a imagen |
gemini --yolo "/edit archivo.png 'instrucción'" | Modificar imagen existente |
gemini --yolo "/restore foto.jpg 'quitar rayones'" | Restaurar fotos |
gemini --yolo "/icon 'descripción'" | Iconos, favicons |
gemini --yolo "/diagram 'descripción'" | Diagramas, flujos |
gemini --yolo "/pattern 'descripción'" | Texturas repetibles |
gemini --yolo "/story 'descripción'" | Secuencias narrativas |
Si el directorio no es confiable, agrega --skip-trust.
Opciones
--count=N— N variantes (1–8)--aspect=16:9— proporción--preview— abre el resultado--styles="estilo1,estilo2"— estilos--seed=N— reproducibilidad--format=grid|separate— arreglo de salida
Medidas frecuentes
| Uso | Medida | Nota |
| Thumbnail YouTube | 1280×720 | --aspect=16:9 |
| Featured de blog | 1200×630 | Buen preview social |
| Social cuadrado | 1080×1080 | Instagram, LinkedIn |
| Header X/Twitter | 1500×500 | Banner ancho |
| Story vertical | 1080×1920 | --aspect=9:16 |
Modelo
Default gemini-2.5-flash-image. Para mayor calidad:
export NANOBANANA_MODEL=gemini-3-pro-image-previewCosto: se cobra por imagen contra la API key (~$0.04 en flash, más en pro). No hay suscripción que lo cubra. Ante error de cuota o facturación, repórtalo al usuario en vez de reintentar en bucle — cada reintento puede ser un cargo. Para lotes grandes, confirma con el usuario antes de disparar.
Render desde manifiesto (flujo brand-to-website)
El workflow brand-to-website produce <outputDir>/assets/manifest.json con todas las
imágenes que el sitio necesita, ya con prompts dirigidos por el design system, y construye
el HTML referenciando esas rutas. Los archivos no existen hasta que se renderizan aquí.
Este paso requiere aprobación explícita del usuario — cuesta dinero por imagen. Nunca lo dispares por iniciativa propia: presenta el manifiesto con el conteo y el costo estimado, y espera el visto bueno.
Coherencia de serie — el riesgo #1
El modelo no tiene memoria entre invocaciones. Nueve llamadas son nueve encargos distintos: la temperatura de color deriva, la luz cambia de dirección, el grano y la saturación saltan, y a media página el "estilo" migra de fotografía a render 3D. Pedirle coherencia al agente en el prompt no es un mecanismo — es una esperanza. Estos sí lo son:
SERIES_STYLEcongelado. El manifiesto trae un párrafo único —medio, lente, luz, temperatura, grano, saturación, hex de la paleta, tratamiento de sombras— escrito una sola vez para todo el sitio. El prompt de cada asset es concatenación mecánica:SERIES_STYLE + "\n" + específico-del-slot. No lo reescribas ni lo "adaptes" por imagen: en el momento en que cada asset tiene su propia descripción de luz, la serie se rompe.--seedfijo para toda la serie. No garantiza coherencia con prompts distintos, pero reduce la varianza.- Genera menos. La mejor coherencia son 3 imágenes en vez de 9. Gradientes, patrones y texturas derivables de tokens se construyen nativos en Figma o en CSS: costo cero, cero deriva. Reserva el render para los 2-3 slots que de verdad cargan la página.
gemini-3-pro-imagepara esos 2-3 slots. Flash falla en caras y manos. Ajusta el estimado de costo si los usas — la cuenta de $0.04 por imagen deja de valer.
Ejecución del lote — secuencial, sin excepción
gemini --yolo --skip-trust "/${command} '${SERIES_STYLE}\n${prompt}' --aspect=${aspect} --seed=${seed}"Por cada entrada, en este orden estricto: renderiza → verifica que el archivo existe y tiene
bytes → muévelo de ./nanobanana-output/ a la ruta file del manifiesto → recién entonces pasa
a la siguiente.
No dispares el lote en paralelo. Si ocho imágenes caen juntas en nanobanana-output/, asignar
archivo→slot es adivinar, y adivinar mal significa la foto equivocada en la sección equivocada.
Eso ya pasó en un proyecto real por subir en paralelo a Figma.
Reglas del lote:
- Una variante por asset salvo que el usuario pida opciones.
--count=3triplica el costo. - Si una imagen falla, sigue con las demás y repórtala al final. No reintentes en bucle.
- Ante error de cuota o facturación, detén el lote completo e informa — el resto de reintentos también se cobrarían.
- Al terminar: reporta cuántas se generaron, cuántas fallaron y el costo real aproximado.
Salida
Todo cae en ./nanobanana-output/ del directorio actual. Al terminar: lista la carpeta, muestra el archivo más reciente y ofrece variantes.
Iteración
- "otra vez" / "dame opciones" →
--count=3 - "más [adjetivo]" → ajusta el prompt y regenera
- "edita esta" →
/edit nanobanana-output/archivo.png 'ajuste' - "otro estilo" → agrega
--styles="..."
Prompts
- Específico: estilo, ánimo, color, composición.
- Agrega
no textsi no quieres tipografía renderizada — el modelo la deforma con frecuencia. - Ancla el estilo: "editorial photography", "flat illustration", "3D render", "watercolor".
- Menciona el encuadre: "wide banner", "square thumbnail", "vertical story".
Problemas
| Síntoma | Causa |
| Pide método de auth | Falta security.auth.selectedType en ~/.gemini/settings.json |
| "not running in a trusted directory" | Agrega --skip-trust |
| Extensión no encontrada | Instálala interactivamente (ver arriba) |
| Cuota excedida | Reporta al usuario; no reintentes en bucle |
| Falla la generación | Revisa el prompt por violación de políticas; simplifica |
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

