---
name: prettydiagram
description: >
  Generiert handgezeichnete Sketchnote-Diagramme aus Textbeschreibungen.
  Zweistufig: erst Plan zur Freigabe, dann SVG + Rendering via Kie.ai.
  Use when user asks for a diagram, sketch, illustration, or visual explanation
  of a concept, architecture, or workflow. Trigger phrases: "zeichne", "diagram",
  "sketchnote", "illustriere", "visualisiere".
---

# PrettyDiagram

Generiert handgezeichnete Sketchnote-Illustrationen aus Textbeschreibungen.

Plugin root: `${CLAUDE_PLUGIN_ROOT}`

## Setup (einmalig)

Falls noch kein venv vorhanden, Setup ausführen:

```bash
cd "${CLAUDE_PLUGIN_ROOT}"
bash scripts/setup.sh
```

## Workflow

### Schritt 1: Plan erstellen

Erstelle aus der Beschreibung des Users einen **kurzen, strukturierten Plan** im folgenden Format:

```
## Diagramm-Plan: <Titel>

**Farbschema**: <red-white | red | warm | ocean | neon>
**Detailgrad**: <minimal | standard | detailed>
**Layout**: <Pattern — z.B. Flow, Fan-Out, Central Hub, Panel Grid>
**Komponenten** (max 8):
- <Name> — <Farbe> — <kurze Beschreibung>
- ...

**Connectors**:
- <Von> → <Nach> — <Label, optional> — <Stil: solid/dashed>
- ...

**IMAGE Placeholders** (max 6):
- <!-- IMAGE: beschreibung -->
- ...

**Extras**: <Badges, Deko-Elemente>
```

**STOP hier.** Warte auf explizite Freigabe vom User bevor du weiterarbeitest.
In Mattermost zählt Daumen-hoch oder Haken als Freigabe.

### Schritt 2: SVG Blueprint generieren

Nach Freigabe: Generiere das SVG nach den Regeln in `references/svg-rules.md`.

Lies die Regeln:
```
Read ${CLAUDE_PLUGIN_ROOT}/skills/prettydiagram/references/svg-rules.md
```

Wichtig:
- ViewBox `0 0 900 550`
- Nur `<path>` mit Wobble, keine `<rect>` für Container
- 6 Layer einhalten
- QA: Prüfe auf Overlaps, Spacing, Lesbarkeit

Speichere das SVG unter `${CLAUDE_PLUGIN_ROOT}/examples/<titel-slug>.svg`.

### Schritt 3: Rendering

Führe aus:

```bash
cd "${CLAUDE_PLUGIN_ROOT}"
source .venv/bin/activate 2>/dev/null || bash scripts/setup.sh
python generate.py --svg examples/<titel-slug>.svg -o output/<titel-slug>.png
```

Default: 2K Auflösung, Kie.ai Backend. Für Gemini: `--backend gemini`.

### Schritt 4: Ergebnis zeigen

Öffne das generierte Bild:

```bash
xdg-open "${CLAUDE_PLUGIN_ROOT}/output/<titel-slug>.png"
```

Teile dem User den Pfad mit und frage ob Anpassungen gewünscht sind.

## Voraussetzungen

- `KIE_API_KEY` oder `GEMINI_API_KEY` in `${CLAUDE_PLUGIN_ROOT}/.env`
- `PRETTYDIAGRAMS_BACKEND` optional (default: kie)
- `TAVILY_API_KEY` optional (für Referenzbilder aus IMAGE Placeholders)
- Python 3.11+ (Setup-Script erledigt den Rest)