CommunityImagengithub.com

imagen-infographic

Diseña y renderiza infografías al estilo NotebookLM (banda de titular, paneles modulares numerados, iconos o minigráficos sencillos, pie de fuentes) e ilustraciones planas de escenas de un desarrollador trabajando con una idea, como PNG con la CLI de Imagen. Las especificaciones se revisan para un solo mensaje, datos con fuente, moderación y contraste WCAG antes de generar la imagen, y luego se lee la imagen resultante para verificar que cada etiqueta esté bien escrita.

¿Qué es imagen-infographic?

Esta skill convierte la creación de infografías y escenas ilustrativas en un proceso repetible y robusto, orientado a desarrolladores y creadores de contenido técnico. Está diseñada para funcionar con la CLI de Imagen (gemini-imagen) y aprovecha el plugin `imagen-diagrams` para temas y paletas. El flujo de trabajo es: 1) Encontrar el mensaje clave, 2) Escribir una especificación en Markdown con frontmatter YAML, 3) Pasar un lint que verifica restricciones de diseño (un solo mensaje, datos con fuente, simplicidad, contraste de accesibilidad 4.5:1 y prohibición de tipos de gráfico inadecuados), 4) Renderizar la infografía como PNG, y 5) Un 'gate' de control de calidad que lee la imagen generada y comprueba que el titular, etiquetas de panel y pie de fuentes aparezcan escritos correctamente, reintentando hasta 3 veces. La skill también permite generar 'escenas': ilustraciones planas de una persona (por ejemplo, un desarrollador frustrado o aliviado) en el contexto del artículo, opcionalmente con un diagrama en pantalla, sin texto propio y sin el gate de revisión. Es ideal para resúmenes visuales de una página, pósteres explicativos, newsletters o para dar un toque humano a artículos técnicos. No debe usarse para diagramas de flujo o arquitectura (que corresponden a `imagen-diagrams`) ni para fotos o portadas (que usan `image-gen`).

Compatible con✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/SpillwaveSolutions/imagen-infographic/tree/HEAD

Installed? Explore more Imagen skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace imagen-infographic?

Una buena infografía convierte información compleja en algo claro, memorable y escaneable en segundos. Prioriza la comprensión sobre la decoración. Esta skill lo convierte en un proceso repetible: escribe una especificación, revísala, renderízala y verifica el texto que ha vuelto.

Las reglas de diseño (léelas antes de escribir una especificación)

  1. Un mensaje claro. Debes poder resumir toda la pieza en una oración. Escribe primero esa oración, como message. El headline comunica la conclusión, para que el lector la capte en unos cinco segundos. Dos ideas en competencia requieren dos infografías o una sección de artículo.

  2. Datos precisos y creíbles. Usa solo hechos del material original. Cada número lleva una fuente, y el pie de página lista las fuentes. Una escala engañosa o un dato sesgado destruye la confianza más rápido que ningún gráfico.

  3. Una audiencia nombrada. Adecúa la complejidad y el vocabulario a lo que ese lector ya sabe. Una visión general genérica no ayuda a nadie.

  4. Jerarquía y flujo. El tamaño, el contraste y la ubicación guían la mirada: el titular, luego las etiquetas de los paneles, luego frases cortas. Usa una secuencia de arriba a abajo o una cuadrícula modular clara.

  5. El visual adecuado para los datos.

    • bar para comparaciones.
    • line para tendencias a lo largo del tiempo.
    • timeline o process para secuencias.
    • diagram para relaciones.
    • comparison para comparaciones lado a lado.
    • stat para un solo número grande.
    • icons o checklist para una lista breve.

    Sin 3D, sin gráficos circulares con muchas porciones, sin decoración que no tenga significado. El lint rechaza pie, donut, radar y 3d.

  6. Sencillez y moderación. Mantén las etiquetas cortas y las frases aún más cortas. Usa 2 o 3 fuentes y de 2 a 4 colores, con amplio espacio en blanco. Si una sección necesita un párrafo, pertenece al artículo, no a la infografía.

  7. Accesibilidad. El contraste del texto debe ser al menos 4.5:1, y el script lo verifica. Nunca uses el color como la única forma de distinguir elementos: etiquétalos. La imagen debe seguir siendo legible en un teléfono.

  8. Consistencia. Usa un estilo de icono, un sistema tipográfico y un espaciado uniforme. La indicación lo pide, así que no lo contradigas con instrucciones mixtas.

Modos de fallo. Revisa la especificación para detectar lo siguiente antes de renderizar:

  • sobrecarga de información o demasiados temas
  • decoración bonita pero sin significado
  • jerarquía débil que obliga al lector a buscar el mensaje
  • gráficos incorrectos o distorsionados
  • fuentes faltantes
  • texto ilegible

Flujo de trabajo

  1. Encuentra el mensaje. Lee la fuente (una sección de artículo, un informe, notas). Escribe la oración única message y elige la audience. Si no puedes escribir una oración, el material no está listo para una infografía.
  2. Escribe la especificación, un archivo Markdown con frontmatter YAML. El formato y un ejemplo completo están en references/spec-format.md. Usa de 3 a 6 paneles, cada uno con una etiqueta corta, un tipo de visual y como máximo 3 frases o unos pocos puntos de datos.
  3. Pásalo por el lint:
    python3 ~/.claude/skills/imagen-infographic/scripts/infographic.py lint SPEC.md --theme arctic-fox
    
    El lint aplica los límites de las reglas 1, 2, 5, 6 y 7, e imprime una línea por problema. Corrige la especificación, no los límites: cada límite existe porque las infografías anteriores fallaron sin él.
  4. Renderiza:
    python3 ~/.claude/skills/imagen-infographic/scripts/infographic.py render SPEC.md -o out.png --theme arctic-fox
    
    • --theme acepta cualquier id de tema de imagen-diagrams, y completa la paleta y el estilo. También puedes definir palette: en la especificación.
    • La relación de aspecto predeterminada es 3:4, un póster vertical. Usa aspect: "16:9" para una diapositiva.
    • El script escribe out.prompt.txt junto a la imagen para que puedas ver lo que se pidió. Usa --dry-run para imprimir la indicación y no gastar crédito.
  5. La compuerta. El script vuelve a leer la imagen con imagen analyze. El titular, cada etiqueta de panel y el pie de fuentes deben aparecer, escritos correctamente. El script lo intenta hasta 3 veces (--attempts) y elimina la imagen que falla, por lo que un fallo es un hueco visible, no una imagen rota.
  6. Mira el resultado tú mismo. Abre el PNG y compruébalo con las ocho reglas. La compuerta solo verifica la ortografía. No puede decirte si la jerarquía es débil o si un gráfico está fuera de escala. Si la imagen no cumple una regla, cambia la especificación (menos palabras, un visual diferente) y renderiza de nuevo.

Cuando insertes la imagen en un artículo, ponle un pie de foto y un párrafo corto que describa lo que muestra. Un lector que no pueda ver la imagen debe recibir igualmente el mensaje.

Escenas: una persona trabajando con la idea

Una escena es una ilustración plana de una persona en el momento que describe el artículo: un desarrollador rascándose la cabeza ante un largo registro de chat, aliviado cuando una prueba pasa, esbozando un plan en una pizarra. Las escenas hacen que una pieza técnica sea personal. Una escena puede mostrar uno de los diagramas del artículo en un monitor o pizarra, lo que vincula a la persona con el concepto. Usa aproximadamente una escena por artículo, en un momento de frustración o alivio.

python3 ~/.claude/skills/imagen-infographic/scripts/infographic.py scene SCENE.md -o scene.png --theme arctic-fox

Una especificación de escena es un bloque corto de frontmatter (consulta references/spec-format.md): person (quién, haciendo qué, sintiendo qué), setting, un diagram opcional (una ruta PNG relativa a la especificación, enviada como imagen de referencia), theme o palette, y aspect (por defecto 16:9). Las escenas no llevan texto propio, por lo que no tienen compuerta de texto. Míralas cada una: la emoción debe leerse de un vistazo, y la imagen no debe tener título, pie de foto ni globo de diálogo.

Requisitos

  • La CLI imagen (gemini-imagen) en el PATH, con una clave funcional.
  • El plugin imagen-diagrams, para --theme y la conmutación por error del motor en su generate.py. Sin el plugin, el script llama a imagen generate directamente, y debes definir palette: en la especificación.
  • Python 3 con PyYAML.

Ejecuta infographic.py --self-test después de cambiar el script. Verifica las reglas de lint y contraste sin hacer ninguna llamada de imagen.

Skills relacionados