CommunityImagegithub.com

html-diagrams-decks (Diagrammes et présentations HTML)

Construisez des diagrammes SVG interactifs animés, des figures architecturales dessinées à la main et des diaporamas 16:9 sous forme de fichiers HTML autonomes (thèmes clair/sombre, étapes avec légendes, paquets circulant sur les connecteurs, détails au survol, vérification de mise en page et une sprite de 50 icônes incluant des symboles de grille/énergie).

Qu'est-ce que html-diagrams-decks (Diagrammes et présentations HTML) ?

Cette compétence (skill) est conçue pour les agents IA comme Claude Code, GitHub Copilot et Cursor, ainsi que pour les développeurs souhaitant créer rapidement des diagrammes techniques, des figures explicatives ou des présentations animées sous forme de fichiers HTML uniques et autonomes. Elle offre deux bibliothèques de figures, un moteur de diaporama, trois thèmes et trois modèles. Les bibliothèques `lib/edgediagram.js` et `lib/edgesketch.js` permettent respectivement de créer des graphes SVG déclaratifs (zones, nœuds, liens orthogonaux avec flux de paquets) et des figures dessinées à la main sur une grille. Le moteur `lib/edgedeck.js` gère des diapositives 1600x900 avec étapes, légendes, navigation clavier et swipe. Chaque résultat est un fichier HTML qui s'adapte au thème clair ou sombre du navigateur et peut être publié comme artefact sur claude.ai. La compétence inclut des scripts de vérification de mise en page, de capture d'écran sans tête, d'export vers draw.io et de génération de thèmes à partir d'un fichier DESIGN.md.

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

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Diagrammes et présentations HTML

Cette compétence (une Agent Skill : Claude Code, GitHub Copilot et d'autres agents la lisent) fournit deux petites bibliothèques de figures, un moteur de diaporama, trois thèmes et trois modèles. Chaque résultat est un fichier HTML qui fonctionne hors ligne une fois GSAP mis en cache, s'adapte au thème clair ou sombre du spectateur et peut être publié comme artefact claude.ai.

CheminDescription
lib/edgediagram.jsGraphes SVG déclaratifs : zone, node, text, link (orthogonal par défaut, flèches, étiquettes, flux de paquets), fan (un point alimentant plusieurs nœuds), bindFocus, steps, et une vérification de mise en page à chaque étape
lib/edgesketch.jsFigures dessinées à la main sur une grille : zone, box (s'adapte à son texte ; colonnes verticales et barres centrées), arrow (angles droits, deux têtes), connect (boîte à boîte), fan, text ; et EdgeSketch.check, une vérification de mise en page pour tout SVG, fils inclinés et courbes inclus
lib/icons.jswindow.EDGE_ICONS : 50 icônes linéaires sur une grille de 24 unités (équipement de grille, calcul, confiance, opérations)
lib/edgedeck.jsEdgeDeck.run : une scène de diapositive 1600×900 avec étapes par diapositive, légendes, navigation clavier, swipe et liens #n
themes/*.cssThèmes de couleurs et de typographie, clair et sombre, sur un contrat de jetons : engineering (bleu sur gris-vert, Archivo Narrow et IBM Plex), indigo (indigo sur gris-lavande, Space Grotesk et Inter), drafting (sarcelle sur papier chaud, Barlow Condensed et Source Sans 3)
templates/diagram.htmlUne figure EdgeDiagram avec étapes et légendes, Précédent/Suivant et points
templates/sketch.htmlUne figure EdgeSketch dessinée à la main : zones de gauche à droite, colonnes, services, flèches à deux têtes, une légende
templates/deck.htmlUne diapositive titre plus une diapositive contenu dont le diagramme se construit étape par étape
scripts/inline.pyIntègre les fichiers de bibliothèque et le thème dans une page afin qu'elle soit publiée comme un seul fichier ; échoue sur tout ce qu'il ne trouve pas
scripts/shot.shCaptures d'écran sans tête (clair ou sombre, n'importe quelle largeur, après des clics donnés, --only un élément, page --full) et --check, la vérification de mise en page de chaque figure d'une page
scripts/todrawio.shExporte une figure d'une page construite vers un fichier draw.io, pour y être éditée : figures EdgeDiagram avec leurs liens attachés, figures SVG dessinées à la main, figures HTML
scripts/check_theme.pyVérifie le contraste WCAG d'un thème en clair et en sombre, et que ses deux blocs sombres correspondent
scripts/theme_from_design.pyCrée un thème à partir d'un fichier DESIGN.md (couleurs et polices d'une marque), clair et sombre, chaque paire à son contraste
scripts/test.shExécute les tests dans tests/ ; à exécuter après avoir modifié lib/, scripts/ ou themes/
scripts/vendor.shCopie la bibliothèque dans un autre projet, et --check indique si cette copie est en retard
references/api.mdToutes les options des deux bibliothèques et du moteur de diaporama
references/conventions.mdJetons, signification de chaque ton, règles de mise en page, publication et vérifications à exécuter
examples/ci-canary-deck.htmlUn diaporama complet de deux diapositives sur un workflow neutre (CI/CD, puis un déploiement canary)
examples/isometric/Un générateur de figures en couches isométriques (le cube SGAM), avec les leçons apprises
examples/design-md/DESIGN.mdUn exemple de DESIGN.md (Harbor) pour créer un thème

Workflow

  1. Décidez ce que la figure doit montrer. Nommez le mécanisme, les parties dont il dépend et la séquence pour le révéler. Une phrase qui le dit plus vite qu'une figure.
  2. Choisissez la bibliothèque. Un graphe de parties reliées par des fils significatifs, révélé étape par étape : EdgeDiagram (templates/diagram.html). Une grille de boîtes, une pile en couches ou une vue de plateforme de gauche à droite, où l'agencement porte le sens : EdgeSketch (templates/sketch.html). Une présentation : templates/deck.html, avec l'une ou l'autre bibliothèque sur ses diapositives.
  3. Copiez le modèle dans le répertoire de travail, par exemple cp <skill>/templates/sketch.html ./my-figure.html. Corrigez les chemins <script src> et du thème pour qu'ils pointent vers <skill>/lib/ et <skill>/themes/, ou exécutez inline.py avec --lib et --themes à la fin.
  4. Disposez sur une grille. Choisissez le viewBox, puis les zones, puis les boîtes (tailles égales, espacements pairs), puis les fils (voir Connecteurs ci-dessous). Placez les boîtes qui communiquent entre elles dans la même ligne ou colonne, afin que leur fil soit un seul tracé rectiligne. Donnez aux liens qui portent un sens un info. Lisez references/api.md pour les options.
  5. Écrivez les étapes (EdgeDiagram). L'étape 0 est l'état de repos. Chaque étape suivante ajoute une idée et a une courte légende. Utilisez flows pour les données qui se déplacent, et dim ou hide pour ce que l'étape dépasse.
  6. Thème. Les pages lient un thème, `<link rel=

Skills associés