CommunityBildgithub.com

diagram-studio

Erstelle, gestalte und verbessere Diagramme (Architekturdiagramme, Flussdiagramme, Pipelines, Systemübersichten, Agenten-Schleifen) als gestochen scharfe, editierbare PNG + SVG.

Was ist diagram-studio?

Dieses Skill ermöglicht es, bestehende Diagrammbilder (unscharf, niedrig aufgelöst, KI-generiert, überladen oder mit Wasserzeichen) originalgetreu als Vektorgrafik neu zu zeichnen und gleichzeitig zu schärfen. Es behält dabei exakt Text, Layout, Farben und Stil (handgezeichnet oder sauber/flach) bei. Zusätzlich können Diagramme in verschiedene Stile umgewandelt (z.B. handgezeichnet, Excalidraw, Whiteboard, Blueprint, Corporate, akademisch, dunkel) und auf Basis von Text, Code oder Notizen neue Diagramme erstellt werden. Das Skill unterstützt vollständig chinesische Schriftzeichen und wird über entsprechende Schlüsselwörter ausgelöst. Es ist ideal für jede Art von Kästchen-Pfeile-Text-Grafik, da es die Bildqualität auf Vektorebene verbessert, ohne die Textgenauigkeit zu beeinträchtigen. Es funktioniert in Codex, Claude Code und anderen KI-Agenten, benötigt nur Node 18+ und arbeitet ohne Netzwerk oder Installation.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/stlmx/diagram-studio/tree/HEAD

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

Diagram Studio

Verwandeln Sie eine JSON-Spezifikation in ein gestochen scharfes Diagramm. Das Aussehen ist vollständig konfigurierbar:

  • Handgezeichnet: rough.js Wackeln und Handschrift-Schriftarten.
  • Sauberer Vektor: kein Wackeln, serifenlose oder Serifenschriften, weiche Schatten.
  • Alles dazwischen.

Der gesamte Text wird in Pfade umgewandelt, sodass SVG und PNG überall identisch aussehen. Ein Linter erkennt Überlappungen, überlaufenden Text, Beschriftungen auf Rändern und Pfeile, die durch Kästchen verlaufen.

Alles ist gebündelt: Node 18+ ist die einzige Voraussetzung, kein npm install und kein Netzwerk. SKILL_DIR unten ist der absolute Pfad dieses Skill-Ordners (der Ordner, der diese Datei enthält).

node SKILL_DIR/scripts/render.mjs diagram.json --out out/     # → out/diagram.png (2x), .svg, .report.json, .tiles/

0. Ausführung in Codex, Claude Code oder einem anderen Agenten

  • SKILL_DIR:
    • In Codex erweitern Sie den kurzen Pfad des Skills mit der Skill-Roots-Tabelle (z.B. r0/diagram-studio/SKILL.md → ~/.codex/skills/diagram-studio).
    • In Claude Code ist es normalerweise ~/.claude/skills/diagram-studio.
    • Rufen Sie die Skripte immer mit diesem absoluten Pfad auf.
  • Das Betrachten der Bilder ist obligatorisch: das Original, das Raster, die Kacheln und der Vergleich.
    • Codex: Verwenden Sie das view_image-Werkzeug mit dem PNG-Pfad. render.mjs schreibt name.preview.png (≤ 1400 px) dafür, sodass Sie das Bild nicht selbst skalieren müssen; für Details verwenden Sie name.tiles/*.png.
    • Claude Code: Verwenden Sie das Read-Werkzeug.
    • Beurteilen Sie eine Ausgabe niemals nur anhand der Lint-Ausgabe.
  • Sandbox-freundlich:
    • Es wird nur node benötigt. Es gibt keine Netzwerkaufrufe und keine Installationen.
    • Ausgaben gehen nach --out; behalten Sie sie im Arbeitsbereich, z.B. ./diagram-out.
    • WebP/HEIC-Konvertierung schreibt in das temporäre Systemverzeichnis.
  • Der Benutzer hat ein Bild eingefügt statt einen Pfad anzugeben: Wenn Sie einen Anhangspfad sehen können, verwenden Sie ihn. Fragen Sie andernfalls nach dem Dateipfad, da die Werkzeuge eine echte Datei benötigen.
  • Abschluss: Listen Sie die absoluten Pfade der PNG, SVG und JSON auf, damit der Benutzer sie öffnen kann.

1. Wählen Sie den Auftrag

Benutzer möchteAuftragWeiterlesen
„Dieses Bild klarer / höher aufgelöst / sauberer machen“, „neu zeichnen / wiederherstellen / 复刻 / 高清重建“A. Vom Bild neu aufbauen. Originaltreue zuerst: den ursprünglichen Stil beibehalten, sofern nicht anders gewünschtreferences/rebuild-from-image.md (erforderlich)
„Verschönern / aufräumen / 美化 dieses Diagramm“A + Verfeinerung. Wie A, dann Hierarchie, Abstände und Ausrichtung verbessernreferences/rebuild-from-image.md
Ein neues Diagramm aus einer Beschreibung, Code oder NotizenB. Neues Diagrammreferences/spec.md
Ein anderes Aussehen („mach es handgezeichnet“, „flaches Corporate-Design“, „Blueprint“, „für ein Paper“)C. Stiländerungreferences/style-guide.md

Passen Sie den Stil eines gegebenen Bildes standardmäßig an: Handgezeichnet bleibt handgezeichnet, flach bleibt flach, und seine Farben und Schriftkategorie bleiben erhalten. Ändern Sie das Aussehen nur, wenn der Benutzer danach fragt. Voreinstellungen sind Ausgangspunkte, keine Grenzen; styleOverrides, benutzerdefinierte Paletten und benutzerdefinierte Schriftdateien ("fonts") können fast jedes Aussehen reproduzieren. Fragen Sie nur nach der Originaltreue, wenn die Anfrage wirklich mehrdeutig ist, z.B. „verschönern“ ohne Referenzstil. Standardmäßig wählen Sie originalgetreu + klarer.

Beginnen Sie mit der nächstgelegenen Vorlage in templates/: kopieren Sie sie in den Arbeitsordner und bearbeiten Sie die Kopie. Vorschauen finden Sie in assets/gallery/. Eine Vorlage ist ein Muster, kein Inhalt: Ersetzen Sie den gesamten Text und behalten Sie Zeilenumbrüche und Pfeile genau wie in Ihrer Quelle bei. --expect erfasst Reste und geänderte Formulierungen.

VorlageZeigt
dense-rebuild.jsonWiederaufbau eines dichten Architekturbildes: explizite Koordinaten, Karten, Panels, verbundene Verbinder, Inline-Beschriftungen
pipeline-rag.jsonLinks-nach-rechts-Pipeline: Zeilen mit connect, rightOf, automatisch angepasste Panels
layered-architecture-zh.jsonChinesische Schichtenarchitektur: gestapelte below-Zeilen, Fächerpfeile, Zylinder
flowchart-decision.jsonFlussdiagramm: Ellipse, Raute, Ja/Nein-Zweige, Rückkopplungspfeile
agent-loop.jsonZyklus: gebogene Pfeile, Abzeichen, Ellipsenknoten
auto-layout.jsonKeine Koordinaten: ELK-Autolayout mit Gruppen

2. Der Zyklus (jeder Auftrag)

  1. Erstellen Sie zuerst ein Inventar. Listen Sie jeden Textstring wörtlich auf (speichern Sie ihn als texts.txt, eine pro Zeile), jeden Knoten, jeden Pfeil (von → nach, Beschriftung) und jede Gruppe. Nichts wird erfunden oder weggelassen.

  2. Schreiben Sie name.json, beginnend mit einer Vorlage.

  3. Rendern Sie: node SKILL_DIR/scripts/render.mjs name.json --out AUSGABE --expect texts.txt

  4. Beheben Sie jeden FEHLER; jeder kommt mit einem konkreten →-Hinweis. Beheben Sie Warnungen (WARN), sofern sie nicht beabsichtigt sind, und unterdrücken Sie beabsichtigte Warnungen mit "ignore": ["code"] auf dem entsprechenden Element oder Pfeil.

  5. Betrachten Sie AUSGABE/name.png und AUSGABE/name.tiles/*.png und vergleichen Sie mit dem Original (scripts/compare.mjs). Führen Sie die Checkliste in prompts/visual-review.md durch; der Linter kann Bedeutung, Ausgewogenheit oder Originaltreue nicht beurteilen.

  6. Wiederholen Sie die Schritte 3–5, bis es 0 Fehler gibt und es gut lesbar ist (normalerweise 2–4 Durchläufe).

  7. Liefern Sie:

    • name.png: 2x; verwenden Sie --scale 3 für den Druck.
    • name.svg: Vektorgrafik.
    • name.json: für spätere Bearbeitungen aufbewahrt.

    Fügen Sie eine Zeile hinzu, was Sie beibehalten und was Sie verbessert haben.

3. Spezifikation in 60 Sekunden

{
  "canvas": { "width": 1600 },
  "style": "marker",
  "title": "Checkout Service",
  "subtitle": "{blue:clients} · {purple:services} · {green:data}",
  "elements": [
    { "id": "web", "title": "Web app", "icon": "app-window", "x": 120, "y": 220 },
    { "id": "api", "title": "API", "color": "purple", "emphasis": true, "rightOf": "web", "gap": 160,
      "lines": ["`POST /checkout`", { "text": "validates cart", "muted": true }] },
    { "id": "db", "type": "cylinder", "title": "Orders DB", "color": "green", "below": "api", "gap": 120 },
    { "id": "core", "type": "panel", "title": "Backend", "color": "purple", "contains": ["api", "db"] },
    { "id": "n1", "type": "note", "text": "Idempotent by **order id**", "rightOf": "core", "gap": 40 }
  ],
  "arrows": [
    { "from": "web", "to": "api", "label": "HTTPS" },
    { "from": "api", "to": "db", "label": "INSERT", "color": "green" }
  ]
}
  • Elementtypen: box (Standard), pill, ellipse, circle, diamond, cylinder, note, card, panel, text, icon, badge, image, path (benutzerdefinierte SVG-Form) sowie die Layout-Helfer row, column und group.

  • Positionieren Sie jedes Element mit einem der folgenden:

    • x/y für die obere linke Ecke oder cx/cy für die Mitte.
    • below / above / rightOf / leftOf plus gap.
    • contains, das ein Panel automatisch um seine Kinder anpasst.

    Die Größe wird automatisch bestimmt. Setzen Sie w/h, um ein Original exakt zu treffen.

  • Text: title ist fett und \n bricht die Zeile um. lines sind Textzeilen. Markup im Text:

    • **fett**
    • `code` (verwendet die Code-Schriftart)
    • {green:span} und {muted:span}
    • -> (wird als Pfeilglyphe gezeichnet)

    Chinesisch und Englisch mischen sich frei. Pro Element können Sie size, textSize, font, textColor und align setzen.

  • Farbe mit einer Familie (blue purple green orange red teal yellow pink gray navy), einem Farbton (blue.tint), #hex oder einem einfachen CSS-Namen wie white, gesetzt über color, fill, stroke und textColor.

  • Pfeile verbinden from mit to:

    • Verankern Sie eine Seite und gleiten Sie daran entlang mit "id.right" oder "id.right+20".
    • Beschriftungen: label, platziert mit labelPos (above, below, left, right oder inline) und verschoben mit labelAt.
    • Aussehen: dash, color, width und head (end, start, both oder none).
    • Pfad: via-Punkte, points (eine exakte Polylinie) oder "route": "curve".

Jeder Schlüssel ist in references/spec.md.

4. Aussehen: Stil, Palette, Schriftart, Effekte

  • Stil-Voreinstellungen:

    • Handgezeichnet: marker (Standard), neat, excalidraw, sketchy, whiteboard, pencil, blueprint, chalk.
    • Sauber: clean, paper.

    Jedes Voreinstellungsfeld kann durch styleOverrides überschrieben werden:

    • roughness (0 = perfekt gerade Linien) und bowing
    • fillStyle (solid, hachure, cross-hatch, dots oder none)
    • strokeScale, cornerRadius
    • shadow (none, soft oder hard)
    • font, cjkFont, codeFont, background
  • Paletten: marker, pastel, excalidraw, mono, academic, colorblind, modern, blueprint, chalkboard, midnight. Um die Farben eines Originals exakt zu reproduzieren, führen Sie node SKILL_DIR/scripts/palette.mjs original.png aus und fügen Sie das Ergebnis ein.

  • Schriftarten:

    • Handschrift: shantell, kalam, caveat, patrick, architects.
    • Serifenlos: inter. Serif: serif. Mono: mono.
    • CJK: kai (handschriftlich), kuaile (verspielt), sans-sc (sauber).
    • Eigene .ttf/.otf/.woff: "fonts": {"marke": {"regular": "Marke.ttf", "bold": "Marke-Bold.ttf"}}, dann "font": "marke".
  • Kataloge: assets/gallery/styles.png, palettes.png und fonts.png. Neu generieren mit scripts/catalog.mjs.

  • Symbole: 1.500+ Lucide-Symbole. Suchen mit node SKILL_DIR/scripts/icons.mjs search 数据库 robot queue und Vorschau mit icons.mjs sheet a,b,c.

  • Werkzeuge für Originalbilder:

    • grid.mjs: Koordinaten auf dem Original überlagern. Lesen Sie die roten Achsenbeschriftungen, niemals Pixelpositionen.
    • fontmatch.mjs: Beispieltext in jeder Schriftart neben einem vergrößerten Ausschnitt des Originals anzeigen.
    • palette.mjs: Farben des Originals extrahieren.
    • crop.mjs: Logos, Fotos oder Screenshots ausschneiden, um sie als image-Elemente einzubetten.
    • compare.mjs: Seitenweiser Vergleich; fügen Sie --crop x,y,w,h hinzu, um beide Bilder auf denselben Bereich zu zoomen.
  • Dunkle oder alternative Versionen: Behalten Sie dieselbe Spezifikation und ändern Sie nur palette (midnight, blueprint oder chalkboard) oder style, und rendern Sie dann unter einem anderen --name.

  • Für Folien (PPT, Keynote): "canvas": {"aspect": "16:9"} polstert das Bild auf das Folienverhältnis. "background": "transparent" ergibt ein PNG mit Alphakanal. Das SVG kann auch direkt eingefügt werden.

5. Klarheitsregeln (immer anwenden)

  1. Behalten Sie die Wörter genau so bei, wie sie vorgegeben sind: Beschriftungen, Code-Identifikatoren und chinesische Begriffe. Erfinden, übersetzen oder entfernen Sie niemals Text, es sei denn, der Benutzer verlangt es.
  2. Machen Sie die Hierarchie sichtbar:
    • Fette Überschrift pro Kästchen.
    • Identifikatoren als Textkörper oder Code-Text.
    • Erklärungen als muted-Text.
    • Abschnittsüberschriften in der Farbe des Abschnitts.
  3. Farbe bedeutet etwas: eine Familie pro Bereich oder Rolle, konsistent verwendet. Pfeilbeschriftungen erben die Farbe ihres Pfeils.
  4. Luft zum Atmen:
    • ≥ 60 px zwischen Formen, die durch einen beschrifteten Pfeil verbunden sind, ≥ 24 px sonst.
    • Panels mit contains angepasst.
    • Keine Beschriftung auf einem Rand.
  5. Lesbar beim Verkleinern:
    • Text ≥ 18 px (Standardeinstellungen: Knoten 30, Textkörper 25, Beschriftung 24).
    • Leinwand 1400–2200 px breit, mit einem Seitenverhältnis zwischen 1:2 und 3:1. Der Linter warnt sonst.
    • Lange Ketten von 6+ Knoten: serpentinieren Sie sie in 2–3 Zeilen oder verwenden Sie ELK "direction": "DOWN", anstatt einer sehr langen Zeile.
  6. Wenige Kreuzungen und keine Umwege. Richten Sie aus und sortieren Sie neu, bevor Sie via hinzufügen.
  7. Verfeinern, nicht neu entwerfen bei Wiederaufbau-Aufträgen: Verbessern Sie Ausrichtung, Abstände und Hierarchie, behalten Sie aber Topologie, Lesereihenfolge und Stilidentität bei.

6. Abschlusskriterien

  • render.mjs meldet 0 Fehler. Jede verbleibende Warnung ist beabsichtigt und mit ignore unterdrückt.
  • Jeder Inventar-String ist vorhanden und genau geschrieben (--expect texts.txt besteht).
  • Sie haben das PNG und die Kacheln betrachtet und bei Wiederaufbauten mit dem Original verglichen: gleiche Struktur, gleiche Stilidentität, klarer.
  • Sie haben das PNG, SVG und JSON ausgeliefert, mit einer kurzen „beibehalten / verbessert“-Notiz.

7. Fehlerbehebung

  • node: command not found: Installieren Sie Node 18+. Es wird nichts weiter benötigt.
  • WebP, HEIC, BMP- oder TIFF-Eingabe wird automatisch konvertiert, wenn sips, magick, dwebp, ffmpeg oder Python PIL verfügbar ist. Andernfalls fragen Sie den Benutzer nach einer PNG oder JPEG.
  • Ein Zeichen wird als ? dargestellt: Die gebündelten Schriftarten decken lateinische Schrift, GB2312-Chinesisch und gebräuchliche Symbole ab. Formulieren Sie es um oder registrieren Sie eine Schriftart, die es enthält.
  • Für jeden Lint-Code und seine Behebung siehe references/troubleshooting.md.

Verwandte Skills