SKILL: PDF als Ausgabeformat (Konvertierung via LibreOffice, Pruefschritte)

SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: vision4it-dokumente
-description: Use this skill whenever creating customer-facing documents for vision4it GmbH — Angebote, Kurzkonzepte, Kundenanleitungen, or Managed-Services-Angebote. Triggers include any request to write an "Angebot", "Kurzkonzept", "Anleitung" for a customer, or any .docx/document in the vision4it corporate design. Also use when the vision4it branding, colors, logo, footer/Impressum data, or the lowercase spelling rule ("vision4it") are relevant. Covers document structure, Deckblatt layout, Phasentabelle format, and the build workflow with the docx library.
+description: Use this skill whenever creating customer-facing documents for vision4it GmbH — Angebote, Kurzkonzepte, Kundenanleitungen, or Managed-Services-Angebote. Triggers include any request to write an "Angebot", "Kurzkonzept", "Anleitung" for a customer, or any .docx/document in the vision4it corporate design. Also use when the vision4it branding, colors, logo, footer/Impressum data, or the lowercase spelling rule ("vision4it") are relevant. Covers document structure, Deckblatt layout, Phasentabelle format, and the build workflow with the docx library, including PDF export as delivery format.
 ---
 
 # SKILL: vision4it Kundendokumente (Angebote, Kurzkonzepte, Anleitungen)
@@ -74,6 +74,46 @@ Amtsgericht Mönchengladbach, HRB 22650 · USt-IdNr. DE369304034
 
 ---
 
+## Ausgabeformat: PDF
+
+Kundendokumente können als .docx, als PDF oder als beides geliefert werden.
+
+**Wann welches Format:**
+- **PDF** — Standard für den Versand an Kunden: Layout und Schriften sind fest
+  eingebettet, nichts verrutscht, nicht versehentlich editierbar. Im Zweifel PDF.
+- **.docx** — wenn Matthias das Dokument selbst weiterbearbeiten will, oder auf
+  ausdrücklichen Wunsch. Bei Angeboten sinnvoll: beides liefern.
+
+**Erzeugung — IMMER über den docx-Weg:** Es gibt KEINE separate PDF-Vorlage.
+Das Dokument wird wie beschrieben mit der docx-Library gebaut und anschließend
+konvertiert:
+
+```bash
+# claude.ai-Umgebung:
+python3 /mnt/skills/public/docx/scripts/office/soffice.py --headless --convert-to pdf <datei>.docx
+# andere Umgebungen mit LibreOffice:
+soffice --headless --convert-to pdf <datei>.docx
+```
+
+So bleibt eine einzige Design-Quelle (das Template); LibreOffice bettet die
+verwendeten Schriften ins PDF ein. Kein direktes PDF-Generieren mit reportlab
+o. ä. für diese Dokumenttypen — das würde eine zweite, abweichende Design-Welt
+schaffen.
+
+**Pflichtprüfung am PDF** (ersetzt/ergänzt den Rendering-Check):
+- Seitenzahl plausibel, kein Überlauf (leere Seite = Spacer-Problem auf dem Deckblatt)
+- `pdftotext <datei>.pdf - | grep -o 'Vision4IT\|Vision4it\|VISION4IT' | wc -l` → muss 0 sein
+- Firmenangaben (Siemensstraße 8, HRB 22650) im PDF-Text vorhanden
+
+Dateinamen: identisch zum docx, nur Endung .pdf
+(z. B. `Angebot_Kurzkonzept_<Kunde>.pdf`).
+
+Für andere PDF-Aufgaben (Formulare ausfüllen, PDFs zusammenführen, Wasserzeichen)
+gilt der allgemeine pdf-Skill der Umgebung (claude.ai: `/mnt/skills/public/pdf/`),
+nicht diese Anleitung.
+
+---
+
 ## Corporate Design (Farben)
 
 ```javascript
@@ -357,7 +397,8 @@ Elegance (IT Essential, 1.200 €/Monat).
 - [ ] Phasentabelle: Zwischensumme + 15 % Puffer + Gesamtsumme
 - [ ] Kalenderzeit-Angabe und „Nicht enthalten"-Block vorhanden
 - [ ] `validate.py` erfolgreich durchgelaufen
-- [ ] Rendern (soffice → pdftoppm) und Seitenzahl/Überlauf prüfen — Spacer-Höhen auf dem
+- [ ] Rendern (soffice → pdftoppm) und Seitenzahl/Überlauf prüfen; bei PDF-Lieferung
+      die Pflichtprüfungen aus dem PDF-Abschnitt durchführen — Spacer-Höhen auf dem
       Deckblatt sind die häufigste Überlauf-Ursache
 - [ ] Datei dem Nutzer bereitgestellt (Datei-Tool der jeweiligen Umgebung)
 - [ ] Bei Unsicherheit über Preisnennung: Matthias fragen