CommunitySchreiben & Editierengithub.com

Spotlight-Revenue/drawio-diagrammer-skill

Erzeuge ästhetisch ansprechende draw.io-Diagramme mit einem obligatorischen visuellen QA-Durchlauf – dein Agent baut Diagramme, die tatsächlich richtig aussehen.

Was ist drawio-diagrammer-skill?

Diese Fähigkeit befähigt KI-Agenten (wie Claude Code, Cursor, Codex usw.), professionelle draw.io-Diagramme zu generieren, die nicht nur funktional, sondern auch optisch ansprechend sind. Der entscheidende Unterschied zu einfachen Diagrammgeneratoren ist der eingebaute visuelle Qualitätssicherungs-Durchlauf: Nach dem Export als PNG wird das Bild automatisch geprüft, bevor die Aufgabe als abgeschlossen gilt. Der Skill erkennt automatisch den Diagrammtyp aus der Benutzeranfrage (z.B. Flussdiagramm, ERD, Systemarchitektur, UML) und lädt die passenden Referenzdateien mit layout-spezifischen Anweisungen. Er erzwingt universelle Box-Standards, hartcodierte Positionen (da draw.io kein Auto-Layout unterstützt) und eine strukturierte Arbeitsweise: Planung aller Elemente, schrittweise XML-Erstellung, Export und visuelle Prüfung. Der Agent wird angewiesen, den Benutzer nach Abschluss nach dem gewünschten Ausgabeformat zu fragen (PNG, SVG, PDF, .drawio). Dies ist ideal für Entwicklerteams, die konsistente, qualitativ hochwertige Diagramme in ihre CI/CD-Pipelines oder Agenten-Workflows integrieren möchten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add Spotlight-Revenue/drawio-diagrammer-skill

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

draw.io Diagrammer Skill

Wann dieser Skill verwendet wird

  • Benutzer fordert ein Flussdiagramm, eine Prozesskarte oder ein Arbeitsablaufdiagramm an
  • Benutzer fordert ein ERD, Datenbankdiagramm oder Entity-Relationship-Modell an
  • Benutzer fordert ein Architektur-, System- oder Komponentendiagramm an
  • Benutzer fordert ein Klassen-, Sequenz- oder UML-Diagramm an
  • Benutzer sagt „draw.io", „Diagramm", „Flussdiagramm", „visualisiere diesen Prozess"
  • Benutzer bittet darum, eine bestehende .drawio-Datei zu aktualisieren, zu reparieren oder zu erweitern

ZWINGEND – Vor dem Generieren lesen

  1. Diagrammtyp zuerst erkennen – siehe diagram-types/ Referenzen, bevor XML geschrieben wird
  2. Universelle Box-Standards anwenden – siehe references/box-style-standards.md
  3. Alle Positionen sind fest codiert – es gibt kein Auto-Layout in draw.io XML
  4. Nach jedem Export den visuellen Prüf-Durchlauf ausführen – siehe references/visual-review-protocol.md
  5. Nie ohne visuelle Prüfung als abgeschlossen erklären – PNG exportieren, lesen, korrigieren, wiederholen

Diagrammtyp-Erkennung

Benutzer sagt...Referenzdatei
„Flussdiagramm", „Prozess", „Schritte", „Workflow", „SOP"references/diagram-types/flowchart.md
„ERD", „Datenbank", „Tabellen", „Entitäten", „Fremdschlüssel"references/diagram-types/erd.md
„Architektur", „System", „Komponenten", „Dienste"references/diagram-types/layout.md
„Klasse", „UML", „Vererbung", „Methoden", „Attribute"references/diagram-types/class.md
„Sequenz", „Interaktion", „Lebenslinie", „Akteur-Aufrufe"references/diagram-types/sequence.md

Standard-Generierungs-Workflow

Schritt 1 – Typ-Referenz laden

Lies die korrekte references/diagram-types/-Datei, bevor du XML schreibst.

Schritt 2 – Alle Elemente planen

Liste jeden Knoten, jede Verbindung und jeden Abschnitt auf, bevor du mit dem Codieren beginnst. Keine improvisierten Layouts während des Baus.

Schritt 3 – Universelle Box-Standards anwenden

Jeder Knoten muss die universellen Abstandsattribute aus references/box-style-standards.md enthalten.

Schritt 4 – Ausgabeordner erstellen und XML schreiben

mkdir -p ./diagrams

Speichern unter:

./diagrams/<diagram-name>.drawio

Checkliste vor dem Speichern:

  • Alle mxCell-Elemente haben eindeutige, aufsteigende numerische IDs
  • Universeller Box-Abstand auf jeden Knotenstil angewendet: spacingLeft=12;spacingRight=12;spacingTop=10;spacingBottom=10;verticalAlign=top;
  • Pfeile verwenden verkettetes Routing, kein Fan-Out von einer Quelle zu vielen Zielen
  • Mindestens 15–20 px Abstand zwischen zwei Boxen (überprüfe untere Kante der Unterpunktliste vs. obere Kante des nächsten Abschnitts)
  • Höhen mit der Formel aus box-style-standards.md berechnet (×16px pro Zeile bei fontSize=10)
  • Breite Textfelder (Notizen, Beschreibungen) sind 530px+ breit – nicht 460px oder weniger
  • Kein literal \n in value-Attributen – verwende &#xa; für Zeilenumbrüche
  • verticalAlign=top bei allen mehrzeiligen Inhaltsboxen

Schritt 5 – PNG exportieren und visuellen Prüf-Durchlauf ausführen

/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output ./diagrams/<name>.png --scale 2 --border 30 ./diagrams/<name>.drawio

Dann das vollständige Protokoll in references/visual-review-protocol.md befolgen.

Schritt 6 – Ausliefern

Sende dem Benutzer zuerst das PNG. Bei größeren Diagrammen sende Abschnitts-Screenshots (oben, Mitte, unten) vor dem vollständigen Bild.

Frage dann, welche zusätzlichen Formate gewünscht werden:

Das Diagramm ist fertig. Welches Format möchtest du?

1 – PNG-Bild (bereit zum Anzeigen)
2 – .drawio-Datei (bearbeitbar in draw.io)
3 – SVG (skalierbare Vektorgrafik)
4 – PDF
5 – Alle oben genannten

Antworte mit der/den Nummer(n) deiner Wahl.

Für Drive-Zustellung oder benutzerdefinierte Ausgabepfade folge references/workflow-sop.md.


CLI-Referenz

# macOS – PNG exportieren (Standard)
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output <out.png> --scale 2 --border 30 <file.drawio>

# macOS – PNG in hoher Auflösung exportieren
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output <out.png> --scale 3 --border 30 <file.drawio>

# macOS – SVG exportieren
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format svg --output <out.svg> <file.drawio>

# macOS – PDF exportieren
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format pdf --output <out.pdf> <file.drawio>

# Linux / headless – PNG exportieren
xvfb-run -a drawio --export --format png --output <out.png> --scale 2 --border 30 <file.drawio>

# Linux / headless – SVG exportieren
xvfb-run -a drawio --export --format svg --output <out.svg> <file.drawio>

Verwandte Skills