CommunityImagengithub.com

html-diagrams-decks

Construye diagramas SVG animados e interactivos, figuras arquitectónicas dibujadas a mano y presentaciones 16:9 como archivos HTML autónomos (temas claro y oscuro, construcciones paso a paso con leyendas, flujos de paquetes por conectores, detalles al pasar el ratón, una comprobación de diseño y un sprite de 50 iconos que incluye símbolos de red y energía). Úsalo cuando te pidan un diagrama de arquitectura o flujo, una vista en capas o plataforma, una figura explicativa, un recorrido paso a paso o una presentación como página HTML o artefacto de claude.ai.

¿Qué es html-diagrams-decks?

Esta habilidad permite a agentes de IA como Claude Code, GitHub Copilot y otros generar diagramas SVG interactivos, figuras dibujadas a mano y presentaciones completas como un único archivo HTML autocontenido. Incluye dos bibliotecas de figuras (EdgeDiagram para grafos SVG declarativos con pasos, flujos de paquetes y comprobación de diseño; EdgeSketch para figuras dibujadas a mano sobre cuadrícula), un motor de presentaciones (EdgeDeck) con diapositivas de 1600x900 y avance por pasos, tres temas completos (engineering, indigo, drafting) con modo claro y oscuro, y un sprite de 50 iconos. El flujo de trabajo consiste en seleccionar la biblioteca adecuada según el tipo de figura (grafos con conexiones significativas vs. disposición en cuadrícula), copiar la plantilla correspondiente, diseñar sobre una cuadrícula, definir los pasos de revelado, elegir o crear un tema (incluso a partir de un archivo DESIGN.md), y luego embeber todo en un único archivo HTML usando scripts de línea de comandos. Se incluyen herramientas para capturas de pantalla sin interfaz gráfica, exportación a draw.io, verificación de contraste WCAG y tests. La habilidad impone reglas estrictas sobre conectores (solo horizontales y verticales, sin diagonales ni curvas salvo excepciones), uso de tokens de color (nunca valores literales) y accesibilidad (cada elemento con información es focable mediante teclado y el SVG tiene rol y etiqueta aria). El resultado es un archivo HTML que funciona sin conexión una vez que GSAP está en caché y puede publicarse como artefacto de claude.ai.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nilsonfh/trazo/tree/HEAD/skills/html-diagrams-decks

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

Diagramas y presentaciones HTML

Esta habilidad (una Agent Skill: Claude Code, GitHub Copilot y otros agentes la leen) proporciona dos pequeñas bibliotecas de figuras, un motor de presentaciones, tres temas y tres plantillas. Cada resultado es un archivo HTML que funciona sin conexión una vez que GSAP está en caché, sigue el tema claro u oscuro del visor y se puede publicar como un artefacto de claude.ai.

RutaQué es
lib/edgediagram.jsGrafos SVG declarativos: zone, node, text, link (ortogonal por defecto, flechas, etiquetas, flujos de paquetes), fan (un punto que alimenta varios nodos), bindFocus, steps y una comprobación de diseño en cada paso
lib/edgesketch.jsFiguras dibujadas a mano sobre una cuadrícula: zone, box (ajusta su texto; columnas verticales y barras centradas), arrow (ángulos rectos, dos cabezas), connect (caja a caja), fan, text; y EdgeSketch.check, una comprobación de diseño para cualquier SVG, incluidos cables inclinados y curvos
lib/icons.jswindow.EDGE_ICONS: 50 iconos lineales en una cuadrícula de 24 unidades (equipos de red, cómputo, confianza, operaciones)
lib/edgedeck.jsEdgeDeck.run: un escenario de diapositivas de 1600×900 con pasos por diapositiva, leyendas, teclado, deslizamiento y enlaces #n
themes/*.cssTemas de color y tipografía, claro y oscuro, sobre un mismo contrato de tokens: engineering (azul sobre verde-gris, Archivo Narrow e IBM Plex), indigo (índigo sobre lavanda-gris, Space Grotesk e Inter), drafting (verde azulado sobre papel cálido, Barlow Condensed y Source Sans 3)
templates/diagram.htmlUna figura EdgeDiagram con pasos, leyendas, Anterior/Siguiente y puntos
templates/sketch.htmlUna figura EdgeSketch dibujada a mano: zonas de izquierda a derecha, columnas, servicios, flechas de dos cabezas, una leyenda
templates/deck.htmlUna diapositiva de título más una diapositiva de contenido cuyo diagrama se construye paso a paso
scripts/inline.pyIncrusta los archivos de la biblioteca y el tema en una página para que se publique como un solo archivo; falla si no encuentra algo
scripts/shot.shCapturas de pantalla sin interfaz gráfica (claro u oscuro, cualquier ancho, tras ciertos clics, --only un elemento, --full página) y --check, la comprobación de diseño de cada figura en una página
scripts/todrawio.shExporta una figura de una página construida a un archivo draw.io, para editarlo allí: figuras EdgeDiagram con sus enlaces adjuntos, figuras SVG dibujadas a mano, figuras HTML
scripts/check_theme.pyComprueba el contraste WCAG de un tema en claro y oscuro, y que sus dos bloques oscuros coincidan
scripts/theme_from_design.pyCrea un tema a partir de un archivo DESIGN.md (los colores y tipografías de una marca), claro y oscuro, cada par con su contraste
scripts/test.shEjecuta las pruebas en tests/; ejecútalo tras cambiar lib/, scripts/ o themes/
scripts/vendor.shCopia la biblioteca a otro proyecto, y --check muestra si esa copia está desactualizada
references/api.mdTodas las opciones de ambas bibliotecas y del motor de presentaciones
references/conventions.mdLos tokens, el significado de cada tono, reglas de diseño, publicación y las comprobaciones a ejecutar
examples/ci-canary-deck.htmlUna presentación completa de dos diapositivas sobre un flujo de trabajo neutral (CI/CD, luego un despliegue canario)
examples/isometric/Un generador de figuras en capas isométricas (el cubo SGAM), con lecciones aprendidas
examples/design-md/DESIGN.mdUn DESIGN.md de ejemplo (Harbor) para crear un tema a partir de él

Flujo de trabajo

  1. Decide qué debe mostrar la figura. Nombra el mecanismo, las partes de las que depende y la secuencia para revelarlo. Una frase que lo explique más rápido que una figura.
  2. Elige la biblioteca. Un grafo de partes unidas por cables significativos, revelado paso a paso: EdgeDiagram (templates/diagram.html). Una cuadrícula de cajas, una pila en capas o una vista de plataforma de izquierda a derecha, donde la disposición transmite el significado: EdgeSketch (templates/sketch.html). Una presentación: templates/deck.html, con cualquiera de las bibliotecas en sus diapositivas.
  3. Copia la plantilla al directorio de trabajo, por ejemplo cp <skill>/templates/sketch.html ./my-figure.html. Corrige las rutas de <script src> y del tema para que apunten a <skill>/lib/ y <skill>/themes/, o ejecuta inline.py con --lib y --themes al final.
  4. Diseña sobre una cuadrícula. Elige el viewBox, luego las zonas, luego las cajas (tamaños iguales, espacios uniformes), luego los cables (ver Conectores más abajo). Coloca las cajas que se comunican entre sí en la misma fila o columna, para que su cable sea un tramo recto. A los enlaces que tengan significado, ponles un info. Lee references/api.md para las opciones.
  5. Escribe los pasos (EdgeDiagram). El paso 0 es el estado de reposo. Cada paso posterior añade una idea y tiene una leyenda corta. Usa flows para los datos que se mueven, y dim o hide para lo que el paso deja atrás.
  6. Tema. Las páginas enlazan un tema, <link rel="stylesheet" href="../themes/engineering.css">; cambia el nombre para modificarlo. engineering para material técnico denso, indigo para producto y entrega de software, drafting para propuestas y estudios que se leen como documentos. Mantén el significado de cada tono (references/conventions.md). Para el aspecto de una marca, crea un tema a partir de su DESIGN.md: python3 <skill>/scripts/theme_from_design.py DESIGN.md -o themes/<name>.css (examples/design-md/DESIGN.md es un ejemplo). A mano, copia un tema, conserva cada nombre de token, cambia los valores y ejecuta scripts/check_theme.py themes/<name>.css hasta que pase.
  7. Construye, comprueba y mira:
    python3 <skill>/scripts/inline.py my-figure.html > build/my-figure.html
    <skill>/scripts/shot.sh --check build/my-figure.html          # cada figura; sale con error 1 si hay algún problema
    <skill>/scripts/shot.sh --only '#my-fig' build/my-figure.html /tmp/f-light.png light 1280
    <skill>/scripts/shot.sh --only '#my-fig' build/my-figure.html /tmp/f-dark.png dark 1280
    <skill>/scripts/shot.sh build/my-figure.html /tmp/sN.png dark 1280 'for(var i=0;i<5;i++)document.getElementById("next").click()'
    
    Corrige todo lo que --check reporte. Luego abre los PNG y corrige lo que no puede ver, como cajas fuera de la cuadrícula, puntas de flecha que chocan o etiquetas amontonadas, y vuelve a mirar con un ancho de 420. Las capturas de pantalla congelan los paquetes cerca del inicio de sus cables, así que juzga el movimiento en un navegador real.
  8. Entrega una copia editable cuando te lo pidan. <skill>/scripts/todrawio.sh build/my-figure.html <svg id o selector> out.drawio "Nombre" escribe un archivo draw.io de una figura, en el tema claro y en su último paso. Indica lo que no traslada: movimiento, pasos, tooltips y formas rellenas distintas de rect y ellipse (imprime cuántas omitió).
  9. Publica. El archivo incrustado es la página: compártelo como archivo, confírmalo o, en Claude, pásalo a la herramienta Artifact (vuelve a publicar la misma ruta o URL para actualizarlo).

Conectores

Los cables son lo que sigue un lector, así que deben verse deliberados:

  • Solo horizontales y verticales. Nunca una diagonal ni una curva. Los enlaces de EdgeDiagram son ortho por defecto: omite route. 'straight' solo para dos extremos que ya están alineados, y 'curve' solo cuando el usuario lo solicite. En EdgeSketch usa s.arrow, s.connect y s.fan, que giran en ángulos rectos. En SVG escrito a mano, dibuja los cables con comandos de ruta H y V y redondea solo las esquinas.
  • Un tramo recto cuando las cajas se enfrentan. Omite la posición (t) y EdgeDiagram, o s.connect, pone ambos extremos en línea cuando las dos cajas comparten un tramo. Si la comprobación reporta un desvío de unos pocos píxeles, mueve una caja para que los extremos se alineen; no ajustes t.
  • Una fuente que alimenta varias cajas es un abanico, no un manojo de cables separados. d.fan(id, {from: [src, 'bottom'], to: ['a', 'b', 'c']}), o s.fan(src, 'bottom', [a, b, c]), dibuja un tronco, un bus en ángulo recto y una rama hacia cada caja, con un punto en cada unión. Varias cajas alimentando una es el mismo abanico con las listas intercambiadas ({from: [[...], ...], to: [...]} o {into: true}).
  • Pocas curvas, sin cruces. Elige los lados para que cada cable gire como máximo dos veces. Distribuye los cables que comparten un lado ('auto'). Traza las rutas alrededor de las cajas, nunca a través de ellas.
  • shot.sh --check reporta cables inclinados, curvos y con desvíos. Arrégialos como cualquier otro problema. Marca una excepción deliberada, como una figura isométrica, con data-route="free".

Reglas

  • No uses otras bibliotecas. GSAP 3 de cdnjs es opcional: sin él, cada paso muestra su estado final.
  • Cada color proviene de un token, por lo que los componentes nunca contienen colores literales.
  • Cada nodo, caja o enlace que tenga info es focable mediante teclado. El SVG tiene role="img" y un aria-label que indica lo que la figura afirma.
  • Una figura más ancha que un teléfono se desplaza dentro de su propio contenedor overflow-x: auto, nunca en la página.
  • Mantén los nombres internos, nombres de clientes y direcciones fuera de las páginas que se compartirán.

Skills relacionados