Release wordcraft-mcp and gridcraft-mcp 0.3.0: client-neutral skills, Cursor plugins.

skills/wordcraft-mcp/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog – wordcraft-mcp
 
+## 0.3.0 (2026-10-19)
+
+- Skill clientneutral: Claude-/Cursor-Details nur noch in README/docs; schärfere `description`.
+- Praxiserkenntnisse: batch inkl. Markieren, Fallen (format.set, Nummerierung, Löschen von unten, Highlight, UTF-8-Bytes), Rezepte (neues Dokument / Vorlage / füllen), Abschlussprüfung, Datenschutz-Ampel.
+- Ordner-Empfehlung in der Erweiterung: Lese weit, Schreib eng.
+- Neu: Cursor-Plugin je Skill (`wordcraft-mcp-cursor-v0.3.0.zip`) inkl. Deeplink.
+
 ## 0.2.0 (2026-10-19)
 
 - Erweiterung (`.mcpb`) als Standardweg; `display_name` ohne Umlaut („WordCraft for Claude“, Werkzeug-Präfix jetzt `…_for_Claude`).

skills/wordcraft-mcp/README.md

@@ -4,59 +4,61 @@
 
 ## Zweck
 
-Erstellt, bearbeitet und prüft Word-Dokumente über den MCP-Server von WordCraft – inklusive Nachverfolgung von Änderungen und der Fallen, die beim Praxistest mit WordCraft 0.8.0 aufgefallen sind. Die Anweisungen für Claude stehen in [SKILL.md](SKILL.md).
+Erstellt, bearbeitet und prüft Word-Dokumente über den MCP-Server von WordCraft – inklusive Nachverfolgung und der Fallen aus dem Praxistest mit WordCraft 0.8.0. Die Anweisungen für den Agenten stehen in [SKILL.md](SKILL.md) (clientneutral).
 
 ## Voraussetzungen
 
-- Claude Desktop (die App)
 - **WordCraft** über den ArtCraft-Launcher (`C:\Program Files\WordCraft\wordcraft-cli.exe`)
-- Die Erweiterung `wordcraft-mcp-….mcpb` und dieses Skill-ZIP (siehe [Installation](#installation))
+- Claude Desktop **oder** Cursor (siehe unten)
+- Die Erweiterung bzw. das Plugin sowie dieses Skill-ZIP
 
-Falls der Plugin-Skill `wordcraft-dokumente` installiert ist: deaktivieren, damit Claude `wordcraft-mcp` verwendet.
+Falls der Plugin-Skill `wordcraft-dokumente` installiert ist: deaktivieren bzw. löschen.
 
-## Installation
+**Cursor:** siehe [Wurzel-README](../../README.md) und [docs/CURSOR.md](../../docs/CURSOR.md).
+
+## Installation (Claude Desktop)
 
 Schritt-für-Schritt: [docs/INSTALLATION.md](../../docs/INSTALLATION.md). Kurz:
 
-1. `wordcraft-mcp-v0.2.0.mcpb` und `wordcraft-mcp-v0.2.0.zip` aus dem [Release](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.2.0/wordcraft-mcp-v0.2.0.mcpb) laden.
-2. Die `.mcpb` doppelklicken (oder über Einstellungen → Erweiterungen installieren). Lese- und Schreib-Ordner setzen; Schreibordner vorher anlegen und nicht gleich dem Leseordner wählen.
+1. `wordcraft-mcp-v0.3.0.mcpb` und `wordcraft-mcp-v0.3.0.zip` aus dem [Release](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.3.0/wordcraft-mcp-v0.3.0.mcpb) laden.
+2. Die `.mcpb` doppelklicken (oder über Einstellungen → Erweiterungen installieren). **Lese-Ordner weit** (z. B. Dokumente oder Benutzerordner), **Schreib-Ordner eng** (eigener Ordner, z. B. `Dokumente\Claude`).
 3. Unter Einstellungen → Erweiterungen prüfen, dass **WordCraft for Claude** eingeschaltet ist.
-4. Skill-ZIP in Claude hochladen: **„+“ → „Skill erstellen“ → „Skill hochladen“**.
-5. Claude komplett beenden (auch Taskleiste) und neu starten.
+4. Skill-ZIP hochladen: **„+“ → „Skill erstellen“ → „Skill hochladen“**.
+5. Claude komplett beenden (auch Taskleiste) und neu starten. **Neuen** Chat öffnen.
 
-Wer v0.1.0 installiert hat: alte Erweiterung unter Einstellungen → Erweiterungen entfernen, v0.2.0 installieren, einschalten, Skill-ZIP v0.2.0 hochladen (ersetzt den alten Skill). Alte Skills `wordcraft-dokumente` bitte löschen.
+Bei `open_document` / `save_document` in Claude „Immer fragen“ lassen, wenn du Pfade mitkontrollieren willst.
 
-**Umsteigen von der manuellen Config:** Wer den Server früher in `claude_desktop_config.json` eingetragen hat: Eintrag `wordcraft` unter `mcpServers` vor der Installation der Erweiterung entfernen (vorher Sicherungskopie der Datei anlegen), sonst gibt es die Werkzeuge doppelt.
+Wer v0.1.0 oder v0.2.0 installiert hat: alte Erweiterung entfernen, v0.3.0 installieren, einschalten, Skill-ZIP v0.3.0 hochladen. Alte Skills `wordcraft-dokumente` bitte löschen.
+
+**Umsteigen von der manuellen Config:** Eintrag `wordcraft` unter `mcpServers` vor der Installation der Erweiterung entfernen (vorher Sicherungskopie), sonst gibt es die Werkzeuge doppelt.
 
 ## Enthaltene Software
 
-Die Erweiterung steuert [WordCraft](https://github.com/storytold/wordcraft) (MIT oder Apache-2.0) aus dem ArtCraft-Launcher; die CLI wird **nicht** mitgeliefert. Lizenztexte des Upstreams liegen in der `.mcpb` unter `LICENSES/`.
+Die Erweiterung steuert [WordCraft](https://github.com/storytold/wordcraft) (MIT oder Apache-2.0) aus dem ArtCraft-Launcher; die CLI wird **nicht** mitgeliefert. Lizenztexte liegen in der `.mcpb` unter `LICENSES/`.
 
 ## Test
 
-Neuen Chat öffnen und fragen: „Sind die WordCraft-Tools verfügbar?“
+Neuen Chat öffnen und fragen: „Sind die WordCraft-Tools verfügbar?“ Die Werkzeuge heißen mit Präfix `…WordCraft_for_Claude…`.
 
-Fehlen die Tools: Einstellungen → Erweiterungen – ist die Erweiterung eingeschaltet? Dann Claude komplett neu starten.
+Fehlen die Tools: Einstellungen → Erweiterungen – eingeschaltet? CLI unter `C:\Program Files\WordCraft\wordcraft-cli.exe` vorhanden? Dann Claude neu starten und neuen Chat öffnen.
 
 ## Stolpersteine
 
-- Speichern mit „path rejected“: Ziel lag außerhalb des Schreib-Ordners. Einstellungen → Erweiterungen → WordCraft for Claude → Einstellungen prüfen.
+- Speichern mit „path rejected“: Ziel lag außerhalb des Schreib-Ordners. Einstellungen → Erweiterungen → WordCraft for Claude → Einstellungen.
 - Erweiterungen sind nicht signiert; nur installieren, wenn du der Quelle vertraust.
 
 ## Deinstallation/Update
 
-Deinstallation: Einstellungen → Erweiterungen → entfernen; Skill in der Skill-Liste löschen.
-
-Update: neue `.mcpb` und Skill-ZIP installieren, bestehende Version ersetzen lassen, Claude neu starten.
+Einstellungen → Erweiterungen → entfernen; Skill löschen. Update: neue `.mcpb` und Skill-ZIP, ersetzen lassen, neu starten.
 
 ## Alternative: manuell (für Entwickler)
 
-Statt der Erweiterung kann der MCP-Server in `claude_desktop_config.json` eingetragen werden. Gemeinsame Stolpersteine: [MCP unter Windows einrichten](../../docs/windows-mcp-einrichtung.md).
+Statt der Erweiterung den MCP-Server in `claude_desktop_config.json` eintragen. Stolpersteine: [MCP unter Windows einrichten](../../docs/windows-mcp-einrichtung.md).
 
 - Claude-Installer: `%APPDATA%\Claude\claude_desktop_config.json`
-- Microsoft-Store-App: `%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json` (der Suffix `pzs8sxrjxfjjc` ist der Herausgeber-Hash und bei allen Store-Installationen gleich)
+- Microsoft-Store-App: `%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json` (Herausgeber-Hash `pzs8sxrjxfjjc`, bei allen Store-Installationen gleich)
 
-WordCraft muss über den ArtCraft-Launcher installiert sein (`C:\Program Files\WordCraft\wordcraft-cli.exe`). Der Schreibordner muss vorher existieren.
+Die App kann den Eintrag beim Speichern eigener Einstellungen überschreiben – dann neu eintragen und **sofort** neu starten.
 
 ```json
 {
@@ -67,14 +69,14 @@ WordCraft muss über den ArtCraft-Launcher installiert sein (`C:\Program Files\W
         "mcp",
         "--author", "Claude",
         "--automation-read-root", "C:\\Pfad\\zu\\Dokumente",
-        "--automation-write-root", "C:\\Pfad\\zu\\Dokumente\\claude_out"
+        "--automation-write-root", "C:\\Pfad\\zu\\Dokumente\\Claude"
       ]
     }
   }
 }
 ```
 
-Auffinden der EXE:
+Laufende App steuern (nicht auf Ordner beschränkt): `wordcraft --control 7981` und `wordcraft-cli mcp --connect 127.0.0.1:7981`.
 
 ```powershell
 Get-ChildItem "$env:ProgramFiles","$env:LOCALAPPDATA" -Recurse -Filter "wordcraft-cli.exe" -ErrorAction SilentlyContinue

skills/wordcraft-mcp/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: wordcraft-mcp
-description: Word-Dokumente (.docx, .odt, .md, PDF) über den WordCraft-MCP-Server erstellen, bearbeiten und prüfen, inkl. Nachverfolgung – mit erprobten Fallen aus WordCraft 0.8.0.
+description: "Word-Dokumente (.docx, .odt, .md, PDF) mit dem WordCraft-MCP-Server erstellen, bearbeiten und prüfen (inkl. Nachverfolgung). Verwenden, wenn WordCraft-Werkzeuge verbunden sind oder der Nutzer WordCraft nennt; typisch für Angebote, Briefe, Betriebsanleitungen, Arbeitsanweisungen, 8D-Reports, Vorlagen. Nicht für eingebaute docx-Hilfen ohne WordCraft-Server."
 ---
 
 # Dokumente mit WordCraft (MCP)
@@ -9,25 +9,11 @@ WordCraft ist ein Open-Source-Textverarbeitungsprogramm (Rust), das Word-Paritä
 
 ## Voraussetzung
 
-Die Werkzeuge heißen `list_commands`, `execute`, `render_page` … mit einem Präfix, der vom Client und vom Namen der Erweiterung abhängt (z. B. `mcp__…__WordCraft_for_Claude__list_commands`). Sind sie zurückgestellt, per ToolSearch nach dem Werkzeugnamen ohne Präfix suchen (z. B. `list_commands`) und alle benötigten in einem Aufruf laden. Fehlen sie auch dann, dem Nutzer den Grund nennen statt auszuweichen.
-
-**Standardweg:** WordCraft aus dem ArtCraft-Launcher und die Claude-Desktop-Erweiterung „WordCraft for Claude“ sind installiert und eingeschaltet (siehe `docs/INSTALLATION.md`). Fehlen die Tools: ArtCraft-Installation und Einstellungen → Erweiterungen prüfen, Claude komplett beenden (auch Taskleiste) und neu starten – nicht auf ein anderes Programm ausweichen.
-
-**Alternative (Entwickler):** Eintrag `wordcraft` in `claude_desktop_config.json` mit `wordcraft-cli.exe mcp --author Claude --automation-read-root <Ordner> --automation-write-root <Ordner>\claude_out`. Store-Pfad: `%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\`. Die App kann den Eintrag beim Speichern eigener Einstellungen überschreiben – dann neu eintragen und sofort neu starten.
-
-Alternativ laufende App steuern (nicht auf Ordner beschränkt): `wordcraft --control 7981` und `wordcraft-cli mcp --connect 127.0.0.1:7981`.
+Die Werkzeuge `list_commands`, `execute`, `render_page` … müssen verbunden sein. Ihr Präfix hängt vom Client und vom Namen der Erweiterung bzw. des Servers ab (z. B. `mcp__…__WordCraft_for_Claude__list_commands`). Sind sie zurückgestellt, nach dem Werkzeugnamen ohne Präfix suchen und alle benötigten auf einmal laden. Fehlen sie, dem Nutzer sagen, dass der Server nicht verbunden ist (Einrichtung siehe README), statt auf ein anderes Programm auszuweichen.
 
 ## Freigaben
 
-Der eigentliche Schutz sind `--automation-read-root` und `--automation-write-root`, nicht die Freigabe-Dialoge. Empfohlene Tool-Berechtigungen im Connector:
-
-- Immer erlauben: `list_commands`, `get_text`, `inspect_document`, `render_page`, `open_document`, `select_text`, `new_document`, `parity`, `execute`, `batch`, `type_text`
-- Optional nachfragen: `save_document` (nur bedingt wirksam, da `execute` mit `file.saveAs`/`file.exportPdf` ebenfalls speichern kann)
-- Nie: `screenshot`, `click`, `key`, `ui_inspect` (nur für `--connect`, dort ohne Ordnergrenzen)
-
-„Immer erlauben“ ist nur sicher, solange die Config die Root-Argumente enthält und kein `--connect` verwendet. Nach jedem Neueintrag prüfen.
-
-Aufrufe sparen: genaue Dateipfade vom Nutzer erfragen statt zu raten, zusammenhängende Schritte immer als `batch`.
+Schutz durch Lese- und Schreib-Root (nicht die Freigabe-Dialoge). Lesen weit, Schreiben eng. Zusammenhängende Schritte immer als `batch`. Genau Dateipfade vom Nutzer erfragen statt zu raten.
 
 ## Tools
 
@@ -43,23 +29,24 @@ Aufrufe sparen: genaue Dateipfade vom Nutzer erfragen statt zu raten, zusammenh
 | `get_text` / `inspect_document` | Dokument zurücklesen (Struktur als JSON, inkl. Kopf-/Fußzeilen unter `parts`) |
 | `render_page` | Seite als PNG |
 | `parity` | Funktionsabdeckung gegenüber Word |
-| `screenshot`, `click`, `key`, `ui_inspect` | nur mit `--connect` |
+| `screenshot`, `click`, `key`, `ui_inspect` | nur mit verbundener Desktop-App |
 
 ## Arbeitsweise
 
-1. **Befehls-IDs nie raten.** Vor jedem unbekannten Befehl `list_commands` mit `query` aufrufen (z. B. `table.`, `insert.`, `layout.`, `styles.`, `review`, `caret.`). Präfix mit Punkt filtert gezielter.
-2. **Formatvorlagen statt Direktformatierung.** `styles.modify` an Normal/Heading1/Heading2/Title; Absätze nur per `para.set {"props":{"style":"Heading1"}}` zuweisen.
-3. **Gebündelt arbeiten.** Zusammenhängende Schritte als `batch`.
-4. **Prüfen, bevor gespeichert wird.** `inspect_document` für Inhalt/Struktur/Kopf-Fußzeilen, `render_page` für Layout.
+1. **Befehls-IDs nie raten.** Vor jedem unbekannten Befehl `list_commands` mit `query` aufrufen (z. B. `table.`, `insert.`, `layout.`, `styles.`, `review`, `caret.`, `select.`).
+2. **Alles im batch.** Auch Markieren: `select.text {text, occurrence?}`, `select.range {anchor: Pos, focus: Pos}`, `select.collapse`. `text.insert` ersetzt eine bestehende Markierung. Damit lassen sich ganze Dokumente in wenigen Aufrufen umbauen.
+3. **Formatvorlagen statt Direktformatierung.** `styles.modify` an Normal/Heading1/Heading2/Title; Absätze nur per `para.set {"props":{"style":"Heading1"}}` zuweisen.
+4. **Prüfen, bevor gespeichert wird.** `inspect_document`, `render_page`.
 5. **Speichern** mit `save_document` in den Schreibordner; PDF per Endung `.pdf`.
-6. **Rundreise prüfen:** gespeicherte Datei neu öffnen und `inspect_document`/`render_page` bzw. `review.changes` erneut aufrufen.
+6. **Rundreise prüfen:** gespeicherte Datei neu öffnen und erneut prüfen.
 
-## Dateien finden
+## Dateien finden und Zugriff
 
 Es gibt **keinen Befehl zum Auflisten von Ordnern**. `open_document` auf einen Pfad:
 - `os error 5 (Zugriff verweigert)` → Pfad ist ein existierender Ordner
 - `os error 2 (nicht gefunden)` → existiert nicht
-Damit lassen sich Ordner bestätigen, aber keine Dateinamen ermitteln. Bei Unklarheit den Nutzer nach dem genauen Dateinamen fragen statt viele Namen zu raten.
+
+Liegt eine Datei **außerhalb des Lese-Ordners**, wird sie abgelehnt. Dann: (a) Nutzer bitten, den Lese-Ordner in den Einstellungen weiter zu fassen, oder (b) – wenn der Client Dateizugriff mit Nutzerfreigabe hat – die Datei mit Freigabe in den Arbeitsordner **kopieren** und nur mit der Kopie arbeiten. Original nie überschreiben.
 
 ## Neues Dokument – Grundeinrichtung (DE)
 
@@ -72,12 +59,24 @@ Damit lassen sich Ordner bestätigen, aber keine Dateinamen ermitteln. Bei Unkla
 ```
 Ohne de-DE zeigt `render_page` deutsche Wörter mit roten Wellenlinien.
 
-Text aufbauen: `para.set {style}` → `text.insert` → `text.newParagraph`, Stil für jeden Absatz explizit setzen. Aufzählung: `para.bullets {"kind":"bullet"}` vor dem ersten Punkt, `para.bullets {"off":true}` danach (hinterlässt `numbering num 0` am nächsten Absatz – harmlos).
+Text aufbauen: `para.set {style}` → `text.insert` → `text.newParagraph`, Stil für jeden Absatz explizit setzen.
+
+## Fallen (im Test bestätigt)
+
+- **`format.set` ohne Markierung** wirkt nicht auf den gerade eingefügten Text, sondern auf den folgenden Absatz. Immer erst markieren (`select.text` / `select.range`), dann formatieren.
+- **Nummerierte Listen:** `para.numbering {"kind":"numbered"}` (auch `numberedParen`, `upperLetter`, `lowerLetter`, `lowerRoman`, `outline`). `para.bullets {"kind":"decimal"}` nimmt „decimal“ still als Aufzählungszeichen. Ende: `para.numbering {"off":true}`. Aufzählung: `para.bullets {"kind":"bullet"}` … `para.bullets {"off":true}`.
+- **`table.insertRowBelow`** übernimmt Ausrichtung und Fettdruck der Nachbarzeile nicht → danach `para.set {align}` und `format.set` setzen.
+- **Absätze mit gemischtem Format** (z. B. fettes Label + Tab + Wert): nicht den ganzen Absatz ersetzen (sonst übernimmt alles das Format des ersten Laufs), sondern nur den Wertteil per `select.text`.
+- **`inspect_document`:** `len` und alle `off` sind **UTF-8-Bytes** (ä/ö/ü/ß = 2). Für Textstellen mit Umlauten lieber `select.text` als selbst berechnete Offsets.
+- **Absätze löschen:** von **unten nach oben** arbeiten; `select.range` vom Ende (`off = len`) des letzten verbleibenden Absatzes bis zum Ende des letzten zu löschenden Absatzes, dann `text.delete`. Indizes danach neu berechnen.
+- **Hinweiskasten:** `para.set {"props":{"shading":[r,g,b],"borders":{"top":{…},"bottom":{…},"left":{…},"right":{…}}}}`; im nächsten Absatz zurücksetzen (`shading` weiß, `borders` style none).
+- **Abstand vor einem Absatz:** `para.set {"props":{"style":"Normal","spaceBefore":24}}`.
+- **Gelbe Platzhalter-Markierung** (`format.set {"props":{"highlight":"yellow"}}`) bleibt beim Überschreiben erhalten – Nutzer bei Vorlagen darauf hinweisen (Word: Strg+A → Texthervorhebung „Keine Farbe“).
 
 ## Kopf- und Fußzeile, Seitenzahl
 
 - Nach `insert.header` / `insert.footer` **sofort** `insert.closeHeader`, sonst landet folgender Text in der Kopf-/Fußzeile.
-- `insert.footer {"text": ...}` setzt die Schreibmarke **an den Anfang** des Textes – nachfolgende Einfügungen landen davor. `preset: "blank"` legt einen Platzhalter „[Type here]“ an. Deshalb **ohne Parameter** öffnen und dann tippen:
+- `insert.footer {"text": ...}` setzt die Schreibmarke **an den Anfang** des Textes. `preset: "blank"` legt „[Type here]“ an. Deshalb **ohne Parameter** öffnen und dann tippen:
 ```json
 [{"command":"insert.footer"},
  {"command":"text.insert","params":{"text":"Seite "}},
@@ -87,43 +86,67 @@ Text aufbauen: `para.set {style}` → `text.insert` → `text.newParagraph`, Sti
  {"command":"para.set","params":{"props":{"align":"center"}}},
  {"command":"insert.closeHeader"}]
 ```
-- Für reinen Text in der Kopfzeile ist `insert.header {"text": ...}` + `insert.closeHeader` in Ordnung.
-- Kontrolle: `inspect_document` → `parts[]` mit `kind: header/footer`. Fehler korrigieren mit `insert.removeFooter` und neu aufbauen.
+- Kontrolle: `inspect_document` → `parts[]` mit `kind: header/footer`.
 
 ## Tabellen
 
 - `insert.table {"rows":n,"cols":n,"style":"TableGrid"}` liefert `{"table":[index]}` = Blockindex.
 - Zellen **nicht per Tab** füllen, sondern anspringen: `caret.set {"pos":{"path":[tabelle, zeile, spalte, 0],"off":0,"story":"body"}}` dann `text.insert`.
 - Kopfzeile: Caret in Zeile 0 → `table.properties {"headerRow":true}`, `table.selectRow`, `table.shading {"color":"D9E2F3"}`, `format.set {"props":{"bold":true}}`.
-- `table.columnWidth` ändert **nur die Spalte der Schreibmarke**; die Tabelle wird dadurch schmaler/breiter. Alle Spalten so setzen, dass die Summe = Satzspiegel (pageW − marginLeft − marginRight; A4 mit 2,5/2 cm ≈ 467,7 pt).
-
-## Positionen
-
-- `off` in Positionen zählt **UTF-8-Bytes**, nicht Zeichen (ä/ö/ü/ß = 2, ▬ oder – = 3). Für Textstellen mit Umlauten lieber `select_text` als selbst berechnete Offsets.
-- Kommentaranker und andere Objekte belegen Positionen im Absatz; nach `review.newComment` Offsets neu ermitteln.
+- `table.columnWidth` ändert **nur die Spalte der Schreibmarke**. Alle Spalten so setzen, dass die Summe = Satzspiegel (A4 mit 2,5/2 cm ≈ 467,7 pt).
 
 ## Überarbeitung fremder Dokumente (Nachverfolgung)
 
 1. Original nur öffnen, nie darauf speichern; erste Speicherung sofort mit neuem Namen in den Schreibordner.
-2. `file.setAuthor {"name":"Claude"}` und `review.trackChanges {"value": true}` – **immer mit value**; ohne schaltet der Befehl um und kann die Nachverfolgung ausschalten.
-3. Ersetzen: `select_text` → `type_text`. Ergebnis ist Einfügung + Löschung (ganzes Wort).
-4. **`select_text` findet auch bereits nachverfolgt gelöschten Text.** Nach einer Ersetzung nicht erneut nach dem alten Wortlaut suchen; zum Markieren das neue Wort verwenden.
+2. `file.setAuthor {"name":"…"}` und `review.trackChanges {"value": true}` – **immer mit value**.
+3. Ersetzen: `select_text` → `type_text`. Ergebnis ist Einfügung + Löschung.
+4. **`select_text` findet auch bereits nachverfolgt gelöschten Text.** Nach einer Ersetzung nicht erneut nach dem alten Wortlaut suchen.
 5. Begründungen als Kommentar: Text markieren, `review.newComment {"text": ...}`.
-6. Prüfen: `review.changes` (Liste mit author, kind, text) und `review.comments` – auch nach dem Neuöffnen der gespeicherten Datei.
+6. Prüfen: `review.changes` und `review.comments` – auch nach dem Neuöffnen.
+
+## Rezepte
+
+Platzhalter-Konvention: `{{Feldname}}` (Jinja2-kompatibel).
+
+### 1. Neues Dokument
+
+A4, Ränder, de-DE, Formatvorlagen Title/Heading1/Heading2/Normal anpassen → Inhalt aufbauen → Kopfzeile → Fußzeile „Seite x von y“ → Tabelle mit Kopfzeile → nummerierte Liste (`para.numbering`) → ggf. Hinweiskasten → `render_page` → speichern.
+
+### 2. Vorlage aus bestehendem Dokument
+
+Kopie im Lese-Ordner öffnen → `inspect_document` → Löschungen von unten nach oben → Ersetzungen per `select.range` (Absatzindex) bzw. `select.text` (Teilstücke) → Platzhalter `{{Feldname}}` gelb markieren → `get_text` prüfen, dass keine Ursprungsdaten (Namen, Adressen, Preise) übrig sind → unter neuem Namen speichern.
+
+### 3. Vorlage füllen
+
+Vorlage öffnen → Felder per `select.text "{{Feld}}"` + `text.insert` im batch ersetzen → wiederholbare Listenpunkte ergänzen/löschen → Markierung entfernen → `get_text` auf `{{` prüfen → rendern → unter neuem Namen speichern (.docx + .pdf).
+
+## Abschlussprüfung
+
+- Alle Seiten mit `render_page` ansehen; Seitenzahl plausibel.
+- Bei Vorlagen/gefüllten Dokumenten: `get_text` auf `{{` bzw. Altdaten prüfen.
+- Gespeicherte Datei neu öffnen und kurz gegenlesen.
+- Pfad dem Nutzer nennen.
+
+## Datenschutz
+
+- Grün: allgemeine/technische Inhalte ohne Kundenbezug.
+- Gelb: Projekt-/Geschäftsinfos, Preise (oft vertraulich) nur nach Abwägung oder anonymisiert.
+- Rot: personenbezogene Daten (Ansprechpartner, E-Mail, Telefon) und NDA-Inhalte nicht in die Cloud-KI.
+- Vorlagen aus **geschwärzten** Kopien erstellen; im Freitext Platzhalter statt echter Namen verwenden.
 
 ## Eigenschaften (Kurzreferenz)
 
 Längen in Punkt, Farben als `"#RRGGBB"`, `[r,g,b]` oder `{"Rgb":[r,g,b]}`; bei Tabellenbefehlen `"RRGGBB"` ohne #. Unbekannte Feldnamen werden **still ignoriert**.
 
 - Zeichen (`format.set {"props": …}`): `font`, `size`, `bold`, `italic`, `underline`, `color`, `highlight`, `vertAlign`, `lang`, `link`
-- Absatz (`para.set {"props": …}`): `style`, `align`, `indentLeft`, `indentFirst`, `spaceBefore`, `spaceAfter`, `lineSpacing` (`{"rule":"multiple","value":1.15}`), `keepNext`, `keepLines`, `pageBreakBefore`, `outlineLevel`, `numbering`, `tabs`, `borders`
+- Absatz (`para.set {"props": …}`): `style`, `align`, `indentLeft`, `indentFirst`, `spaceBefore`, `spaceAfter`, `lineSpacing` (`{"rule":"multiple","value":1.15}`), `keepNext`, `keepLines`, `pageBreakBefore`, `outlineLevel`, `numbering`, `tabs`, `borders`, `shading`
 
 ## Renderer-Grenzen (0.8.0)
 
-Bekannte Darstellungsfehler von `render_page`, die **nicht** von eigenen Änderungen kommen:
 - mehrzeilige Zellen in dunkel hinterlegten Tabellenköpfen zeigen nur die letzte Zeile
 - Seitenzahlfelder in Fußzeilen importierter python-docx-Dokumente bleiben leer
-Bei Auffälligkeiten erst das Original rendern und vergleichen, bevor man die eigene Änderung verdächtigt.
+
+Bei Auffälligkeiten erst das Original rendern und vergleichen.
 
 ## Word-Kompatibilität
 
@@ -133,5 +156,5 @@ Bei Auffälligkeiten erst das Original rendern und vergleichen, bevor man die ei
 
 ## Grenzen
 
-- Die Ordnerbeschränkung gilt nur headless; mit `--connect` ist die App nicht eingeschränkt.
+- Die Ordnerbeschränkung gilt nur headless; mit verbundener Desktop-App entfällt sie.
 - Befehle ohne Pfad wirken immer auf das zuletzt geöffnete Dokument. Vor dem Öffnen eines anderen Dokuments speichern.

skills/wordcraft-mcp/extension/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": "0.3",
   "name": "wordcraft-mcp",
   "display_name": "WordCraft for Claude",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Word-Dokumente (.docx, .odt, .md, PDF) erstellen und bearbeiten. Getestet mit WordCraft 0.8.0. Benötigt WordCraft aus dem ArtCraft-Launcher unter C:\\Program Files\\WordCraft\\.",
   "author": {
     "name": "Dominic Gundel"
@@ -105,14 +105,14 @@
     "read_root": {
       "type": "directory",
       "title": "Lese-Ordner",
-      "description": "Hier darf Claude Dokumente lesen.",
+      "description": "Weit fassen (Standard: Dokumente, gern ganzer Benutzerordner). Lesen ist per Freigabe-Dialog kontrollierbar.",
       "required": true,
       "default": "${HOME}/Documents"
     },
     "write_root": {
       "type": "directory",
       "title": "Schreib-Ordner",
-      "description": "Nur hier darf Claude speichern. Eigenen Ordner wählen, z. B. Dokumente\\Claude-Ausgabe – nicht den Lese-Ordner.",
+      "description": "Eng halten: eigener Ordner, z. B. Dokumente\\Claude – nicht denselben wie den Lese-Ordner. Schreiben bleibt hart begrenzt.",
       "required": true
     },
     "author": {