¿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)
-
Un mensaje claro. Debes poder resumir toda la pieza en una oración. Escribe primero esa oración, como
message. Elheadlinecomunica 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. -
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.
-
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.
-
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.
-
El visual adecuado para los datos.
barpara comparaciones.linepara tendencias a lo largo del tiempo.timelineoprocesspara secuencias.diagrampara relaciones.comparisonpara comparaciones lado a lado.statpara un solo número grande.iconsochecklistpara una lista breve.
Sin 3D, sin gráficos circulares con muchas porciones, sin decoración que no tenga significado. El lint rechaza
pie,donut,radary3d. -
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.
-
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.
-
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
- Encuentra el mensaje. Lee la fuente (una sección de artículo, un informe, notas). Escribe la oración única
messagey elige laaudience. Si no puedes escribir una oración, el material no está listo para una infografía. - 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. - Pásalo por el lint:
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.python3 ~/.claude/skills/imagen-infographic/scripts/infographic.py lint SPEC.md --theme arctic-fox - Renderiza:
python3 ~/.claude/skills/imagen-infographic/scripts/infographic.py render SPEC.md -o out.png --theme arctic-fox--themeacepta cualquier id de tema de imagen-diagrams, y completa la paleta y el estilo. También puedes definirpalette: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.txtjunto a la imagen para que puedas ver lo que se pidió. Usa--dry-runpara imprimir la indicación y no gastar crédito.
- 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. - 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
--themey la conmutación por error del motor en sugenerate.py. Sin el plugin, el script llama aimagen generatedirectamente, y debes definirpalette: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.