Communitygithub.com

isometric-svg-animation

Génère des diagrammes d'architecture isométriques sous forme d'animations SVG, à partir d'un script de build.

Qu'est-ce que isometric-svg-animation ?

Cette compétence permet de créer des diagrammes d'architecture isométriques (2,5D) animés, entièrement générés par code. Elle est conçue pour les développeurs souhaitant produire des illustrations de flux système, pipelines ou architectures, avec une animation SVG intégrée (keyframes CSS) lisible comme une simple image <img>. Le processus est entièrement automatisé via un script Node.js (build.mjs) : les formes sont placées en unités de plan, projetées en isométrique, et le résultat est un fichier SVG autonome (diagram.svg) ainsi qu'une prévisualisation HTML (preview.html). La compétence impose des principes stricts de géométrie, de mise en page, de rendu des textes (transformés en chemins pour l'indépendance des polices), de gestion des couleurs (tons de gris et état lumineux) et d'animation (temps basé sur la géométrie). Elle est idéale pour les plateformes d'agents comme Claude Code, Cursor ou Codex, où un développeur peut décrire un flux et obtenir un diagramme SVG animé et prêt à l'emploi, sans intervention manuelle.

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

Demander à votre IA préférée

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

Documentation

Animation SVG isométrique

Un script (node build.mjs) place chaque forme en unités de plan, la projette en isométrie, et écrit un diagram.svg autonome (keyframes CSS intégrées, lisible comme une simple <img>) plus preview.html (le même SVG intégré et redimensionné à la fenêtre). Rien n'est dessiné à la main : chaque correction est une modification de code et une reconstruction.

Avant d'écrire le script, lisez references/generator.md : ses sections et le code de base pour la projection, les cartes, le texte au sol, les routes, les keyframes, les plateformes et l'assemblage.

Étapes

  1. Histoire. Lisez la documentation du système, puis écrivez l'histoire du diagramme en une ligne : ce qui entre, ce qui le traite, ce qui le pilote, ce qui sort. Le flux se lit de bas à gauche à haut à droite. Terminé lorsque chaque étape de la ligne est un nœud que vous pouvez nommer en un à trois mots et que l'utilisateur approuve la ligne.
  2. Brief. Obtenez une image de référence pour le rendu (épaisseur de trait, densité, style de plateforme) ; si l'utilisateur n'en a pas, montrez les diagrammes dans references/examples.md et laissez-le choisir. Fixez le thème, le rapport d'aspect (1,6:1 correspond à une fenêtre de navigateur) et l'emplacement du SVG. Terminé lorsque les quatre éléments figurent dans le commentaire d'en-tête du script.
  3. Construction statique. Plateformes, nœuds, routes, étiquettes ; pas encore de mouvement. Terminé lorsque l'audit du build n'affiche aucun chevauchement ni angle trop serré, et que l'utilisateur a validé une capture d'écran de la disposition.
  4. Mouvement. Ajoutez la boucle. Terminé lorsqu'une boucle raconte l'histoire une fois, dans l'ordre, et que le mode de mouvement réduit affiche l'état final.
  5. Export. Voir Export ci-dessous.

Chaque tour de révision : prenez les notes de l'utilisateur une par une, répondez à toute question avant de modifier quoi que ce soit, copiez le build actuel dans versions/ avant un changement important, et répondez avec une capture d'écran. Lorsque l'utilisateur choisit entre des noms ou des icônes, affichez les options côte à côte.

Principes

Contenu

  • Un seul flux, peu de détails. Chaque nœud est nommé pour ce qu'il fait vraiment ; lorsqu'un nom est contesté, dites lequel est précis et pourquoi, puis laissez l'utilisateur choisir.
  • Chaque étiquette se lit d'elle-même pour un étranger. Une étiquette qui nécessite une explication est réécrite ou supprimée.
  • Un empilement de plaques uniquement pour une chose qui est vraiment une pile (les pages d'un rapport) ; tout autre nœud est une simple carte.
  • Les chemins latéraux honnêtes restent dessinés (entrées qui sautent une étape), même s'ils coûtent de l'espace.
  • Les systèmes externes reposent sur des plateformes avec le même remplissage que les internes ; seul un bord en pointillé les marque comme externes.
  • Les entrées libres reposent à plat sur le sol, sans plateforme en dessous.

Géométrie

  • Unités de plan partout : a le long du flux (écran vers le haut-droite), b en travers (écran vers le bas-droite), z vers le haut. Les positions, tailles, espaces et routes sont en unités de plan ; les pixels écran n'existent qu'à l'intérieur de la projection.
  • Une carte est une face supérieure plus une bande latérale (l'enveloppe de ses contours supérieur et inférieur) avec un seul trait sur le contour extérieur, et la face rejoint l'épaisseur sans ligne. Les plateformes tracent plutôt leur face supérieure, car cette face repose sur la grille.
  • Une seule épaisseur pour chaque carte et pilul module. Les pilules de nom reposent à plat sans épaisseur.
  • Peignez en couches (sol, plateformes, fils, objets, étiquettes), triés par profondeur à l'intérieur de chaque.

Texte

  • Chaque étiquette repose sur le plan du sol avec sa ligne de base le long de a. Les glyphes sont convertis en chemins au moment du build, de sorte que le SVG s'affiche de la même manière qu'une <img> partout et ne charge aucune police.
  • Les tailles proviennent d'une petite table (pilule, étiquette, petit, légende, titre). Les titres de plateformes sont en capitales monospaces espacées.

Disposition

  • Une grille au sol à 2 unités. Les bords des plateformes s'alignent vers l'extérieur sur les lignes de la grille ; les espaces entre plateformes et entre rangées sont des cellules entières ; une ligne de tronc commune court sur une ligne de grille centrée dans son espace.
  • Les plateformes se dimensionnent elles-mêmes : chaque nœud et étiquette enregistre son empreinte avec sa plateforme, et la plateforme est cette boîte plus un rembourrage uniforme, aligné sur la grille. Les plateformes d'une rangée partagent leurs bords face à face.
  • Un titre de plateforme se trouve aussi loin du bord gauche que du bord avant (mesuré jusqu'au pied de ses capitales), aligné à gauche avec le contenu.
  • La grille s'étend au-delà de chaque bord du cadre et s'estompe à travers une ellipse ayant le rapport d'aspect du cadre, de sorte que l'image n'a pas de bord dur. L'arrière-plan est transparent.
  • Chaque build affiche un audit : les quatre marges de chaque plateforme, les espaces entre plateformes, les chevauchements étiquette × étiquette et étiquette × carte, et les coins trop serrés pour leur rayon. Lisez-le avant de montrer quoi que ce soit.

Lignes

  • Chaque connexion est un chemin continu : orthogonal, avec des coins à quart de tour d'un rayon fixe, de sorte que les routes qui partagent un tronçon le partagent exactement et qu'une branche quitte son tronc le long d'une tangente. Tracez d'abord les routes et les nœuds par-dessus ; le résultat n'a ni moignons, ni fourches, ni trous.
  • Les types de lignes diffèrent par motif : trait plein pour le flux, pointillé pour un rail externe, points ronds pour un accès en lecture seule.

Ton

  • Le ton indique l'état. Uniquement des neutres (R = G = B). Clair = pas encore atteint, un cran plus foncé = son entrée est prête, le plus foncé = terminé pour ce tour. Les icônes et contours suivent la même règle, donc tout « pourquoi celui-ci est-il plus foncé ? » a un état pour sa réponse. L'encre la plus foncée est un gris moyen-foncé ; le noir pur et les blocs foncés pleins restent exclus.
  • Les lignes reposent très claires et ne s'assombrissent qu'après qu'une lumière a couru le long d'elles.
  • La couleur signifie fonctionne en ce moment : la carte reste blanche tandis qu'une nuance du dégradé de la marque transparaît en dessous, avec une faible lueur autour. Les lumières prennent leur couleur d'un dégradé placé sur toute l'image le long du flux.
  • Un accent pour une phase (par exemple, les entrées en cours de ramassage) n'apparaît que lorsqu'il est allumé, puis revient au gris dans lequel il reposait.

Mouvement

  • Animation SVG : keyframes CSS à l'intérieur du SVG, sans script, lisible comme une <img>. Une vidéo rendue uniquement sur demande.
  • Le style de repos est le parcours terminé ; les keyframes commencent chaque boucle à partir d'un parcours non touché. Le mouvement réduit et une exportation statique affichent donc le diagramme terminé.
  • Le temps vient de la géométrie. Les lumières voyagent à une vitesse écran (environ 400 px/s) ; chaque arrivée est départ + longueur de route ÷ vitesse, et l'événement suivant est cette arrivée plus une pause. Déplacez un nœud et la chronologie suit. Calculez toute la chronologie, et la longueur de boucle avec, avant d'écrire une keyframe.
  • Une boucle raconte l'histoire une fois : les entrées voyagent vers l'intérieur, le conducteur va de haut en bas, les pièces se rassemblent et la sortie s'assemble, exportation, pause, effacement, répétition. Assez lent pour être suivi (environ 20 s).
  • Une lumière est un court tiret parcourant sa route avec une lueur plus douce et plus large ; une trace plus sombre reste derrière elle jusqu'à ce que la boucle s'efface. Un nœud actif se soulève de quelques pixels, brille et fait clignoter sa face dégradée.

Coût de rendu

En tant que <img>, toute animation en cours force le navigateur à re-rasteriser toute l'image à chaque image.

  • Les masques, filtres et groupes restent petits : la grille s'estompe via son propre dégradé de trait, et un masque épouse le chemin qu'il révèle.
  • Tout ce qui ne peut pas être vu est visibility: hidden (opacité 0 et un tiret garé hors de son chemin sont toujours peints).
  • Les keyframes identiques sont écrites une seule fois.

Export

  • PNG statique : ouvrez le document SVG lui-même avec le mouvement réduit émulé et prenez une capture d'écran. Dans une <img>, l'émulation n'atteint jamais le SVG et vous capturez la première image de la boucle à la place.
  • Les aperçus se trouvent dans une page autonome servie localement, en dehors du site de l'utilisateur, jusqu'à ce que l'utilisateur place le SVG.

Skills associés