Communitygithub.com

visual-story

Narración visual para mostrar cosas complejas a las personas: una película explicativa en movimiento sobre un gran lienzo con cámara, escenas y subtítulos; un mapa interactivo de un proceso o sistema; una presentación tipo pitch con microanimaciones, transiciones y un PDF estático; sus versiones para teléfono, exportación a MP4 con precisión de fotogramas, publicación en un subdominio y un código QR. Úsalo cuando el usuario solicite un video explicativo animado, un recorrido animado de un proceso, "animar cómo funciona nuestro sistema", un mapa interactivo del sistema para hacer zoom, una presentación con transiciones y un PDF, "hacer un video a partir de esta animación" o "hacer que funcione en teléfonos", incluso si no menciona "movimiento" o "presentación". NO lo uses para presentaciones de diapositivas simples sin escenas ni cámara, un diagrama estático único, páginas de aterrizaje y propuestas de venta, o video generado por IA.

¿Qué es visual-story?

Visual Story es una habilidad especializada para crear narrativas visuales complejas dirigidas a audiencias humanas. Su propósito es transformar ideas, procesos o sistemas intrincados en experiencias visuales claras y atractivas, ya sea a través de películas explicativas animadas, mapas interactivos o presentaciones tipo pitch. La habilidad se basa en un flujo de trabajo estructurado que enfatiza la iteración y la aprobación del usuario para evitar retrabajos: primero se define el objetivo y se recopilan requisitos, luego se elabora un guion en tabla, se desarrolla un piloto para fijar el estilo visual, y finalmente se construye la pieza completa en lotes pequeños, mostrando cada uno para obtener la aprobación del usuario. Soporta múltiples formatos de salida: desde animaciones interactivas en el navegador con cámara y escenas, hasta videos MP4, PDFs estáticos con transiciones, versiones responsivas para teléfonos y tablets, y publicación en un subdominio con código QR. Su uso está orientado a casos donde se necesita "mostrar cómo funciona algo" de manera visual y dinámica, evitando aplicarlo a presentaciones de diapositivas planas, diagramas estáticos o videos generados por IA. La habilidad proporciona runbooks específicos para cada tipo de tarea (película, mapa, presentación, exportación, publicación, control de calidad) y reglas de estilo para garantizar coherencia visual y narrativa.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/smixs/visual-story/tree/HEAD

Preguntar en tu IA favorita

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

Documentación

Visual story

Muestra cosas complejas como imágenes: escena por escena, a gran escala, con movimiento que explica en lugar de decorar. El pie de foto dice qué está pasando; el lienzo lo muestra. Cada lote de trabajo termina con un fotograma mostrado al usuario y su "sí".

Lo que estás haciendo → qué runbook abrir

TareaRunbook
Película explicativa: escenas en un lienzo, cámara, subtítulos, mapa "esquema completo"references/motion-film.md
Mapa interactivo de un proceso o sistema con saltos entre nodosreferences/scheme.md
Presentación tipo pitch con microanimaciones, transiciones y un PDFreferences/deck.md
Charla de conferencia simple sin escenas ni cámarausa un flujo de trabajo de presentación de diapositivas normal; toma prestadas las reglas de legibilidad de deck.md
Exportar una película o un mapa a MP4references/video-export.md
Versiones para teléfono y tabletreferences/responsive.md
Publicación, subdominio, contraseña, QRreferences/publish.md
Verificación visual: fotogramas por URL, hojas de contacto, lista de verificaciónreferences/qa.md
Reglas de estilo: color, tipo, movimiento, densidadreferences/taste.md
Trabajos de referencia para copiar un esqueletoreferences/examples.md

Abre taste.md, examples.md y el runbook correspondiente antes de la primera línea de código. Abre qa.md antes de la primera presentación.

¿Película o mapa? Una película es una historia que se desarrolla en el tiempo, donde un presentador guía al espectador escena por escena. Un mapa es una gran imagen que el espectador explora por su cuenta. "Animar nuestro proceso para un seminario web" es una película; "un mapa del sistema para explorar" es un mapa. Si no estás seguro, haz una pregunta.

Orden de trabajo para cada tipo

  1. Objetivo en palabras del usuario, luego preguntas. Pregunta en un solo lote, con la opción recomendada primero, y solo lo que aún no esté respondido: qué referencia ("como la última vez"), cómo se muestra (el presentador hace clic / reproducción automática / video / PDF), estilo (el sitio web del producto), idioma, datos (ficticios o la fuente del usuario), fecha límite y pantalla.
  2. Guion como tabla — escenas o diapositivas: número, título, una línea de significado. Espera el "sí".
  3. Piloto. Una escena o una o dos diapositivas, completamente terminadas: imagen, movimiento, subtítulos. Fotogramas → mostrar → espera el "sí". Por qué: un estilo encontrado en el piloto se transfiere a todo lo demás; un estilo encontrado en la escena doce significa rehacer doce escenas.
  4. Lotes de 2–3 escenas o diapositivas; muestra cada lote y espera.
  5. Monta el conjunto: navegación, mapa de esquema completo o vista general, diseños para teléfono, publicación, QR, PDF o video — lo que se haya solicitado.

Fecha límite en menos de un día: un piloto y un "sí", el resto en un solo lote; verifica los fotogramas solo en los tamaños en que se mostrarán (la pantalla de difusión, más los teléfonos si los espectadores reciben un enlace).

Antes de decir "listo"

  • Se han tomado y revisado los fotogramas en los tamaños de visualización de qa.md; los defectos se corrigieron en un solo lote.
  • Si se solicitó publicación: la dirección en vivo sirve la nueva versión (?v=NN), y zbarimg lee el código QR.
  • Si se solicitó un PDF o video: el archivo se abre y revisa página por página o fotograma por fotograma.
  • El usuario ha visto el resultado y ha respondido.
  • Tus propias capturas de pantalla, sesiones de navegador y procesos de servidor están limpias (detén los servidores por su pid).

Errores comunes

  • Construir todo y mostrarlo al final → el usuario cambia el estilo y rehaces todo. Trabaja en lotes.
  • Hacer las cosas pequeñas: diez etiquetas diminutas en el lienzo en lugar de una idea grande. Imagen grande, código pequeño.
  • Cubrir con texto: "Escanea con tu teléfono" debajo de un código QR, "aún en crecimiento", "puedes…", sugerencias de gestos. Lo que esté claro sin palabras se queda sin palabras.
  • Decorar: franjas de acento de color en los bordes de las tarjetas, parpadeos, "solo bonito". El movimiento explica una transición o no existe.
  • Un número sin un sustantivo y un momento ("8 tarjetas") → el espectador no sabe qué está viendo.
  • Verificar "leyendo el código" sin un fotograma en el tamaño correcto → en un teléfono todo se desmorona.

Skills relacionados