CommunityBildgithub.com

svg-creator

Erstellt handgezeichnete SVG-Flussdiagramme und Diagramme aus Benutzerbeschreibungen. Unterstützt Seitenverhältnis-Angaben (16:9, 4:3, 1:1, A4 oder benutzerdefinierte W:H-Verhältnisse).

Was ist svg-creator?

Das SVG Creator-Skill erzeugt SVG-Diagramme mit einem unverwechselbaren handgezeichneten Stil – unregelmäßige Kanten, Schraffurfüllungen und Handschrift-Fonts – im Gegensatz zu sterilen Unternehmensdiagrammen. Es unterstützt voreingestellte Seitenverhältnisse wie 16:9, 4:3, 1:1, A4 sowie benutzerdefinierte Verhältnisse und passt das Layout automatisch an (horizontal für Breitbild, vertikal für Hochformat). Der Kern des handgezeichneten Effekts basiert auf einer `feTurbulence`- und `feDisplacementMap`-Filterkombination, die auf Formen angewendet wird, aber niemals auf Pfeile oder Verbindungslinien. Das Skill verwendet genau festgelegte Google Fonts (Ma Shan Zheng für Chinesisch, Comic Sans MS für Englisch) und stellt sicher, dass alle Diagramme korrekte Pfeilverbindungen, lesbare Beschriftungen und eine visuelle Ausgewogenheit aufweisen. Es ist ideal für Plattformen wie Claude Code, Cursor und Codex, wenn Benutzer Flussdiagramme, Architekturdiagramme, Prozessübersichten, Mindmaps oder andere visuelle Darstellungen von Arbeitsabläufen anfordern.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/retrocognition023/my-agent-skills/tree/HEAD/skills/svg-creator

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

SVG Handgezeichneter Flussdiagramm-Ersteller

Du verwandelst mündliche/schriftliche Beschreibungen von Prozessen, Systemen oder Arbeitsabläufen in wunderschöne handgezeichnete SVG-Flussdiagramme. Die Ausgabe sollte so aussehen, als hätte jemand sie mit bunten Markern auf ein Whiteboard skizziert – kein starres Unternehmensdiagramm.

Seitenverhältnis

Jedes SVG muss ein definiertes Seitenverhältnis haben. Der Benutzer kann es explizit angeben, oder es wird standardmäßig 16:9 (präsentationsfreundlich) verwendet. Das Seitenverhältnis bestimmt die viewBox und die width/height-Attribute des <svg>-Elements.

Voreinstellungen

NameVerhältnisTypische viewBoxAm besten geeignet für
16:916:90 0 1600 900Folien, Präsentationen, Breitbildanzeigen
4:34:30 0 1200 900Traditionelle Folien, Dokumentation
1:11:10 0 1000 1000Soziale Medien, quadratische Miniaturansichten
A4~1:1.4140 0 1000 1414Druckbare Dokumente, vertikale Poster
A4-Querformat~1.414:10 0 1414 1000Druckbare Querformat-Dokumente

Benutzerdefinierte Verhältnisse

Der Benutzer kann jedes Verhältnis als W:H angeben (z.B. 3:2, 21:9). Berechne die viewBox, indem du so skalierst, dass die längere Dimension ~1400-1600px beträgt und die kürzere Dimension dem Verhältnis folgt.

Wie das Seitenverhältnis das Layout beeinflusst

  • Breite Formate (16:9, 21:9): Bevorzuge von links nach rechts verlaufende Flüsse. Mehr horizontaler Platz bedeutet, dass du 4-6 Elemente bequem in eine Reihe setzen kannst. Vertikales Stapeln verschwendet Platz.
  • Hohe Formate (A4, 9:16): Bevorzuge von oben nach unten verlaufende Flüsse. Nutze den gesamten vertikalen Raum; begrenze horizontale Elemente auf 2-3 pro Zeile.
  • Quadratisch (1:1): Ausgewogen – funktioniert sowohl für radiale Layouts als auch für 2×2/3×3-Gitter. Gut für Konzeptkarten ohne starke Richtungsvorgabe.
  • 4:3: Ein guter Mittelweg. Funktioniert für beide Ausrichtungen, bevorzugt aber leicht die Horizontale.

Bei der Layout-Planung in Schritt 2 überprüfe immer zuerst das Seitenverhältnis und wähle eine Layout-Richtung, die den verfügbaren Platz natürlich nutzt. Erzwinge keinen Links-nach-rechts-Fluss auf einer hohen Leinwand oder einen Oben-nach-unten-Fluss auf einer Breitbild-Leinwand.

Standardverhalten

Wenn der Benutzer kein Verhältnis angibt, verwende 16:9 – es funktioniert gut für die meisten Diagramme und ist sofort in Präsentationen verwendbar. Wenn der Inhalt eindeutig ein anderes Verhältnis benötigt (z.B. eine sehr hohe Hierarchie), schlage vor, es zu ändern, überschreibe es aber nicht stillschweigend.

Gesamter Arbeitsablauf

  1. Verstehen & Zerlegen – Analysiere die Benutzerbeschreibung in einzelne Module/Schritte/Akteure
  2. Seitenverhältnis bestimmen – Verwende das vom Benutzer angegebene Verhältnis oder standardmäßig 16:9
  3. Layout planen – Entscheide die visuelle Struktur, angepasst an das Seitenverhältnis
  4. SVG generieren – Schreibe sauberes SVG mit handgezeichnetem Stil und korrekter viewBox
  5. Pfeile überprüfen – Selbstkontrolle, dass jede Verbindung zwischen Knoten einen sichtbaren Pfeil hat
  6. Ausgabe & Iterieren – Gib dem Benutzer Dateipfade, verfeinere basierend auf Feedback

Schritt 1: Verstehen & Zerlegen

Wenn der Benutzer einen Prozess beschreibt, extrahiere:

  • Akteure/Rollen – Wer sind die Teilnehmer? (z.B. „PM", „System", „Benutzer")
  • Stufen/Phasen – Was sind die Hauptgruppierungen? (z.B. „Eingabephase", „Verarbeitungsphase")
  • Schritte – Was sind die einzelnen Operationen innerhalb jeder Stufe?
  • Verbindungen – Wie fließen die Dinge? Sequentiell? Verzweigungen? Rückkopplungsschleifen?

Wenn die Beschreibung mehrdeutig ist, stelle vor dem Zeichnen klärende Fragen.

Schritt 2: Layout planen

Wähle ein Layout, das zur Prozessstruktur passt:

  • Von oben nach unten: Einfache sequentielle Abläufe
  • Abschnitte von links nach rechts: Wenn es unterschiedliche Phasen gibt, die einander übergeben
  • Gruppierte Boxen: Wenn Akteure unterschiedliche Schrittmengen besitzen
  • Rückkopplungsschleifen: Verwende gestrichelte Pfeile, die außen herum führen

Skizziere grob die Begrenzungsrechtecke im Kopf, bevor du SVG-Koordinaten schreibst:

  • Gib jedem Abschnitt genügend Platz (typischerweise 400×500px pro Hauptgruppe)
  • Lasse 40-60px Lücken zwischen Elementen für Pfeile
  • Plane eine Leinwandgröße, die alles mit 30-50px Rändern unterbringt

Schritt 3: SVG generieren – Die Kerntechnik

3.1 Handzeichnungseffekt: Die feTurbulence + feDisplacementMap-Kombination

Dies ist das Herzstück des skizzenhaften Aussehens. Es verschiebt Pixel mit Perlin-Rauschen und lässt gerade Linien und scharfe Ecken handgezeichnet aussehen.

<defs>
  <!-- Für Formen (Boxen, Ovale, große Container) – moderate Unregelmäßigkeit -->
  <filter id="sketchy" x="-3%" y="-3%" width="106%" height="106%">
    <feTurbulence type="turbulence" baseFrequency="0.03" numOctaves="4" seed="2" result="turbulence"/>
    <feDisplacementMap in="SourceGraphic" in2="turbulence" scale="2.5"
                       xChannelSelector="R" yChannelSelector="G"/>
  </filter>
</defs>

Wichtig: Wende KEINEN Filter auf Pfeile/Verbindungslinien an. Der feDisplacementMap-Filter – selbst bei niedriger Skalierung – führt dazu, dass dünne Linien in den meisten SVG-Renderern unsichtbar oder fragmentiert werden. Pfeile müssen OHNE jegliches Filterattribut gezeichnet werden. Das handgezeichnete Gefühl für Pfeile entsteht durch die Verwendung von stroke-width="3" oder dicker, was neben den gefilterten Formen bereits organisch genug aussieht.

3.2 Schraffur-Füllmuster

Diagonale Linienmuster simulieren handgezeichnete Kreuzschraffur:

<pattern id="hatch-blue" width="8" height="8" patternUnits="userSpaceOnUse"
         patternTransform="rotate(-45)">
  <line x1="0" y1="0" x2="0" y2="8" stroke="#a0c4f0" stroke-width="1.5" opacity="0.5"/>
</pattern>

Überlagere das Schraffurmuster mit einer halbtransparenten Volltonfüllung für Lesbarkeit:

<!-- Schraffur-Ebene -->
<rect ... fill="url(#hatch-blue)" stroke="#3b82d0" stroke-width="3.5" filter="url(#sketchy)"/>
<!-- Lesbarkeits-Überlagerung -->
<rect ... fill="#dbeafe" opacity="0.25"/>

Erstelle ein Schraffurmuster pro Farbschema, das im Diagramm verwendet wird.

3.3 Handschrift-Fonts – VERWENDE GENAU DIESE, KEINE ERSATZE

Schriftarten müssen in allen Diagrammen konsistent sein. Verwende diesen exakten <style>-Block – verwende nicht Caveat, Patrick Hand oder irgendeine andere Schriftart. Dies ist eine harte Anforderung.

Für Diagramme mit chinesischem Text:

<style>
  @import url('https://fonts.googleapis.com/css2?family=Ma+Shan+Zheng&amp;family=ZCOOL+KuaiLe&amp;display=swap');
  /* Chinesischer Text – Ma Shan Zheng Pinselschrift-Stil */
  text {
    font-family: 'Ma Shan Zheng', 'ZCOOL KuaiLe', 'STKaiti', 'KaiTi', cursive;
  }
  /* Englische Beschriftungen (Code-Namen, technische Begriffe wie /task-add, Backlog, YAML) */
  .label-en {
    font-family: 'Comic Sans MS', 'Segoe Print', 'Bradley Hand', cursive, sans-serif;
  }
</style>

Für Diagramme vollständig auf Englisch:

<style>
  @import url('https://fonts.googleapis.com/css2?family=Ma+Shan+Zheng&amp;display=swap');
  text {
    font-family: 'Comic Sans MS', 'Segoe Print', 'Bradley Hand', cursive, sans-serif;
  }
</style>

Wende class="label-en" auf englische Textelemente in chinesischen Diagrammen an. Verwende niemals Caveat, Patrick Hand, Indie Flower oder eine andere Handschrift-Schriftart – bleibe bei Ma Shan Zheng für Chinesisch und Comic Sans MS für Englisch.

3.4 Pfeilmarkierungen

Definiere farbige Pfeilmarkierungen, die zum Thema jedes Abschnitts passen:

<marker id="arrow-blue" viewBox="0 0 12 12" refX="10" refY="6"
        markerWidth="10" markerHeight="10" orient="auto-start-reverse">
  <path d="M 2 3 L 10 6 L 2 9 Z" fill="#3b82d0"/>
</marker>

Verwende marker-end="url(#arrow-blue)" auf Verbindungslinien. Für gestrichelte Verbindungen (die indirekten/optionalen Fluss darstellen), füge stroke-dasharray="14 10" hinzu.

3.5 Formvokabular

KonzeptSVG-FormBeispiel
Akteur/Rolle<ellipse>PM, Benutzer, System
Prozessschritt<rect rx="6">/task-add, build step
Container/Phase<rect rx="20"> groß, mit Schraffur„1. 需求录入"-Abschnitt
Daten/Ausgabe<path> ParallelogrammBacklog, Bericht
Entscheidung<path> RauteJa/Nein-Verzweigung
Äußere Grenze<rect> mit stroke-dasharraySystemgrenze, Rückkopplungsschleife

3.6 Farbschemata

Jeder Hauptabschnitt/Akteur sollte seine eigene Farbe haben. Gute Paletten:

  • Blau: stroke="#3b82d0", fill="#dbeafe", text="#1e40af", hatch="#a0c4f0"
  • Orange/Gelb: stroke="#d4920a", fill="#fef3c7", text="#92400e", hatch="#f0d080"
  • Grün: stroke="#2d8a4e", fill="#d1fae5", text="#065f46", hatch="#5a9e6f"
  • Lila: stroke="#7c3aed", fill="#ede9fe", text="#5b21b6", hatch="#b4a0e8"
  • Grau (für gestrichelte Verbinder): stroke="#777"

3.7 Elemente verbinden – KEIN FILTER AUF PFEILEN

Dies ist der kritischste Abschnitt. Pfeile, die brechen oder verschwinden, ruinieren das gesamte Diagramm.

Regeln:

  1. Jeder Pfeil <line>- oder <path>-Verbinder muss stroke-width="3" oder dicker haben
  2. Jeder Pfeil muss ein marker-end="url(#arrow-xxx)"-Attribut haben
  3. Füge NIEMALS filter="url(#sketchy)" oder filter="url(#sketchy-line)" zu einem Pfeil hinzu – Filter machen dünne Linien unsichtbar
  4. Lasse einen 5-10px Abstand zwischen dem Formrand und dem Pfeilanfangs-/Endpunkt, damit die Pfeilspitze deutlich sichtbar ist
  5. L-förmige Pfeile müssen an der Mittelachse des Ziels enden – wenn die Zielform bei x=600 zentriert ist, muss das letzte Segment des Pfeils bei x=600 enden, nicht bei einem Versatz. Berechne die Zielmittelpunktkoordinaten aus seinem cx/cy (für Ellipsen) oder x + width/2, y (für Rechtecke)
  6. Pfeilbeschriftungen dürfen die Pfeillinie nicht überlappen – platziere Beschriftungen 15-20px über oder unter dem Pfeilpfad, niemals auf derselben y-Koordinate wie ein horizontaler Pfeil oder derselben x wie ein vertikaler
<!-- Durchgezogener Pfeil (direkter Fluss) – KEIN Filterattribut -->
<line x1="260" y1="390" x2="260" y2="425"
      stroke="#3b82d0" stroke-width="3"
      marker-end="url(#arrow-blue)"/>

<!-- Gestrichelter Pfeil (indirekter/optionaler Fluss) – KEIN Filterattribut -->
<line x1="460" y1="440" x2="590" y2="440"
      stroke="#777" stroke-width="3" stroke-dasharray="14 10"
      marker-end="url(#arrow-gray)"/>

<!-- L-förmiger oder gekrümmter Pfad – KEIN Filterattribut -->
<path d="M 40 700 L 40 50 L 100 50" fill="none"
      stroke="#2d8a4e" stroke-width="4" stroke-dasharray="16 10"
      marker-end="url(#arrow-green)"/>

Schritt 4: Pfeile überprüfen (Selbstkontrolle)

Nach dem Schreiben des SVG musst du vor dem Speichern der Datei jede Verbindung überprüfen. Dieser Schritt fängt den häufigsten und schädlichsten Fehler – fehlende Pfeile.

Vorgehen:

  1. Alle Verbindungen auflisten: Gehe zurück zur Zerlegung aus Schritt 1 und zähle jeden Pfeil auf, der vorhanden sein sollte. Schreibe sie als Checkliste auf:

    Verbindungs-Checkliste:
    - [ ] Knoten A → Knoten B (Bestellung aufgeben)
    - [ ] Knoten B → Knoten C (Bestellung bearbeiten)
    - [ ] Knoten C → Knoten D (Zahlung erfolgreich)
    ...
    
  2. Für jede Verbindung im SVG überprüfen, dass es ein <line>- oder <path>-Element gibt, dessen Koordinaten von der unteren/rechten Kante des Quellknotens zur oberen/linken Kante des Zielknotens verlaufen, UND dass es ein marker-end-Attribut hat.

  3. Auf Filterkontamination prüfen: Durchsuche das SVG nach <line oder Verbinder <path, das filter= enthält. Wenn gefunden, entferne das Filterattribut von diesem Element.

  4. Koordinaten auf Plausibilität prüfen: Überprüfe für jeden Pfeil:

    • Der Startpunkt (x1,y1) befindet sich nahe der unteren/rechten Kante der Quellform
    • Der Endpunkt (x2,y2) befindet sich nahe der oberen/linken Kante der Zielform
    • Bei L-förmigen Pfaden muss das letzte Segment am Zentrum x oder y der Zielform enden
    • Start- und Endpunkt sind unterschiedlich (keine Nulllängen-Linien)
  5. Beschriftungsplatzierung prüfen: Überprüfe für jedes Pfeilbeschriftungstextelement:

    • Das Beschriftungs-y liegt mindestens 15px über oder unter der y-Koordinate des Pfeils (bei horizontalen Pfeilen)
    • Das Beschriftungs-x liegt mindestens 15px links oder rechts der x-Koordinate des Pfeils (bei vertikalen Pfeilen)
    • Beschriftungen überlappen sich nicht mit Formboxen

Wenn eine Verbindung fehlt, füge sie vor dem Speichern hinzu.

Schritt 5: Ausgabe & Iterieren

  1. Vor dem Schreiben auf vorhandene Datei prüfen: Überprüfe vor dem Speichern, ob die Zieldatei bereits existiert. Wenn ja, hänge eine Versionssuffix an, um Überschreiben zu vermeiden:

    • Erste Datei: flowchart.svg
    • Wenn flowchart.svg existiert: speichere als flowchart-v1.svg
    • Wenn flowchart-v1.svg ebenfalls existiert: speichere als flowchart-v2.svg
    • Erhöhe weiter, bis ein ungenutzter Dateiname gefunden ist
    • Verwende ls oder test -f, um die Existenz vor dem Schreiben zu prüfen
  2. Schreibe das SVG in den ermittelten Dateipfad

  3. SVG in PNG konvertieren und visuell selbst prüfen: Öffne die Datei NOCH NICHT für den Benutzer. Konvertiere und überprüfe stattdessen zuerst das Ergebnis:

    rsvg-convert input.svg -o output.png
    

    Verwende dann das Read-Tool, um das generierte PNG-Bild anzuzeigen. Überprüfe sorgfältig auf:

    • Layoutprobleme: Überlappen sich Elemente? Wird Text abgeschnitten oder läuft er über seinen Container hinaus? Gibt es große leere Lücken oder beengte Bereiche?
    • Pfeilprobleme: Sind alle Pfeile sichtbar? Zeigen Pfeile in die falsche Richtung, kreuzen sie Formen oder erscheinen sie unterbrochen/defekt?
    • Textlesbarkeit: Ist Text lesbar und überlappt er nicht andere Elemente?
    • Gesamtbalance: Sieht das Diagramm innerhalb der Leinwand gut proportioniert aus?

    Wenn IRGENDWELCHE Probleme gefunden werden, gehe zurück und korrigiere das SVG, konvertiere erneut und überprüfe erneut. Wiederhole, bis das Diagramm die visuelle Inspektion besteht.

  4. Sobald das Diagramm die Inspektion besteht, informiere den Benutzer, dass die SVG- und PNG-Dateien bereit sind, und gib die Dateipfade an. Verwende kein open – der Benutzer könnte sich auf einem entfernten Server befinden.

  5. Sei bereit für Feedback – häufige Anfragen sind:

    • „Dieses Feld ist zu klein“ → Abmessungen vergrößern und neu positionieren
    • „Der Pfeil ist unterbrochen“ → Filter vom Pfeil entfernen, stroke-width erhöhen
    • „Die Schrift sieht nicht handgeschrieben aus“ → Google Fonts Import überprüfen, exakten font-family-String prüfen
    • „Die Farbe ist zu hell/zu dunkel“ → Opazität und Strichfarben anpassen
    • Layout-Umordnung → Koordinaten neu berechnen

Häufige Fallstricke

  • Pfeile verschwinden: Das Problem Nummer 1. Wende NIEMALS filter auf <line> oder Pfeil <path> an. Der Verschiebungsfilter macht dünne Elemente unsichtbar. Nur Formen (<rect>, <ellipse>, Container <path>) sollten Filter haben.

  • Schriftart-Inkonsistenz: Verwende immer Ma Shan Zheng für Chinesisch, Comic Sans MS für Englisch. Ersetze niemals durch Caveat, Patrick Hand, Indie Flower usw.

  • Text sieht nicht handgeschrieben aus: Der Google Fonts @import benötigt Internetzugang.

    ...

[für die Übersetzung gekürzt]

Verwandte Skills