Communitygithub.com

Flowy

Erstelle, lies und aktualisiere Flowy-Diagramm-HTML-Dateien für Flussdiagramme, Systemdiagramme und UI-Wireframes/Mockups.

Was ist Flowy?

Flowy ist ein KI-nativer Diagramm-Skill, der eigenständige HTML-Dateien mit interaktiven SVG-Diagrammen erstellt. Er eignet sich hervorragend für die Visualisierung von Abläufen, Systemarchitekturen, UI-Wireframes und Prozessplänen mithilfe einer klaren, schema-basierten Struktur. Der Skill unterstützt die Diagrammtypen 'flowchart' und 'ui-mockup' und definiert Knoten (z. B. Boxen, Kreise, Rauten, Notizen, Gruppen) sowie Kanten mit kubischen Bezierkurven und Pfeilspitzen. Die Layout-Regeln legen die Flussrichtung, Abstände, Standardgrößen und eine Farbpalette für Aktionen, Entscheidungen, Fehler und Endknoten fest. Flowy ist komplett offline und ohne externe Abhängigkeiten nutzbar – alle Diagramme sind einzelne HTML-Dateien, die durch die Verarbeitung eines `DIAGRAM`-Objekts gerendert werden. Der Skill enthält eine HTML-Vorlage und vermeidet veraltete Referenzen, indem er diese als alleinige Quelle der Wahrheit betrachtet. Entwickler können mit diesem Skill neue Diagramme erstellen, bestehende analysieren oder aktualisieren, indem sie das `meta`-Objekt anpassen und die JSON-Daten bearbeiten. Der Skill ist für Claude Code, Cursor, Codex und ähnliche KI-Assistenten optimiert.

Funktioniert mit✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/vandezand-ctrl/workflow-automation-skills/tree/HEAD/skills/flowy

In Ihrer bevorzugten KI fragen

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

Dokumentation

Flowy, KI-nativer Diagramm-Skill

Flowy erzeugt eigenständige HTML-Dateien, die interaktive SVG-Diagramme rendern. Jede Datei enthält eingebettetes CSS, JavaScript und Diagrammdaten – keine Abhängigkeiten, einfach doppelklicken und im Browser öffnen.

Dateipfade

  • Diagramme: docs/diagrams/*.html (z. B. docs/diagrams/upload-flow.html). Erstelle den Ordner bei der ersten Nutzung; er existiert möglicherweise noch nicht. Falls ein Projekt Diagramme bereits an anderer Stelle ablegt, folge stattdessen der dortigen Konvention.
  • HTML-Vorlage: ${CLAUDE_SKILL_DIR}/references/html-template.html, der kanonische Renderer und die einzige Referenzdatei, die dieser Skill mitbringt. Der Pfad löst sich in das eigene Verzeichnis dieses Skills auf, egal wo er installiert ist (Plugin, persönlich oder Projekt), und ist daher unabhängig vom aktuellen Projekt.

Es gibt bewusst keine Schema-Datei, keinen Beispiele-Ordner und keinen visuellen Editor. Frühere Versionen dieses Skills verwiesen auf flowy/schema.ts, flowy/examples/, flowy/editor.html und ein Flowy-Quellrepo auf der Festplatte. Keines davon existiert, die Pfade waren veraltet und ihre Verfolgung kostete Zeit. Die obige HTML-Vorlage ist die Quelle der Wahrheit für die Struktur; lies sie, bevor du ein Diagramm erstellst.

Vorbereitung

Bevor du ein Flowy-Diagramm erstellst oder bearbeitest:

  1. Lies ${CLAUDE_SKILL_DIR}/references/html-template.html, um den aktuellen Renderer-Code zu haben
  2. Liste vorhandene Diagramme in docs/diagrams/ auf, um Namenskonflikte zu vermeiden
  3. Falls du ein vorhandenes Diagramm aktualisierst, lies es zuerst und extrahiere das DIAGRAM-Objekt

Schema

Jedes Diagramm ist ein JavaScript-Objekt mit drei Feldern:

{
  meta: { title, description, type, tags[], created, updated },
  nodes: [...],
  edges: [...]
}

meta

FeldTypErforderlichAnmerkungen
titlestringjaMenschenlesbarer Titel
descriptionstringneinWas das Diagramm zeigt
typestringja"flowchart" oder "ui-mockup"
tagsstring[]neinZur Organisation
createdstringneinISO-Datum (JJJJ-MM-TT)
updatedstringneinISO-Datum, beim Erstellen/Aktualisieren auf heute setzen

nodes

FeldTypErforderlichAnmerkungen
idstringjaeindeutig, snake_case (z. B. "step1_upload")
typestringja"box", "circle", "diamond", "note", "group"
labelstringjaPrimärer Text, der in der Form angezeigt wird
sublabelstringneinSekundärer Text, der im Hover-Tooltip erscheint
position{ x, y }jaOben-links-Ecke in Pixeln
size{ width, height }jaAbmessungen in Pixeln
styleobjectneinSiehe Stilfelder für Knoten unten
groupstringneinID des übergeordneten Gruppenknotens (nur visuelle Gruppierung)

Stilfelder für Knoten: fill, stroke, strokeWidth, color (Text), fontSize, borderRadius, opacity

edges

FeldTypErforderlichAnmerkungen
idstringjaeindeutig (z. B. "e_upload_to_extract")
sourcestringjaQuellknoten-ID
targetstringjaZielknoten-ID
labelstringneinText auf dem Pfeil (z. B. "ja", "fehler")
sourceHandlestringnein"top", "right", "bottom" (Standard), "left"
targetHandlestringnein"top" (Standard), "right", "bottom", "left"
styleobjectneinSiehe Stilfelder für Kanten unten

Stilfelder für Kanten: stroke, strokeWidth, strokeDasharray, markerEnd

Rendering-Regeln für Knoten

TypSVG-ElementDetails
box<rect>Abgerundete Ecken über rx/ry aus borderRadius. Standard: 8px
circle<ellipse>cx = x + width/2, cy = y + height/2, rx = width/2, ry = height/2
diamond<polygon>4 Punkte: oben-mitte, rechts-mitte, unten-mitte, links-mitte
note<path>Rechteck mit eingeklappter Ecke (oben-rechts). Faltgröße: 12px
group<rect>Gestrichelter Rand (stroke-dasharray: 6,3). Wird HINTER allen anderen Knoten gerendert. Bezeichnung oben-links. Niedrige Deckkraft

Rendering-Regeln für Kanten

  1. Berechne Quellpunkt: Mitte der angegebenen Anschlussseite des Quellknotens (Standard: unten)
  2. Berechne Zielpunkt: Mitte der angegebenen Anschlussseite des Zielknotens (Standard: oben)
  3. Zeichne eine kubische Bezierkurve (C-Befehl) mit Kontrollpunkten, die 50px in Anschlussrichtung versetzt sind
  4. Füge eine Pfeilspitze mittels einer SVG-<marker>-Definition hinzu
  5. Falls strokeDasharray gesetzt ist, rendere als gestrichelte Linie
  6. Falls label vorhanden ist, rendere es am Mittelpunkt der Bezierkurve mit einem kleinen weißen Hintergrundrechteck dahinter

Layout-Regeln

Flussrichtung

  • Flussdiagramme: Von oben nach unten (Standard)
  • UI-Mockups: Von oben nach unten innerhalb eines Gruppencontainers, Anmerkungen rechts

Abstände

  • Mindestens 70px vertikal zwischen Knotenmittelpunkten
  • Mindestens 60px horizontal zwischen parallelen Knoten
  • Gruppenabstand: 40px innerhalb der Gruppengrenzen

Entscheidungsrauten

  • Linker Zweig = primärer / ja-Pfad
  • Rechter Zweig = sekundärer / nein / Fehlerpfad

Fehler-/Warnhinweise

  • Platziere sie RECHTS vom Hauptfluss
  • Verbinde sie mit gestrichelten roten Kanten (strokeDasharray: "6,3", stroke: #991b1b)

Standardgrößen

TypBreiteHöhe
box20050
circle9040
diamond12060
note18044

Farbpalette

ZweckFüllungRahmenText
Aktionen#ffffff#2d6a4f#1f2937
Primäre Aktionen#d1fae5#065f46#065f46
Entscheidungen#fef3c7#92400e#1f2937
Fehler#fee2e2#991b1b#991b1b
Endknoten#40916c#2d6a4f#ffffff
Gruppen#f5f5f2#e6e4df#374151
Info/Sekundär#dbeafe#1e40af#1e40af
Standard-Kanten,#6b7280,

HTML-Dateistruktur

Jede Flowy-HTML-Datei folgt dieser Struktur. Lies die HTML-Vorlagenreferenz für den vollständigen funktionierenden Code.

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>{Diagrammtitel}</title>
  <style>
    /* Das gesamte CSS inline, Symbolleiste, Zeichenfläche, Tooltips, Auswahlhervorhebungen */
  </style>
</head>
<body>
  <div id="toolbar">
    <!-- [Anpassen] [-] 100% [+]   Titel  Badge   [JSON herunterladen] -->
  </div>
  <div id="canvas-wrap">
    <svg id="canvas">
      <defs><!-- Pfeilspitzen-Marker --></defs>
      <g id="diagram-root"></g>
    </svg>
  </div>
  <div id="tooltip"></div>
  <script>
    const DIAGRAM = { meta: {...}, nodes: [...], edges: [...] };
    // Rendering- und Interaktivitätscode
  </script>
</body>
</html>

Symbolleiste

  • Fest am oberen Rand, 48px hoch, weißer Hintergrund, unterer Rand
  • Links: Anpassen-Schaltfläche, Verkleinern, Zoom-%, Vergrößern
  • Mitte: Diagrammtitel (fett) + Typ-Badge (graue Pille)
  • Rechts: JSON herunterladen-Schaltfläche (blau)

Interaktivität (alles Vanilla-JS)

  1. Zoom: Mausrad skaliert das SVG-viewBox. Bereich: 0,2x bis 5x. Zoom zur Cursorposition hin.
  2. Schwenken: Klicken und ziehen auf leerer Zeichenfläche verschiebt das viewBox.
  3. Hover: Wenn du mit der Maus über einen Knoten fährst, wird dessen sublabel in einem Tooltip in der Nähe des Cursors angezeigt.
  4. Klick: Ein Klick auf einen Knoten hebt ihn hervor (blauer Rand) und alle verbundenen Kanten. Klicke auf leeren Bereich, um die Auswahl aufzuheben.
  5. Anpassen: Die Schaltfläche berechnet den Begrenzungsrahmen aller Knoten und setzt das viewBox mit 60px Abstand.
  6. JSON herunterladen: Serialisiert das DIAGRAM-Objekt als formatiertes JSON und löst einen Dateidownload aus.

Erstellen eines neuen Diagramms

Wenn der Benutzer ein neues Flussdiagramm oder UI-Mockup wünscht:

  1. Lies die Vorlage: Lies die HTML-Vorlagenreferenzdatei, um den aktuellen Renderer-Code zu erhalten
  2. Analysiere die Anfrage: Identifiziere Knoten (Schritte, Entscheidungen, Fehler) und Kanten (Verbindungen)
  3. Weise Positionen zu mithilfe der Layout-Regeln (Raster von oben nach unten, Standardabstände)
  4. Wende Farben an mithilfe der Farbpalette (Endknoten = grün, Entscheidungen = bernsteinfarben, Fehler = rot, usw.)
  5. Erzeuge die vollständige HTML-Datei: Kopiere die Vorlagenstruktur, ersetze das DIAGRAM-Objekt mit den neuen Daten
  6. Speichere sie unter docs/diagrams/{kebab-case-name}.html
  7. Teile dem Benutzer mit: "Öffne docs/diagrams/{name}.html in deinem Browser, um das Diagramm anzuzeigen."

Dateibenennung

  • Speicherort: docs/diagrams/{name}.html
  • Format: kebab-case.html (z. B. docs/diagrams/upload-flow.html, docs/diagrams/checkout-screen.html)
  • Setze meta.updated auf das heutige ISO-Datum

Aktualisieren eines vorhandenen Diagramms

Wenn der Benutzer ein Diagramm ändern möchte:

  1. Lies die vorhandene HTML-Datei
  2. Extrahiere das DIAGRAM-Objekt aus dem <script>-Block
  3. Ändere die Knoten/Kanten wie gewünscht
  4. Aktualisiere meta.updated auf das heutige Datum
  5. Erzeuge die vollständige HTML-Datei mit den aktualisierten Daten neu (lies die Vorlage für den neuesten Renderer erneut)
  6. Speichere sie zurück unter demselben Pfad

Lesen eines Diagramms

Wenn du gebeten wirst, ein Diagramm zu analysieren oder zu beschreiben:

  1. Lese die HTML-Datei
  2. Finde den Block const DIAGRAM = { ... };
  3. Liste Knoten nach Typ und Bezeichnung auf
  4. Verfolge Kanten, um den Fluss in natürlicher Sprache zu beschreiben
  5. Hebe Entscheidungspunkte und ihre Verzweigungen hervor

Beispiele

"Erstelle ein Flussdiagramm für den Login-Ablauf"

Aktion: Erstelle docs/diagrams/login-flow.html mit:

  • start (Kreis, grün) → enter_credentials (Box) → validate (Raute, bernsteinfarben)
  • validate → ja/links → dashboard (Kreis, grün)
  • validate → nein/rechts → show_error (Notiz, rot) → gestrichelter Pfeil zurück zu enter_credentials

"Aktualisiere das Einstellungs-Mockup, um einen Dark-Mode-Umschalter hinzuzufügen"

Aktion: Lese docs/diagrams/settings-screen.html, extrahiere DIAGRAM, füge einen neuen Box-Knoten "section_dark_mode" mit der Bezeichnung "Dark Mode" nach dem Abschnitt "Theme" hinzu, aktualisiere meta.updated, erzeuge das HTML neu.

"Füge Schritt 3 des Upload-Ablaufs eine Fehlerbehandlung hinzu"

Aktion: Lese das HTML, finde Schritt 3 im Knoten-Array, füge rechts einen Fehlerhinweis-Knoten hinzu, füge eine gestrichelte rote Kante von Schritt 3 zum Fehlerhinweis hinzu, erzeuge neu.

Wichtige Einschränkungen

  • Keine Abhängigkeiten: Kein npm, keine CDN-Links, keine externen Skripte/Styles
  • Funktioniert offline: Muss ohne Internetzugang rendern
  • Einzeldatei: Jedes Diagramm ist EINE .html-Datei
  • Browser-nativ: Nur standardmäßiges HTML5, CSS3, SVG und Vanilla ES6+ JavaScript
  • LLM-freundlich: Das DIAGRAM-JSON muss sauber formatiert sein, nicht minimiert

Selbstwartung

Wenn du beim Erstellen von Diagrammen ein nützliches Muster entdeckst, einen neuen Layout-Trick, eine Farbe, die für einen bestimmten Zweck gut funktioniert, eine Rendering-Verbesserung – aktualisiere diese Skill-Datei, um sie aufzunehmen. Halte den Skill genau und handlungsorientiert.

Verwandte Skills