tpc-pascal/agent-skills

Zeichnet schöne Diagramme und Grafiken für Berichte — Flussdiagramme/Sequenz/Klasse/Zustand/ER/Gantt mit Mermaid (kroki.io, PNG), sowie Balken-/Kreis-/Liniendiagramme mit matplotlib (uv). Ausgabe als `<Name>.diagram.png` neben der Quelle, zur Einbettung in `.report.docx`. Verwenden, wenn der Bericht Diagramme anstelle von ASCII benötigt, Datenvisualisierung erforderlich ist oder der Benutzer „schöne Diagramme“ wünscht.

Was ist agent-skills?

Dieses Skill bietet zwei Hauptskripte: `scripts/mmd2png.py` zur Umwandlung von Mermaid-Diagrammen (Flowchart, Sequenz, Klasse, Zustand, ER, Gantt, Architektur) in PNG, und `scripts/chart.py` zur Erstellung von Balken-, Kreis- und Liniendiagrammen aus CSV-Daten mittels matplotlib. Es arbeitet standardmäßig lokal (`mmdc` CLI) und lädt Diagramme nicht ohne explizite Benutzerwahl hoch. Die Ausgabedateien werden neben der Quelle gespeichert, ohne diese zu überschreiben, und erhalten den Suffix `.diagram.png`. So können Diagramme nahtlos in `.report.docx`-Berichte eingebettet werden, indem sie im Markdown mit `![Titel](<Name>.diagram.png)` referenziert werden. Das Skill validiert die Ausgabe automatisch (PNG-Magic-Bytes, Größe ≥ 1 KB) und konvertiert bei Bedarf JPEG-Bilder mit ImageMagick. Es ist ideal für technische Berichte, Datenanalysen und Präsentationen, bei denen es auf klare, professionelle Visualisierung ankommt.

Funktioniert mit~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/tpc-pascal/agent-skills/tree/HEAD/skills/research/diagram

Dokumentation

Englische Version: SKILL.en.md

diagram — Diagramme & Grafiken

Schlankes Skill mit 2 Skripten: scripts/mmd2png.py (Mermaid → PNG, standardmäßig nur lokal via mmdc; remote nur bei expliziter Auswahl) und scripts/chart.py (Zahlendiagramme → PNG, matplotlib via uv oder vorhandenem Python). Quelle liegt neben der Ausgabe, vorhandene Dateien werden nicht überschrieben.

Routentabelle nach Bedarf

Bedarf	Vorgehen
Flowchart / Sequenz / Klasse / Zustand / ER / Gantt / Systemarchitektur	Mermaid → `scripts/mmd2png.py` (standardmäßig nur `mmdc` lokal)
Balkendiagramm / Kreisdiagramm / Liniendiagramm mit echten Daten	`scripts/chart.py` (matplotlib; `uv` benötigt ggf. Netzwerk, falls Paket nicht im Cache)
Diagramme einbetten in `.report.docx`	PNG + `![Titel](<Name>.diagram.png)` in `.report.md`, dann docx-Export via Skill `paper` und Rezept `doc`
Diagramme außerhalb der Möglichkeiten von Mermaid/matplotlib (3D, stark angepasste Grafik)	`[N/A]` — dem Benutzer die Einschränkung klar mitteilen, keine Lösungen erfinden

Regeln

Ausgabe neben der Quelle: <Originalname>.diagram.png (Bild) + <Originalname>.diagram.mmd (Mermaid-Quelle, editierbar). Keine Quell-Dateien überschreiben.
Mermaid: In .mmd schreiben, rendern mit python3 scripts/mmd2png.py '<f>.mmd' '<f>.diagram.png'; Diagrammbeschriftungen in der Sprache des Benutzers.
In Diagrammen gezeichnete Daten müssen Maße/Fakten aus der Quelle sein (Label [fact]/[observed]); keine erfundenen Zahlen zeichnen.
Lokal zuerst, keine stillen Uploads: standardmäßig nutzt mmd2png.py nur mmdc; fehlt CLI/Browser oder tritt ein Fehler auf → abbrechen und Grund nennen, kein Netzwerkaufruf. Installiere npm i -g @mermaid-js/mermaid-cli und Chrome/Chromium. Nur wenn Benutzer/Agent explizit wählt, setze MMD2PNG_BACKEND=remote (Kroki dann mermaid.ink), kroki oder ink. chart.py arbeitet lokal; uv run --with matplotlib kann Netzwerk benötigen, um Pakete zu holen, falls nicht installiert/im Cache. Daher offline Python mit installiertem matplotlib oder vorbereitetem Cache verwenden.
Vor der Übergabe prüfen: mmd2png.py prüft automatisch PNG-Magic-Bytes + Größe ≥ 1 KB; JPEG-Bilder von Remote werden mit ImageMagick in echte PNGs konvertiert (Fehlt Converter → <f>.jpg schreiben + Warnung, kein falsches .png); bei Einbettung in Bericht → erneute Prüfung mit pdfinfo + pdftotext nach Wandlung DOCX→PDF (Bild wird angezeigt, Seite bricht nicht).
Größe: Ein Diagramm pro Konzept, Schrift gut lesbar; zu breite Diagramme → aufteilen, statt den Editor zusammenstauchen zu lassen.
Sprache des Inputs beachten — in derselben Sprache antworten, die der Benutzer spricht.

Skripte

scripts/mmd2png.py — Mermaid → PNG (standardmäßig nur lokal; Remote per Opt-in via MMD2PNG_BACKEND): python3 scripts/mmd2png.py '<f>.mmd' '<f>.diagram.png' [--scale 2] [--size 1600] [--theme forest]
scripts/chart.py — CSV-Daten (2 Spalten: Label,Wert) → PNG: uv run --with matplotlib python3 scripts/chart.py '<f>.csv' '<f>.diagram.png' <bar|pie|line>