Communitygithub.com

Workflow-Visualizer

Erklärt einen Workflow detailliert als visuelle Seite (Symbollegende, Infoboxen, greifbare Erklärungen) und wählt die Form des Diagramms basierend auf der Struktur des Prozesses. Verwende dies, wenn ein Workflow, Prozess oder Verfahren das Thema ist UND der Nutzer mehr Details wünscht, z. B. „detaillierter“, „Schritt für Schritt“, „wie genau funktioniert das“, „erkläre den Workflow noch einmal“. Verwende es nicht, wenn „Workflow“ nur beiläufig erwähnt wird oder eine kurze Antwort ausreicht.

Was ist Workflow-Visualizer?

Der Workflow-Visualizer ist ein Skill für KI-Agenten (z. B. Claude Code, Cursor, Codex), der Arbeitsabläufe, Prozesse oder Verfahren in eine klare, visuelle Darstellung umwandelt, anstatt sie nur in Text zu beschreiben. Er analysiert die Struktur des Workflows – Entscheidungen, Schleifen, parallele Abläufe oder zeitliche Abhängigkeiten – und wählt automatisch die am besten passende Diagrammform (z. B. Flussdiagramm, Zeitstrahl, Spuren, Zyklus). Jeder Schritt wird mit Symbolen aus einer konsistenten Legende, Zeitangaben, Titeln und optionalen Infoboxen („Wichtig“ oder „Konkret“) versehen. Die Ausgabe ist eine eigenständige HTML-Seite, basierend auf einer Vorlage (`assets/base-template.html`), mit mobile-optimierten, papierähnlichen Styling-Richtlinien. Der Skill ersetzt ausführliche Textantworten, fügt sich aber nicht in kurze Konversationen ein. Er ist ideal für Entwickler und Prozessverantwortliche, die komplexe Abläufe transparent und nachvollziehbar darstellen müssen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jirispataart-deve/workflow-visualizer/tree/HEAD

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Workflow-Visualizer?

Wenn jemand einen Workflow im Detail verstehen möchte, reicht Fließtext selten aus. Ein Prozess hat eine Reihenfolge, Übergaben, Entscheidungen und Wartezeiten. Eine passende Grafik macht das auf einen Blick lesbar. Sie ersetzt die lange Textantwort, anstatt sie zu ergänzen.

Die Form wird frei gewählt. Keine Form hat Vorrang, weder der Zeitstrahl noch eine andere. Die Struktur des Workflows entscheidet.

Wann dieser Skill angewendet wird

Zwei Bedingungen müssen zusammen erfüllt sein:

  1. Der Kontext ist ein Workflow, Prozess oder Verfahren (der eigene des Nutzers, eines, das besprochen wurde, oder eines, das von Grund auf erklärt werden muss).
  2. Der Nutzer wünscht mehr Tiefe: „im Detail“, „genauer“, „Schritt für Schritt“, „noch einmal erklären“, „wie läuft das ab“.

Wenn das Wort „Workflow“ nur beiläufig fällt und die Frage schnell beantwortet ist, antworte kurz im Chat. Eine Grafik für jede beiläufige Erwähnung entwertet sie.

Ablauf

  1. Den Prozess klären. Den Prozess aus dem Gespräch, aus Dateien oder aus Quellen nehmen, die der Nutzer nennt. Wenn etwas Wesentliches fehlt, kurz einmal nachfragen. Keine Schritte, Dauern oder Werkzeuge erfinden. Alles, was nicht verifiziert ist, wird mit „Offen“ markiert.
  2. Die Struktur lesen, dann die Form wählen. Siehe den nächsten Abschnitt. Im Chat einen Satz sagen, welche Form gewählt wurde und warum. Der Nutzer kann mit einem Wort widersprechen.
  3. Gliedern. Insgesamt 4 bis 10 Schritte, gruppiert in 2 bis 4 Phasen oder Spuren. Mehr verwässert die Grafik; fasse Unterprozesse stattdessen zusammen.
  4. Jeden Schritt befüllen.
    • Zeitmarker oder Position: eine reale Dauer, ein Zeitpunkt oder die Reihenfolge („Schritt 3“). Keine geschätzten Uhrzeiten.
    • Ein Symbol aus der Legende.
    • Ein Titel (Substantiv, kurz) und ein bis zwei Sätze, was passiert und warum.
    • Optional Wichtig-Box: nur wenn eine Information den Prozess entscheiden kann oder scheitern lässt (Voraussetzung, Fehlerquelle, Freigabe).
    • Optional Konkret-Box: ein greifbares Bild, Beispiel oder Analogie, das einen abstrakten Schritt fassbar macht. Das Bild erklärt etwas; es schmückt nicht.
  5. Die Legende aufbauen. Nur die Symbole, die in der Grafik vorkommen, plus die Elemente der gewählten Form. Die Legende steht oben.
  6. Als Seite ausliefern. Sie aus assets/base-template.html aufbauen (Tokens, Kopfzeile, Legende, Boxen) und die Struktur der gewählten Form nach references/shapes.md hinzufügen. Für das Flussdiagramm gibt es ein fertiges Beispiel in assets/flowchart-example.html: dessen CSS wiederverwenden und den Inhalt ersetzen. Die Seite mit dem Namen des Workflows betiteln, z. B. „Dokumentenfreigabefluss“. Wenn die Umgebung Seiten oder Artefakte veröffentlichen kann, dort veröffentlichen; andernfalls eine eigenständige HTML-Datei ausliefern.
  7. Im Chat antworten. Ein oder zwei Sätze: die gewählte Form mit Begründung und etwaige offene Punkte. Den Inhalt der Grafik nicht wiederholen.

Die Form wählen

Zuerst die Struktur des Workflows lesen, dann entscheiden. Diese Fragen helfen:

  • Gibt es Entscheidungen, deren Ergebnis zurückführt (eine Schleife), oder deren Pfade wieder zusammentreffen, und soll der Leser den Pfad mit dem Finger nachverfolgen können? → Flussdiagramm
  • Teilen sich Pfade an Entscheidungen und enden an verschiedenen Orten, ohne zurückzukehren? → Verzweigung
  • Tragen mehrere Personen, Werkzeuge oder Rollen Teile des Prozesses, liegt die Schwierigkeit in den Übergaben, und gibt es keine Schleife? → Spuren
  • Beginnt der Prozess nach dem letzten Schritt unverändert von neuem, oder speist das Ergebnis den nächsten Durchlauf, ohne dass dazwischen Entscheidungen getroffen werden? → Zyklus
  • Laufen Stränge gleichzeitig und müssen irgendwo zusammenkommen? → Parallele Spuren
  • Ist der Prozess im Kern eine zeitliche Abfolge von Schritten mit Wartezeiten, Fristen oder Dauern, die wichtig sind? → Zeitstrahl
  • Mischt der Workflow mehrere Eigenschaften? Diejenige wählen, bei der der Leser am wahrscheinlichsten einen Fehler macht. Die sekundäre Eigenschaft wird eine Infobox oder ein Orts-Tag: Ein Flussdiagramm kann zeigen, wo ein Schritt stattfindet, ohne Spuren zu benötigen.

Eine Schleife ist der häufigste Grund, die Form zu wechseln. Sie in einer Infobox zu verstecken, begräbt sie, und genau dort stolpern Leser. Wenn es eine gibt, ist das Flussdiagramm meist die ehrlichste Form, auch wenn Spuren oder der Zeitstrahl auf den ersten Blick passend aussehen.

Nicht nach Aussehen oder Gewohnheit wählen. Eine Form, die nicht zur Struktur passt, verfälscht den Prozess: Eine Achse verbirgt Alternativen, Spuren ohne echte Übergaben sind Dekoration.

Die genauen Bauregeln für jede Form stehen in references/shapes.md. Nur den Abschnitt der gewählten Form lesen.

Symbole

Alle eckig, keine Kreise. Die Formen werden mit CSS gezeichnet, nicht mit Zeichen, damit sie überall gleich aussehen.

SymbolFormBedeutung
Aktiongefülltes Quadratetwas wird getan oder erzeugt
Entscheidungleeres Quadratder Fluss verzweigt sich hier
PrüfpunktRautePrüfung, Abnahme, Freigabe
ÜbergabeDreieckErgebnis geht an eine Person, ein Werkzeug oder eine Phase
Wartenwaagerechter Balkennichts geschieht aktiv, Zeit vergeht
Offengestricheltes QuadratInformation fehlt oder ist ungeprüft

Weitere Symbole nur hinzufügen, wenn der Workflow sie wirklich benötigt, und sie in der Legende erklären.

Gestaltung

Die Vorlage bringt ein neutrales Standard-Design mit: warmer Papierhintergrund, fast schwarze Tinte, eine helle Akzentfarbe nur als Fläche, und die System-Schriftart. Alle Farben sind Tokens in :root. Wenn der Nutzer eine Marke oder ein Designsystem hat, nur diese Tokens ändern; die Struktur nicht umgestalten.

  • Papier als Hintergrund, Tinte für Titel, Graphit für Fließtext, ein ruhiger Farbton für ruhige Flächen, Haarlinien für Linien.
  • Der Akzent wird nur als Fläche verwendet, nie als Text- oder Linienfarbe. Text darauf ist immer Tinte. Höchstens ein großes Akzentband pro Seite; die kleinen Markierungsbalken (10px) unter Phasen- und Spurentiteln dürfen wiederholt werden.
  • Eine Schriftfamilie. Hierarchie durch Gewicht und Buchstabenabstand; Buchstabenabstand nur bei Großbuchstaben.
  • Keine Schatten, Farbverläufe, abgerundeten Ecken, Emojis oder Ausrufezeichen. Listen verwenden Tintenquadrate. Verbindungen sind gerade Linien mit rechten Winkeln, 2px Tinte.
  • Die Seite bleibt einfarbig auf Papier. Alle Farben werden explizit gesetzt, damit sie in hellen und dunklen UIs gleich gelesen werden.
  • Mobile First, kein horizontales Scrollen der Seite. Alles, was breiter sein muss (Spuren), scrollt in einem eigenen Container.

Keine neuen Farben, Schriftarten oder Formen erfinden. Wenn dem System etwas fehlt, die Lücke benennen und innerhalb der Tokens lösen.

Sprache

Die Grafik in der Sprache schreiben, die der Nutzer verwendet. Sachlich, substantivbasiert und kurz halten. Kein Füllstoff, keine Trendsprache. Erklärungen dürfen lebendig, aber präzise sein: ein starkes Bild statt drei schwacher.

Checkliste vor der Auslieferung

  • Die Form folgt der Struktur des Workflows, und der Chat-Satz nennt den Grund.
  • Jede Schleife ist als Pfad gezeichnet und nicht nur im Text erwähnt.
  • Jede Zeitangabe ist dokumentiert oder nur als Reihenfolge markiert.
  • Alles, was nicht verifiziert ist, trägt das Symbol „Offen“.
  • Alle Symbole in der Grafik erscheinen in der Legende, und keine anderen.
  • Der Akzent wird nur als Fläche verwendet, nie als Text oder Linie.
  • Kein Text läuft über den Rand, nicht einmal bei 400px Breite.
  • Der Chattext wiederholt nicht den Inhalt der Grafik.

Verwandte Skills