keynote-visual-explainer

Keynote Visual Explainer

Convierte un texto en un gráfico explicativo de alta calidad que permita entender de un vistazo el mecanismo, las relaciones y las diferencias. La orientación visual se inspira en la simplicidad, precisión y contención de las presentaciones de Apple Keynote, pero no copia logotipos, ilustraciones oficiales o páginas específicas de Apple. La precisión está antes que lo estético; la estructura, antes que el detalle.

Cuándo usarlo

• El usuario pide "que continúe el estilo de Apple Keynote", "ilustra este texto", "explica este concepto", "dibuja la arquitectura del sistema", "compara tres rutas".
• Es adecuado para: principios de producto, agentes de IA, sistemas operativos, rutas técnicas, flujos de servicio, modelos de negocio, explicaciones metafóricas.
• Ante una solicitud clara de una imagen explicativa estática, genera directamente la imagen (si el entorno actual soporta generación de imágenes); no te limites a devolver un prompt de dibujo para que el usuario lo genere. Si el entorno solo admite prompts, proporciona un prompt completo y reutilizable, indicando honestamente la limitación.
• No debe usarse forzadamente para planos de ingeniería precisos, gráficos estadísticos exactos, capturas de pantalla reales de UI o materiales de marca con normas estrictas. Para gráficos/planos exactos, elige una herramienta de dibujo que permita verificar la estructura.

Principios clave de diseño (prioridad de mayor a menor)

1. Corrección del contenido: Distingue fielmente participantes, recursos, permisos, flujos, límites y dependencias; no inventes lógica solo por simetría.
2. Mensaje único: El espectador debe identificar la conclusión principal en tres segundos. Comprime el texto original en 1 relación central + 2-6 elementos; para diagramas de arquitectura grandes, permite 5-9 nodos agrupados.
3. Relaciones visibles: Expresa las relaciones mediante el espacio, la forma, las trayectorias y las flechas de causa-efecto, no con grandes cantidades de texto aclaratorio que remedien una estructura confusa.
4. Contención y espacio: Suficiente espacio en blanco, pocos elementos clave, un recorrido de lectura claro; rechaza la decoración sin propósito.
5. Coherencia de serie: Los mismos personajes, componentes, flechas, tarjetas y semántica de color se mantienen consistentes en un mismo conjunto de imágenes.

Flujo de trabajo

1. Primero, convierte el texto en estructura

Confirma internamente:

• ¿Cuál es la única conclusión que se quiere explicar?
• ¿Qué entidades hay (ej.: usuario, guía, tienda; Trigger, Router, Worker)?
• Entre las entidades, ¿hay flujo, control, pertenencia, ramificación condicional o comparación paralela?
• ¿Qué detalles cambiarían el significado original (límites de seguridad, de quién provienen los recursos, quién toma decisiones, quién ejecuta, si se actualiza dinámicamente)? Estos deben conservarse.
• ¿Qué es solo un ejemplo, adorno emocional o retórica? Puede omitirse.

No conviertas todos los párrafos en imágenes palabra por palabra. Prioriza la abstracción, pero no dibujes dos mecanismos diferentes con el mismo flujo.

2. Decide la composición según la relación que el lector necesita entender

Pregúntate primero qué necesita entender el lector: "¿cómo ocurre paso a paso?", "¿quién es responsable de qué?" o "¿en qué se diferencian varios enfoques?". Elige un patrón de composición principal. Ejemplos concretos en Patrones de composición:

• Una cadena: Entrada → Decisión/transformación central → Salida (flujo, transferencia de poder).
• Comparación de dos/tres columnas: Base visual compartida, solo se destacan las reglas diferentes o el control.
• Arquitectura en capas: Cuando el lector necesite distinguir interacción, coordinación y ejecución, prioriza la disposición por capas según responsabilidades. Dale el mayor peso visual al rol de coordinación central; coloca las unidades de ejecución paralela en la misma capa; sitúa las capacidades compartidas a un lado o en la capa inferior. Lee Ejemplo de arquitectura en capas.
• Cambio antes/después: Pasado vs. presente, mostrando la adición o eliminación de una relación clave.
• Curva/coordenadas 2D: Ejes claros, curvas, pocos puntos de anclaje; la posición debe coincidir con la dirección del texto original.
• Metáfora cotidiana: Escenas como cocina, agencia de viajes, centro comercial; la escena sirve al mecanismo, no se hace un cartel de historia de personajes.

Formato por defecto: Apaisado 16:9, compatible con PPT/Keynote; si el usuario especifica otra relación, se respeta.

Antes de generar, escribe claramente la posición relativa en el lienzo: dónde mirar primero, en qué capa está cada rol, qué elementos son del mismo nivel, dónde se colocan las capacidades auxiliares. Incorpora estas posiciones y relaciones de tamaño en el prompt. Las flechas solo deben complementar direcciones significativas, retornos o límites; evita poner un icono del mismo tamaño para cada término técnico.

3. Elige una imagen de referencia como entrada real para la generación

1. Elige la imagen. Prioriza la imagen especificada por el usuario o la última imagen generada que el usuario haya seleccionado en esta conversación. Si no se especifica, elige una imagen de muestra integrada del mismo tipo: para arquitectura en capas usa Imagen de muestra de arquitectura en capas, para comparación de múltiples opciones usa Imagen de muestra de tres columnas, para conceptos de escena única usa Imagen de muestra minimalista, para flujos de relación usa Imagen de muestra de flujo de cocina. Si la disposición no coincide, solo toma como referencia su iluminación, material y paleta de colores.
2. Pasa la imagen al generador. Primero visualiza la imagen, luego adjunta la imagen real como imagen de referencia o de edición en la herramienta de generación, usando archivos, archivos adjuntos de imagen o imágenes ya generadas según lo que soporte la herramienta. Mencionar el nombre del archivo en el prompt no equivale a pasar la imagen. Si la herramienta actual solo acepta texto, indica que en esta ocasión se usará una aproximación textual y especifica las características concretas según las Especificaciones visuales.
3. Diferencia entre continuación visual y sustitución de contenido. Para modificaciones parciales de una misma imagen, usa la imagen original como destino de edición, especificando claramente la posición, proporción, forma, iluminación y composición que deben mantenerse fijas. Para generar una imagen para un nuevo tema, usa la imagen de muestra como referencia de estilo; solo hereda la disposición si la estructura es adecuada. Decide las entidades, texto, número de estaciones de trabajo y flechas según el nuevo tema; no heredes contenido antiguo de la imagen de muestra.

Cuando no se especifique un estilo visual, elige de las Especificaciones visuales las características que coincidan con la imagen de referencia:

• Fondo: Blanco porcelana / blanco niebla, con un gradiente muy sutil de azul grisáceo frío, iluminación de estudio suave, sin textura noticeable.
• Sujeto principal: 2.5D simple / 3D suave, cerámica mate blanco crema, plástico esmerilado, poco metal anodizado; formas redondeadas, bordes precisos, reales pero sin hiperrealismo.
• Personajes: Sin rasgos faciales, material de porcelana blanca, figuras redondeadas. Cuando el reparto de roles es el mensaje principal, prioriza formas reconocibles para diferentes responsabilidades (ej.: usuario, coordinador, estación de trabajo); los dispositivos, recursos y almacenamiento usan objetos correspondientes. Solo usa metáforas cuando coincidan con las responsabilidades reales.
• Paleta de colores: Azul niebla, gris claro, blanco neutro como base; azul brillante solo para resaltar la ruta principal; verde menta para éxito/permiso; naranja cálido/rojo suave solo para riesgo/excepción.
• Composición: Alineación estricta, tamaño y perspectiva uniformes, siluetas fácilmente reconocibles, bases/tarjetas de esquinas redondeadas, sombras pequeñas y suaves contra el suelo.
• Líneas: Flechas sólidas para flujo; flechas discontinuas para estado/condición; evita que las flechas atraviesen objetos o se crucen múltiples veces.
• Estilo general: Elegante, tranquilo, amigable, con sensación técnica, contención editorial. Como una diapositiva de presentación cuidadosamente maquetada, no como un collage de manual de instrucciones.

4. Controla el texto

Prioriza las restricciones explícitas del usuario:

• Si el usuario dice "sin texto" / "solo gráficos": No aparezcan títulos, etiquetas, letras, números, logotipos ni marcas de agua. Explica solo con formas de objetos, relaciones espaciales y flechas.
• Si el usuario no pide que no haya texto: Mantén un título principal y las etiquetas necesarias. En los diagramas de arquitectura de presentación, se permite una breve descripción de responsabilidad junto a la capa clave o el rol central (ej.: "Recibir pedidos · Asignar · Devolver"); esta línea debe ayudar al lector a entender la responsabilidad. Conserva términos necesarios como A2UI, Intelligent UI, Router, Worker.
• Cuando el usuario proporciona un texto largo: No pongas el párrafo completo en la imagen. El texto es solo para desambiguación necesaria, no el vehículo principal.
• Si la herramienta de generación tiene poca estabilidad para el texto en español, reduce aún más el número de caracteres, usa iconos y anotaciones editables post-generación; no sacrifiques la precisión semántica.

5. Revisa la estructura antes de generar, verifica la imagen después de generarla

• Prueba de 3 segundos: ¿Se pueden reconocer los participantes clave y la relación principal sin leer el texto explicativo?
• Prueba de comparación: ¿Son visibles en la imagen los puntos que realmente diferencian cada opción?
• Prueba de causalidad: ¿La dirección de las flechas es correcta? ¿Los cambios de condición, los límites de permisos y el sujeto de control están dibujados correctamente?
• Prueba de jerarquía: Cuando la imagen se reduce al tamaño de una miniatura de presentación, ¿aún se reconoce el único centro visual y se distinguen la capa de interacción, la de ejecución y las capacidades auxiliares? ¿El título o los módulos auxiliares le roban peso al protagonista?
• Prueba de eliminación: Si se elimina cualquier elemento decorativo, ¿la imagen queda más limpia? Si es así, elimínalo.
• Prueba de consistencia: ¿El mismo personaje tiene la misma forma en diferentes viñetas? ¿El mismo color tiene el mismo significado?
• Prueba de restricciones: ¿Se respetan estrictamente la proporción, la ausencia de texto, el número de nodos y los términos proporcionados por el usuario?

Si el resultado es demasiado complejo, prioriza la reducción de objetos, etiquetas, capas de tarjetas y escenas secundarias; no te limites a reducir el tamaño de la fuente o comprimir los espacios. Al revisar la imagen final, verifica una por una el punto de inicio, el punto final, la dirección y el número de ramificaciones de cada conexión clave, y examina el texto dentro de la imagen. Si encuentras errores en la relación de dependencia, la cardinalidad de las ramas o el texto, corrige antes de entregar. Si se solicita mantener el estilo visual, coloca la imagen final junto a la imagen de referencia seleccionada y verifica la temperatura de color del fondo, el área de cobertura del azul, los contornos y proporciones de los personajes, la posición del título y el peso visual de la información auxiliar. Si se desvía, conserva la imagen de referencia para hacer ediciones específicas.

Esqueleto del prompt de generación de imágenes

Al generar imágenes, rellénalo dinámicamente según la tarea. No muestres este prompt interno cuando el usuario no lo necesite.

Crea UNA ilustración explicativa 3D editorial pulida al estilo Apple Keynote,
apaisada 16:9, sobre un fondo blanco porcelana cálido con un gradiente
azul frío casi imperceptible. Usa formas minimalistas de arcilla suave y
cerámica mate, geometría redondeada precisa, iluminación de estudio elegante,
sombras delicadas, amplio espacio negativo y una paleta contenida de marfil,
gris pizarra y azul suave.

AFIRMACIÓN PRINCIPAL: [conclusión en una frase].
IMAGEN DE ENTRADA: [imagen de referencia adjunta o destino de edición;
qué rasgos visuales conservar, qué contenido reemplazar y qué geometría
está fija].
COMPOSICIÓN: [orden de lectura, sujeto focal y tamaño relativo,
colocación de capas o grupos, posición de las capacidades auxiliares].
ENTIDADES VISUALES: [roles esenciales y la forma reconocible que expresa
cada uno].
RELACIONES: [origen, destino, dirección y significado uno a uno/uno a
muchos de cada conexión necesaria; agrupa elementos relacionados antes
de añadir flechas].
DISTINCIONES CRÍTICAS: [los hechos que no deben confundirse visualmente].

Narrativa visual sobre texto. Cada objeto tiene un propósito semántico.
Mantén las siluetas instantáneamente reconocibles. Perspectiva, escala,
iluminación, diseño de flechas y semántica de color consistentes en toda
la imagen.

POLÍTICA DE TEXTO: [absolutamente sin texto / etiquetas exactas y
descripciones cortas de rol].

EVITAR: paneles informativos recargados, texto largo, relleno decorativo,
iconos excesivos, glassmorfismo demasiado brillante, neón, hologramas de
ciencia ficción, robots azules genéricos, bordes pesados, paneles
abarrotados, insignias aleatorias, escenas redundantes repetidas,
logotipos, marcas de agua y flechas confusas.

Manejo de situaciones difíciles

• Diagrama de arquitectura profunda: Primero determina si se habla de la división de roles o del flujo de eventos. Fusiona los detalles de implementación de una misma responsabilidad; solo desarrolla los permisos, estados o rutas de excepción que cambiarían la comprensión del lector.
• Algo que se puede explicar en una frase visualmente: No hagas un gran panel informativo de múltiples recuadros; es mejor una escena unificada o una relación de tres nodos.
• Mecanismo técnico + metáfora cotidiana: Conserva las relaciones técnicas reales; la metáfora solo sirve para mapear roles. No cambies el protocolo, el poder de ejecución o los límites de recursos por conveniencia de la metáfora.
• Serie de imágenes: Si se necesitan varias imágenes consecutivas, prioriza fijar los personajes/color principal/ángulo cenital/expresión de flechas, y reemplaza las entidades con la misma plantilla; no reinventes el estilo en cada imagen.

Referencias

Lee según sea necesario:

• references/visual-system.md: Formas, materiales, colores, tipografía, modos de fallo comunes.
• references/composition-patterns.md: Métodos de selección de estructura para diferentes relaciones de información y tres ejemplos de temas reales.

Las imágenes de muestra incluidas en el skill se utilizan para transmitir características visuales. Los términos técnicos y las conexiones en las imágenes solo se aplican a sus respectivos temas. La composición en capas se puede usar junto con Ejemplo de arquitectura en capas.