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.
| Ruta | Qué es |
|---|---|
lib/edgediagram.js | Grafos 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.js | Figuras 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.js | window.EDGE_ICONS: 50 iconos lineales en una cuadrícula de 24 unidades (equipos de red, cómputo, confianza, operaciones) |
lib/edgedeck.js | EdgeDeck.run: un escenario de diapositivas de 1600×900 con pasos por diapositiva, leyendas, teclado, deslizamiento y enlaces #n |
themes/*.css | Temas 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.html | Una figura EdgeDiagram con pasos, leyendas, Anterior/Siguiente y puntos |
templates/sketch.html | Una figura EdgeSketch dibujada a mano: zonas de izquierda a derecha, columnas, servicios, flechas de dos cabezas, una leyenda |
templates/deck.html | Una diapositiva de título más una diapositiva de contenido cuyo diagrama se construye paso a paso |
scripts/inline.py | Incrusta 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.sh | Capturas 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.sh | Exporta 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.py | Comprueba el contraste WCAG de un tema en claro y oscuro, y que sus dos bloques oscuros coincidan |
scripts/theme_from_design.py | Crea 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.sh | Ejecuta las pruebas en tests/; ejecútalo tras cambiar lib/, scripts/ o themes/ |
scripts/vendor.sh | Copia la biblioteca a otro proyecto, y --check muestra si esa copia está desactualizada |
references/api.md | Todas las opciones de ambas bibliotecas y del motor de presentaciones |
references/conventions.md | Los tokens, el significado de cada tono, reglas de diseño, publicación y las comprobaciones a ejecutar |
examples/ci-canary-deck.html | Una 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.md | Un DESIGN.md de ejemplo (Harbor) para crear un tema a partir de él |
Flujo de trabajo
- 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.
- 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. - 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 ejecutainline.pycon--liby--themesal final. - 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. Leereferences/api.mdpara las opciones. - 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
flowspara los datos que se mueven, ydimohidepara lo que el paso deja atrás. - Tema. Las páginas enlazan un tema,
<link rel="stylesheet" href="../themes/engineering.css">; cambia el nombre para modificarlo.engineeringpara material técnico denso,indigopara producto y entrega de software,draftingpara 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.mdes un ejemplo). A mano, copia un tema, conserva cada nombre de token, cambia los valores y ejecutascripts/check_theme.py themes/<name>.csshasta que pase. - Construye, comprueba y mira:
Corrige todo lo quepython3 <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()'--checkreporte. 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. - 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ó). - 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
orthopor defecto: omiteroute.'straight'solo para dos extremos que ya están alineados, y'curve'solo cuando el usuario lo solicite. En EdgeSketch usas.arrow,s.connectys.fan, que giran en ángulos rectos. En SVG escrito a mano, dibuja los cables con comandos de rutaHyVy redondea solo las esquinas. - Un tramo recto cuando las cajas se enfrentan. Omite la posición (
t) y EdgeDiagram, os.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 ajustest. - 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']}), os.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 --checkreporta cables inclinados, curvos y con desvíos. Arrégialos como cualquier otro problema. Marca una excepción deliberada, como una figura isométrica, condata-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
infoes focable mediante teclado. El SVG tienerole="img"y unaria-labelque 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.