Communitygithub.com

animación-isométrica-svg

Diagramas de arquitectura isométrica generados como SVG animado mediante un script de construcción. Úsalo cuando se solicite un diagrama isométrico o 2.5D de sistema, pipeline o arquitectura, una ilustración animada en SVG para un sitio web, o para revisar un diagrama construido de esta manera.

¿Qué es animación-isométrica-svg?

Esta habilidad automatiza la creación de diagramas de arquitectura isométrica (2.5D) completamente animados, generados como SVG autocontenido a partir de un script de construcción (`node build.mjs`). Elimina el dibujo manual: cada elemento (tarjetas, plataformas, rutas, etiquetas) se define en unidades de plano y se proyecta a isométrica, produciendo un `diagram.svg` con animaciones CSS keyframes que funciona como una imagen `<img>` simple, más un `preview.html` para vista previa. Está diseñada para agentes de IA como Claude Code, Cursor o Codex, y sigue principios rigurosos de geometría, diseño, animación y auditoría automatizada para garantizar diagramas limpios, legibles y profesionalmente animados. El flujo de trabajo incluye: definir la historia del diagrama, acordar referencias visuales, construir estáticamente (plataformas, nodos, rutas, etiquetas), añadir movimiento (luces que viajan, nodos que se iluminan) y exportar. El tono se basa en estados (grises progresivos para indicar progreso) y colores para indicar actividad, con animaciones que narran el flujo una vez por bucle (aprox. 20 s). La habilidad también audita automáticamente la disposición para detectar superposiciones y esquinas apretadas, y gestiona el coste de renderizado optimizando máscaras, filtros y keyframes.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/413ZERO/isometric-svg-animation/tree/HEAD

Preguntar en tu IA favorita

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

Documentación

Animación isométrica SVG

Un script (node build.mjs) coloca cada forma en unidades de plano, lo proyecta a isométrica y escribe un diagram.svg autocontenido (con keyframes CSS, que se reproduce como un <img> simple) y un preview.html (el mismo SVG incrustado y escalado a la ventana). Nada se dibuja a mano: cada corrección es un cambio de código y una reconstrucción.

Antes de escribir el script, lee references/generator.md: sus secciones y el código central para proyección, tarjetas, texto en suelo, rutas, keyframes, plataformas y ensamblaje.

Pasos

  1. Historia. Lee la documentación del propio sistema, luego escribe la historia del diagrama en una línea: qué entra, qué lo procesa, qué impulsa el trabajo, qué sale. El flujo se lee de abajo a la izquierda a arriba a la derecha. Terminado cuando cada etapa de la línea es un nodo que se puede nombrar en una a tres palabras y el usuario está de acuerdo con la línea.
  2. Resumen. Obtén una imagen de referencia para la sensación (grosor de línea, densidad, estilo de plataforma); cuando el usuario no tenga ninguna, muestra los diagramas en references/examples.md y deja que elija. Define el tema, la relación de aspecto (1.6:1 encaja en una ventana del navegador) y dónde vivirá el SVG. Terminado cuando los cuatro están en el comentario de cabecera del script.
  3. Construcción estática. Plataformas, nodos, rutas, etiquetas; sin movimiento todavía. Terminado cuando la auditoría de la construcción no imprime superposiciones ni esquinas apretadas, y el usuario ha aprobado una captura de pantalla del diseño.
  4. Movimiento. Añade el bucle. Terminado cuando un bucle reproduce la historia una vez, en orden, y el movimiento reducido muestra el estado final.
  5. Exportación. Consulta Exportación abajo.

Cada ronda de revisión: toma las notas del usuario una a una, responde cualquier pregunta antes de cambiar algo, copia la construcción actual en versions/ antes de un cambio grande, y responde con una captura de pantalla. Cuando el usuario elige entre nombres o iconos, renderiza las opciones lado a lado.

Principios

Contenido

  • Un flujo, pocos detalles. Cada nodo se nombra por lo que realmente hace; cuando un nombre se disputa, di cuál es preciso y por qué, luego deja que el usuario elija.
  • Cada etiqueta se lee por sí sola para un extraño. Una etiqueta que necesita explicación se reescribe o se elimina.
  • Una pila de placas solo para algo que realmente es una pila (las páginas de un informe); cualquier otro nodo es una sola tarjeta.
  • Los caminos laterales honestos se quedan dibujados (entradas que saltan una etapa), incluso cuando cuestan espacio.
  • Los sistemas externos se sientan en plataformas con el mismo relleno que los internos; solo un borde discontinuo los marca como externos.
  • Las entradas sueltas yacen planas en el suelo, sin plataforma debajo.

Geometría

  • Unidades de plano en todas partes: a corre a lo largo del flujo (pantalla arriba-derecha), b a través (pantalla abajo-derecha), z hacia arriba. Posiciones, tamaños, espacios y rutas están en unidades de plano; los píxeles de pantalla existen solo dentro de la proyección.
  • Una tarjeta es una cara superior más una banda lateral (el casco de sus contornos superior e inferior) con un trazo en el contorno exterior, y la cara se encuentra con el grosor sin línea. Las plataformas trazan su cara superior en su lugar, ya que esa cara yace en la cuadrícula.
  • Un grosor para cada tarjeta y pastilla de módulo. Las pastillas de nombre yacen planas sin grosor.
  • Pinta por capas (suelo, plataformas, cables, objetos, etiquetas), ordenadas por profundidad dentro de cada una.

Texto

  • Cada etiqueta yace en el plano del suelo con su línea base a lo largo de a. Los glifos se convierten en trazados en tiempo de construcción, por lo que el SVG se renderiza igual como <img> en cualquier lugar y no carga ninguna fuente.
  • Los tamaños provienen de una pequeña tabla (pastilla, etiqueta, pequeño, pie de foto, título). Los títulos de plataforma son mayúsculas espaciadas monoespacio.

Diseño

  • Una cuadrícula de suelo a 2 unidades. Los bordes de plataforma se alinean hacia afuera a las líneas de la cuadrícula; los espacios entre plataformas y entre filas son celdas enteras; una línea troncal compartida corre en una línea de cuadrícula centrada en su espacio.
  • Las plataformas se dimensionan solas: cada nodo y etiqueta registra su huella con su plataforma, y la plataforma es esa caja más un relleno uniforme, alineado a la cuadrícula. Las plataformas en una fila comparten sus bordes enfrentados.
  • Un título de plataforma se sitúa tan lejos del borde izquierdo como del borde frontal (medido hasta el pie de sus mayúsculas), alineado a la izquierda con el contenido.
  • La cuadrícula se extiende más allá de cada borde del marco y se desvanece a través de una elipse con la relación de aspecto del marco, por lo que la imagen no tiene un borde duro. El fondo es transparente.
  • Cada construcción imprime una auditoría: los cuatro márgenes de cada plataforma, los espacios entre plataformas, las superposiciones etiqueta × etiqueta y etiqueta × tarjeta, y las esquinas demasiado apretadas para su radio. Léela antes de mostrar cualquier cosa.

Líneas

  • Cada conexión es un trazado continuo: ortogonal, con giros de cuarto de vuelta de un radio fijo, de modo que las rutas que comparten un tramo lo comparten exactamente y una rama sale de su tronco a lo largo de una tangente. Dibuja las rutas primero y los nodos encima; el resultado no tiene muñones, bifurcaciones ni espacios.
  • Los tipos de línea se diferencian por patrón: sólido para el flujo, discontinuo para un raíl externo, puntos redondos para acceso de solo lectura.

Tono

  • El tono es estado. Solo neutros (R = G = B). Claro = aún no alcanzado, un paso más oscuro = su entrada está lista, más oscuro = terminado en esta ejecución. Los iconos y contornos siguen la misma regla, por lo que cualquier "¿por qué este es más oscuro?" tiene un estado como respuesta. La tinta más oscura es un gris medio-oscuro; el negro puro y los bloques oscuros sólidos se quedan fuera.
  • Las líneas descansan muy claras y se oscurecen solo después de que una luz ha corrido a lo largo de ellas.
  • El color significa trabajando ahora mismo: la tarjeta permanece blanca mientras un toque del gradiente de marca se muestra por debajo de ella, con un brillo tenue alrededor. Las luces toman su color de un gradiente colocado a través de toda la imagen a lo largo del flujo.
  • Un acento para una fase (por ejemplo, las entradas siendo recogidas) se muestra solo mientras está iluminado, luego vuelve al gris en el que descansaba.

Movimiento

  • Animación SVG: keyframes CSS dentro del SVG, sin script, reproduciéndose como un <img>. Un vídeo renderizado solo cuando se solicita.
  • El estilo de reposo es la ejecución finalizada; los keyframes comienzan cada bucle desde una ejecución intacta. El movimiento reducido y una exportación estática muestran por tanto el diagrama finalizado.
  • El tiempo proviene de la geometría. Las luces viajan a una velocidad de pantalla (aproximadamente 400 px/s); cada llegada es inicio + longitud de ruta ÷ velocidad, y el siguiente evento es esa llegada más una pausa. Mueve un nodo y la línea de tiempo lo sigue. Calcula toda la línea de tiempo, y la longitud del bucle con ella, antes de escribir cualquier keyframe.
  • Un bucle cuenta la historia una vez: las entradas viajan hacia adentro, el controlador corre de arriba a abajo, las piezas se reúnen y la salida se ensambla, exporta, espera, limpia, repite. Suficientemente lento para seguir (aproximadamente 20 s).
  • Una luz es un guión corto que corre a lo largo de su ruta con un halo más suave y amplio; un rastro más oscuro permanece detrás de ella hasta que el bucle se limpia. Un nodo que trabaja se eleva unos pocos píxeles, brilla y muestra su cara de gradiente.

Coste de renderizado

Como un <img>, cualquier animación en ejecución hace que el navegador vuelva a rasterizar toda la imagen cada fotograma.

  • Las máscaras, filtros y grupos se mantienen pequeños: la cuadrícula se desvanece a través de su propio gradiente de trazo, y una máscara abraza el trazado que revela.
  • Cualquier cosa que no se pueda ver está visibility: hidden (opacidad 0 y un guión aparcado fuera de su trazado aún se pinta).
  • Los keyframes idénticos se escriben una vez.

Exportación

  • PNG estático: abre el propio documento SVG con movimiento reducido emulado y captura la pantalla. Dentro de un <img> la emulación nunca alcanza el SVG, y capturas el primer fotograma del bucle en su lugar.
  • Las vistas previas viven en una página independiente servida localmente, fuera del sitio del usuario, hasta que el usuario coloca el SVG.

Skills relacionados