Communitygithub.com

Isometrische SVG-Animation

Isometrische Architekturdiagramme, die als animierte SVGs von einem Build-Skript generiert werden. Verwenden Sie dies, wenn ein isometrisches oder 2,5D-System-, Pipeline- oder Architekturdiagramm, eine animierte SVG-Flussillustration für eine Website oder eine Überarbeitung eines so erstellten Diagramms angefordert wird.

Was ist Isometrische SVG-Animation?

Dieses Skill generiert isometrische Architekturdiagramme als animierte SVGs mit einem Build-Skript (`node build.mjs`). Es projiziert Formen aus Planungseinheiten in die Isometrie und erzeugt eine eigenständige `diagram.svg` (mit CSS-Keyframes, die als einfaches `<img>` abspielbar ist) sowie eine `preview.html`. Das Skill folgt einem strukturierten Workflow: Story-Erstellung, Briefing, statischer Build, Motion-Keyframes und Export. Es unterstützt Claude Code, Cursor und Codex und bietet ein umfassendes Regelwerk für Geometrie, Textlayout, Linienführung und Animation. Die Animationen werden zeitlich aus der Geometrie berechnet (ca. 400 px/s), sodass sich die Timeline automatisch anpasst, wenn Knoten verschoben werden. Der Fokus liegt auf einem klaren, reduzierten Design mit neutralen Farben, die den Zustand der Komponenten anzeigen, und sanften, nachvollziehbaren Abläufen.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Isometrische SVG-Animation?

Ein Skript (node build.mjs) platziert jede Form in Planungseinheiten, projiziert sie isometrisch und schreibt eine eigenständige diagram.svg (CSS-Keyframes enthalten, spielt als einfaches <img>) sowie preview.html (das gleiche SVG eingebettet und an das Fenster skaliert). Nichts wird von Hand gezeichnet: jede Korrektur ist eine Codeänderung und ein Neubuild.

Bevor Sie das Skript schreiben, lesen Sie references/generator.md: dessen Abschnitte und den Kerncode für Projektion, Karten, Grundflächentext, Routen, Keyframes, Plattformen und Assembly.

Schritte

  1. Story. Lesen Sie die eigenen Dokumentationen des Systems, schreiben Sie dann die Geschichte des Diagramms als einen Satz: Was kommt herein, was verarbeitet es, was treibt die Arbeit an, was kommt heraus. Der Fluss verläuft von unten links nach oben rechts. Abgeschlossen, wenn jede Stufe in der Linie ein Knoten ist, den Sie mit einem bis drei Wörtern benennen können und der Benutzer mit der Linie einverstanden ist.
  2. Briefing. Holen Sie ein Referenzbild für das Gefühl (Linienstärke, Dichte, Plattformstil); wenn der Benutzer keines hat, zeigen Sie die Diagramme in references/examples.md und lassen Sie ihn wählen. Legen Sie Thema, Seitenverhältnis (1,6:1 passt in ein Browserfenster) und fest, wo das SVG leben wird. Abgeschlossen, wenn alle vier im Header-Kommentar des Skripts stehen.
  3. Statischer Build. Plattformen, Knoten, Routen, Beschriftungen; noch keine Bewegung. Abgeschlossen, wenn das Audit des Builds keine Überlappungen und keine engen Ecken ausgibt und der Benutzer einen Screenshot des Layouts abgesegnet hat.
  4. Bewegung. Fügen Sie die Schleife hinzu. Abgeschlossen, wenn eine Schleife die Geschichte einmal in der richtigen Reihenfolge abspielt und reduzierte Bewegung den Endzustand zeigt.
  5. Export. Siehe Export unten.

Jede Überprüfungsrunde: nehmen Sie die Notizen des Benutzers einzeln, beantworten Sie jede Frage, bevor Sie etwas ändern, kopieren Sie den aktuellen Build in versions/ vor einer großen Änderung und antworten Sie mit einem Screenshot. Wenn der Benutzer zwischen Namen oder Symbolen wählt, rendern Sie die Optionen nebeneinander.

Prinzipien

Inhalt

  • Ein Fluss, wenige Details. Jeder Knoten wird nach dem benannt, was er wirklich tut; wenn ein Name umstritten ist, sagen Sie, welcher zutreffend ist und warum, und lassen Sie dann den Benutzer wählen.
  • Jede Beschriftung ist für sich allein verständlich für einen Fremden. Eine Beschriftung, die erklärt werden muss, wird umgeschrieben oder gestrichen.
  • Ein Stapel Platten nur für etwas, das wirklich ein Stapel ist (die Seiten eines Berichts); jeder andere Knoten ist eine einzelne Karte.
  • Ehrliche Nebenpfade bleiben gezeichnet (Eingaben, die eine Stufe überspringen), auch wenn sie Platz kosten.
  • Externe Systeme sitzen auf Plattformen mit der gleichen Füllung wie interne; eine gestrichelte Kante markiert sie allein als extern.
  • Lose Eingaben liegen flach auf dem Boden, ohne Plattform darunter.

Geometrie

  • Planungseinheiten überall: a verläuft entlang des Flusses (Bildschirm oben-rechts), b quer dazu (Bildschirm unten-rechts), z nach oben. Positionen, Größen, Abstände und Routen sind Planungseinheiten; Bildschirmpixel existieren nur innerhalb der Projektion.
  • Eine Karte besteht aus einer Oberseite und einem Seitenband (die Hülle ihrer oberen und unteren Kontur) mit einem Strich auf der äußeren Kontur, und die Fläche trifft auf die Dicke ohne Linie. Plattformen streichen stattdessen ihre Oberseite, da diese Fläche auf dem Raster liegt.
  • Eine Dicke für jede Karte und jeden Modul-Pill. Namens-Pills liegen flach ohne Dicke.
  • Malen Sie in Schichten (Boden, Plattformen, Drähte, Objekte, Beschriftungen), sortiert nach Tiefe innerhalb jeder.

Text

  • Jede Beschriftung liegt auf der Bodenebene mit ihrer Grundlinie entlang a. Glyphen werden zur Build-Zeit zu Pfaden umgewandelt, damit das SVG überall gleich als <img> rendert und keine Schriftart lädt.
  • Größen stammen aus einer kleinen Tabelle (Pill, Beschriftung, klein, Bildunterschrift, Titel). Plattformtitel sind in Monospace-Großbuchstaben mit Abständen.

Layout

  • Ein Bodenraster bei 2 Einheiten. Plattformkanten rasten nach außen auf Rasterlinien ein; Abstände zwischen Plattformen und zwischen Zeilen sind ganze Zellen; eine gemeinsame Hauptleitung verläuft auf einer Rasterlinie, die in ihrem Abstand zentriert ist.
  • Plattformen dimensionieren sich selbst: jeder Knoten und jede Beschriftung registriert seinen Fußabdruck mit seiner Plattform, und die Plattform ist diese Box plus eine einheitliche Polsterung, auf das Raster eingerastet. Plattformen in einer Reihe teilen sich ihre gegenüberliegenden Kanten.
  • Ein Plattformtitel sitzt so weit vom linken Rand wie vom vorderen Rand (gemessen bis zum Fuß seiner Großbuchstaben), linksbündig mit dem Inhalt.
  • Das Raster erstreckt sich über jede Kante des Rahmens und verblasst durch eine Ellipse mit dem Seitenverhältnis des Rahmens, sodass das Bild keine harte Kante hat. Der Hintergrund ist transparent.
  • Jeder Build gibt ein Audit aus: die vier Ränder jeder Plattform, die Abstände zwischen Plattformen, Überlappungen von Beschriftung × Beschriftung und Beschriftung × Karte sowie Ecken, die für ihren Radius zu eng sind. Lesen Sie es, bevor Sie etwas zeigen.

Linien

  • Jede Verbindung ist ein durchgehender Pfad: orthogonal, mit Viertelrundungen von einem festen Radius, sodass sich Routen, die sich einen Abschnitt teilen, diesen exakt teilen und ein Ast seine Hauptleitung tangential verlässt. Zeichnen Sie zuerst Routen und dann Knoten darauf; das Ergebnis hat keine Stummel, Gabeln oder Lücken.
  • Linienarten unterscheiden sich durch Muster: durchgezogen für den Fluss, gestrichelt für eine externe Schiene, runde Punkte für schreibgeschützten Zugriff.

Ton

  • Ton ist Zustand. Nur Neutraltöne (R = G = B). Hell = noch nicht erreicht, eine Stufe dunkler = seine Eingabe ist bereit, am dunkelsten = in diesem Durchlauf erledigt. Symbole und Konturen folgen der gleichen Regel, sodass jedes "Warum ist dieses dunkler?" eine Zustandsantwort hat. Die dunkelste Tinte ist ein mitteldunkles Grau; reines Schwarz und feste dunkle Blöcke bleiben draußen.
  • Linien ruhen sehr hell und verdunkeln sich erst, nachdem ein Licht entlang ihnen gelaufen ist.
  • Farbe bedeutet gerade aktiv: die Karte bleibt weiß, während ein Hauch des Markenverlaufs von unten durchscheint, mit einem schwachen Glanz darum. Lichter nehmen ihre Farbe von einem Verlauf, der über das gesamte Bild entlang des Flusses gelegt wird.
  • Ein Akzent für eine Phase (z. B. dass Eingaben aufgenommen werden) zeigt sich nur, während sie beleuchtet ist, und kehrt dann zu dem Grau zurück, in dem sie geruht hat.

Bewegung

  • SVG-Animation: CSS-Keyframes innerhalb des SVG, kein Skript, abspielbar als <img>. Ein gerendertes Video nur auf Anfrage.
  • Der Ruhestil ist der fertige Durchlauf; die Keyframes starten jede Schleife von einem unberührten Durchlauf. Reduzierte Bewegung und ein statischer Export zeigen daher das fertige Diagramm.
  • Zeit kommt aus der Geometrie. Lichter bewegen sich mit einer Bildschirmgeschwindigkeit (ca. 400 px/s); jede Ankunft ist Start + Routenlänge ÷ Geschwindigkeit, und das nächste Ereignis ist diese Ankunft plus eine Pause. Verschieben Sie einen Knoten und die Timeline folgt. Berechnen Sie die gesamte Timeline und mit ihr die Schleifenlänge, bevor Sie einen Keyframe schreiben.
  • Eine Schleife erzählt die Geschichte einmal: Eingaben reisen herein, der Treiber läuft von oben nach unten, die Teile sammeln sich und die Ausgabe assembliert, Export, halten, löschen, wiederholen. Langsam genug, um zu folgen (ca. 20 s).
  • Ein Licht ist eine kurze Strichlinie entlang seiner Route mit einem weicheren, breiteren Halo; eine dunklere Spur bleibt dahinter, bis die Schleife löscht. Ein arbeitender Knoten hebt ein paar Pixel an, glüht und zeigt seine Verlaufsfläche.

Rendering-Kosten

Als <img> bringt jede laufende Animation den Browser dazu, das gesamte Bild in jedem Frame neu zu rastern.

  • Masken, Filter und Gruppen bleiben klein: das Raster verblasst durch seinen eigenen Strichverlauf, und eine Maske umschließt den Pfad, den sie enthüllt.
  • Alles, was nicht sichtbar ist, ist visibility: hidden (Deckkraft 0 und ein Strich, der von seinem Pfad weggeparkt ist, wird trotzdem gemalt).
  • Identische Keyframes werden einmal geschrieben.

Export

  • Statisches PNG: Öffnen Sie das SVG-Dokument selbst mit emulierter reduzierter Bewegung und machen Sie einen Screenshot davon. Innerhalb eines <img> erreicht die Emulation das SVG nie, und Sie erfassen stattdessen den ersten Frame der Schleife.
  • Vorschauen leben in einer eigenständigen Seite, die lokal bereitgestellt wird, außerhalb der Website des Benutzers, bis der Benutzer das SVG platziert.

Verwandte Skills