[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AEG0HRA4MFYRCYYWGQVR4C":3,"skill-same:01M7AEG0HRA4MFYRCYYWGQVR4C":56},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M7AEG0HRA4MFYRCYYWGQVR4C","powerpoint-skill",null,"Erstellt und überarbeitet PowerPoint-Präsentationen (.pptx) mit companyFILES MCP-Tools. Verwenden, wenn eine Präsentation erstellt, Folien ergänzt oder korrigiert, ein Corporate-Folienmaster verwendet oder mit einer im Chat angehängten .pptx gearbeitet werden soll („mach einen Foliensatz in diesem Design“, „ergänze Folien“). Deckt alle Wege ab: von Grund auf (create_powerpoint), aus einer {{placeholder}}-Vorlage (create_powerpoint_from_template), aus einem Corporate-Master ohne Platzhalter über seine Folienlayouts (describe_pptx_template, create_powerpoint_from_layouts, add_slides_from_layouts, set_powerpoint_slide_fields) und aus einem Design-Deck, dessen Musterfolien nur Textfelder mit Blindtext haben („Text“, „XXX“, „TITEL“; per Code-Ausführung). Dazu iteratives Bearbeiten (append_slides_to_powerpoint, update_powerpoint_slide, read_powerpoint_slides), Klonen von Vorlagenfolien, Tabellen, Sprechernotizen, Bilder und Diagramme.","innFactory-AI\u002Fcompany-ai-stack-skills","innFactory-AI","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F165681221?v=4","01M7AEC27VD0D1QX2XBX441MDW","innFactory AI","01M7AEC28G25HQ9H9SN58MNV27",0,"MIT","https:\u002F\u002Fgithub.com\u002FinnFactory-AI\u002Fcompany-ai-stack-skills\u002Fblob\u002Fmain\u002Fde\u002Fskills\u002Ffiles\u002Fpowerpoint-skill\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: powerpoint-skill\ndescription: 'Erstellt und überarbeitet PowerPoint-Präsentationen (.pptx) mit companyFILES MCP-Tools. Verwenden, wenn eine Präsentation erstellt, Folien ergänzt oder korrigiert, ein Corporate-Folienmaster verwendet oder mit einer im Chat angehängten .pptx gearbeitet werden soll („mach einen Foliensatz in diesem Design“, „ergänze Folien“). Deckt alle Wege ab: von Grund auf (create_powerpoint), aus einer {{placeholder}}-Vorlage (create_powerpoint_from_template), aus einem Corporate-Master ohne Platzhalter über seine Folienlayouts (describe_pptx_template, create_powerpoint_from_layouts, add_slides_from_layouts, set_powerpoint_slide_fields) und aus einem Design-Deck, dessen Musterfolien nur Textfelder mit Blindtext haben („Text“, „XXX“, „TITEL“; per Code-Ausführung). Dazu iteratives Bearbeiten (append_slides_to_powerpoint, update_powerpoint_slide, read_powerpoint_slides), Klonen von Vorlagenfolien, Tabellen, Sprechernotizen, Bilder und Diagramme.'\n---\n\n# PowerPoint Skill\n\nAlles, was du brauchst, um `.pptx`-Foliensätze zu erstellen, zu erweitern und zu reparieren.\n\n## Tool-Übersicht\n\n| Tool                              | Zweck                                                                                |\n| --------------------------------- | ------------------------------------------------------------------------------------ |\n| `create_powerpoint`               | Neuer Foliensatz aus Markdown oder einem typisierten `slides`-Array (eigenes Design) |\n| `create_powerpoint_from_template` | Neuer Foliensatz aus einer POTX\u002FPPTX-Vorlage mit `{{placeholders}}`                  |\n| `describe_pptx_template`          | Liest die **nativen Folienlayouts** eines Foliensatzes – kein `{{}}` nötig           |\n| `create_powerpoint_from_layouts`  | Neuer Foliensatz durch Instanziieren dieser nativen Layouts (Corporate Design)       |\n| `add_slides_from_layouts`         | Hängt layout-native Folien an einen bestehenden Foliensatz an, **direkt in der Datei** |\n| `set_powerpoint_slide_fields`     | Ändert die nativen Platzhalter einer Folie (Text + Bilder) direkt in der Datei       |\n| `append_slides_to_powerpoint`     | Hängt Folien an einen bestehenden Foliensatz an, direkt in der Datei                 |\n| `update_powerpoint_slide`         | Ersetzt eine Folie eines bestehenden Foliensatzes, direkt in der Datei               |\n| `read_powerpoint_slides`          | Liest Foliennummern, Titel, Text **sowie Layout\u002FSlots jeder Folie**                  |\n| `list_my_files`                   | Findet einen Foliensatz, den der Nutzer im Chat angehängt hat (`file_id`)            |\n| `list_templates`                  | Findet verfügbare Vorlagen (`type: \"potx\"`) vor dem Erstellen                        |\n| `list_image_templates`            | Findet Bilder in der Bildbibliothek (`img:\u003Cname>`)                                   |\n| `embed_chart_in_document`         | Chart.js-Diagramm als neuer Foliensatz; `title` fügt eine Titelfolie hinzu           |\n\n---\n\n## 1. Iterativ arbeiten – keinen Foliensatz in einem Rutsch erzeugen\n\n**Ein Foliensatz mit mehr als ~6 Folien muss in mehreren Tool-Aufrufen entstehen.** Ein einziger\nriesiger `create_powerpoint`-Aufruf ist der häufigste Fehler: Die Argumente werden abgeschnitten,\nLayout-Entscheidungen lassen sich nicht korrigieren, und eine einzige fehlerhafte Folie bedeutet,\ndass alles neu generiert werden muss.\n\nDer Ablauf:\n\n```\nPLAN   → zuerst die Gliederung in deiner Antwort schreiben (Foliennummer, Rolle\u002FLayout, Überschrift, Inhaltsskizze)\nPROBE  → describe_pptx_template \u002F list_templates \u002F read_powerpoint_slides – herausfinden, was vorhanden ist\nSEED   → create_powerpoint* nur mit den ERSTEN 3–5 Folien → die zurückgegebene id (document_id) merken\nEXTEND → append_slides_to_powerpoint (Weg A\u002FB) oder add_slides_from_layouts (Weg C)\n         in Paketen von 3–5 Folien, wiederholt\nREFINE → set_powerpoint_slide_fields oder update_powerpoint_slide für einzelne Korrekturen\nVERIFY → read_powerpoint_slides, um Folienanzahl, Reihenfolge, Titel und übrig gebliebenen Blindtext zu prüfen\n```\n\n**Melde einen Foliensatz nie als fertig, bevor du ihn zurückgelesen hast.** Folien, die noch den\nBlindtext der Vorlage zeigen („Text“, „XXX“, „TITEL“, „Lorem ipsum“) oder leer herauskommen, sind ein\nFehler, kein Ergebnis. Korrigiere sie oder sag dem Nutzer genau, welche Folien nicht befüllt sind und\nwarum.\n\n### PLAN vor dem ersten Tool-Aufruf\n\nZeige dem Nutzer bei allem, was über ein paar Folien hinausgeht, einen Plan und lass ihn reagieren.\nDas kostet eine Nachricht und erspart den Neuaufbau eines 20-Folien-Foliensatzes.\n\n```\nPlan — \"Digitalstrategie 2027\" (12 Folien, Corporate-Master `folienmaster`)\n\n #  Layout \u002F Rolle     Überschrift                   Inhalt\n 1  title              Digitalisierungsstrategie 2027 Autor + Datum\n 2  section            1. Ausgangslage\n 3  content            Kernbefunde                   3 Aufzählungspunkte, 1 eingerückt\n 4  two-content        Handlungsoptionen             Option A | Option B\n 5  section            2. Zielbild\n …\n12  closing            —                             Kontaktblock\n\nIch erstelle zuerst 1–5 und hänge dann 6–12 in zwei Paketen an. Sag Bescheid, wenn sich die Struktur ändern soll.\n```\n\n### Faustregeln\n\n- **Paketgröße 3–5 Folien** pro Aufruf. Bei langen Aufzählungstexten oder `htmlTable`-Inhalten → 2–3.\n- **Behalte die `document_id`.** Der erste Erstellungsaufruf gibt die `id` des Foliensatzes zurück;\n  jeder Append-\u002FUpdate-\u002FPatch-Aufruf auf diesen Foliensatz behält _dieselbe_ id. Verwende sie weiter;\n  erstelle nie einen zweiten Foliensatz, um den ersten zu reparieren.\n- **Eine fehlerhafte Folie → nur diese Folie ändern.** `set_powerpoint_slide_fields` (layout-nativ)\n  oder `update_powerpoint_slide` (eigenes Design \u002F Klonmodus). Beide erhalten Folienanzahl und Position.\n- **`read_powerpoint_slides` zwischen den Paketen**, wenn du mehrfach angehängt hast, um sicherzugehen,\n  dass du die Folien von der richtigen Basis aus nummerierst.\n- **Melde den Fortschritt**, z. B. „Folien 1–5 fertig, als Nächstes hänge ich 6–9 an“, und gib den\n  zurückgegebenen `markdownLink` aus, damit der Nutzer den Zwischenstand öffnen kann.\n- **Nie neu erstellen, um anzuhängen.** `add_slides_from_layouts` \u002F `append_slides_to_powerpoint`\n  gibt es genau dafür, dass ein Foliensatz über mehrere Runden wachsen kann.\n\nJede Folie in einem **typisierten** `slides`-Array (`create_powerpoint`, `append_slides_to_powerpoint`,\n`update_powerpoint_slide`) **benötigt einen `title`** (Pflichtfeld, auch bei `section`-Folien) – eine\nFolie ohne `title` scheitert an der Validierung. Die `slides` der Layout-Tools haben eine andere\nStruktur – `layout`, `fields`, `images`, `notes` – und kein `title`-Feld; ein Titel gehört in\n`fields.title`.\n\n---\n\n## 2. Den Erstellungsweg wählen\n\nEntscheide einmal, ganz am Anfang. Werden Wege in einem Foliensatz gemischt, entsteht ein\nuneinheitliches Design.\n\n| Situation                                                     | Weg                                     |\n| ------------------------------------------------------------- | --------------------------------------- |\n| Keine Vorlage erwähnt, companyFILES-Design passt              | **A** `create_powerpoint`               |\n| Eine Vorlage existiert **und** enthält `{{key}}`-Markup       | **B** `create_powerpoint_from_template` |\n| Ein Corporate-Master \u002F Folienmaster **ohne** `{{}}`-Markup    | **C** `create_powerpoint_from_layouts`  |\n| Ein Design-Deck, dessen **Musterfolien** das Design als einfache Textfelder mit Blindtext tragen und dessen Layouts (fast) keine Text-Slots haben | **D** Musterfolien klonen und befüllen (Code-Ausführung, §4a) |\n\n**So unterscheidest du B, C und D:** Führe `describe_pptx_template` auf der Vorlage aus und lies\n`hasLegacyPlaceholders`.\n\n- `true` → der Foliensatz verwendet `{{}}` → Weg **B** (siehe auch **templates-skill**)\n- `false` → sieh dir die `slots` der Layouts an:\n  - die Layouts, die du brauchst, haben Text-Slots (`title`, `body:*`, …) → Weg **C**\n  - die Layouts haben **keine oder fast keine Text-Slots**, aber `read_powerpoint_slides` (mit\n    `include_layouts: false`) zeigt Text auf den eigenen Folien des Decks („Text“, „XXX“, „TITEL“,\n    „UNTERTITEL“, „Text 1 … Text 4“, eine Agenda mit „01 XXX“) → Weg **D**. Das Design steckt in den\n    Musterfolien, nicht in den Layouts. Eine Layout-Folie aus so einem Master kommt **leer** heraus\n    (nur Hintergrund, Logo und Fußzeile), und `set_powerpoint_slide_fields` meldet jeden Key als\n    `unknownFields`.\n- Gemischte Decks sind häufig: ein Titellayout mit echten Slots, aber Inhaltsfolien als Musterfolien.\n  Entscheide pro Folientyp; im Zweifel nimm Weg D für das ganze Deck, damit alle Folien aus derselben\n  Quelle stammen.\n\n`list_templates` (`type: \"potx\"`) listet Kandidaten auf und liefert für `{{}}`-Foliensätze eine\nAufschlüsselung der Platzhalter pro Folie. Den Layout-Katalog liefert es **nicht** – dafür nimmst du\n`describe_pptx_template`.\n\nEin Foliensatz, den der Nutzer im Chat angehängt hat, muss für Weg C nicht als Vorlage hochgeladen\nwerden – siehe nächster Abschnitt. Weg B ist die Ausnahme: `create_powerpoint_from_template` nimmt\nnur einen `template_name` entgegen.\n\n---\n\n## 2a. Der Nutzer hat eine `.pptx` im Chat angehängt\n\nDas ist der Normalfall: Jemand legt seinen Folienmaster oder einen bestehenden Foliensatz in die\nUnterhaltung und bittet um eine Präsentation „in diesem Design“ oder darum, den gerade geschickten\nFoliensatz zu erweitern. Bei einem Corporate-Master (ohne `{{}}`) **bitte den Nutzer nicht, ihn als\nVorlage hochzuladen** – die Layout-Tools, `read_powerpoint_slides`, `append_slides_to_powerpoint` und\n`update_powerpoint_slide` nehmen den Anhang direkt entgegen. `create_powerpoint_from_template` nicht:\nEs hat nur `template_name`, kein `document_id` \u002F `librechat_file_id`.\n\n```\nFIND    file_id aus dem Block \"Attached files in this message:\"\n        (kein Block: list_my_files → die .pptx anhand des Dateinamens wählen; list_documents \u002F\n        search_documents funktionieren auch – die id des Eintrags übergeben)\nPROBE   describe_pptx_template { \"librechat_file_id\": \"\u003Cfile_id>\" }\n        → hasLegacyPlaceholders entscheidet den Weg (B oder C)\n        read_powerpoint_slides { \"librechat_file_id\": \"\u003Cfile_id>\" }, wenn der Foliensatz Inhalte hat,\n        die du sehen oder erweitern musst – es meldet Layout und Slot-Keys jeder Folie\n        → Layouts ohne Text-Slots + Blindtext auf den Folien = Weg D (§4a)\nBUILD   (Weg C)\n        neuer Foliensatz → create_powerpoint_from_layouts { \"librechat_file_id\": ..., \"slides\": [...] }\n        erweitern        → add_slides_from_layouts     { \"librechat_file_id\": ..., \"slides\": [...] }\n        eine korrigieren → set_powerpoint_slide_fields { \"librechat_file_id\": ..., \"slide_number\": n, ... }\n```\n\n**Ein angehängter `{{}}`-Foliensatz (Weg B)** hat zwei Wege:\n\n- Um ihn mit `create_powerpoint_from_template` zu befüllen (Bilder, Diagramme, `repeat`), muss er\n  zuerst als Vorlage hochgeladen werden (Web-UI, `open_companyfiles_ui page=\"upload\"`); danach rufst du\n  das Tool mit diesem `template_name` auf.\n- Oder du bearbeitest den Anhang selbst im Klonmodus (§5): `update_powerpoint_slide` mit\n  `reference_slide` gleich `slide_number` plus `placeholders` befüllt eine Folie direkt in der Datei;\n  `append_slides_to_powerpoint` mit `reference_slide` plus `placeholders` fügt eine befüllte Kopie hinzu.\n\n**`librechat_file_id` und `document_id` sind austauschbare Eingaben.** Der Server löst beide auf,\nzuerst über das PVC. Übergib die id, die dir die Auflistung geliefert hat.\n\n**Neuer Foliensatz oder bearbeiteter Foliensatz?** Zwei verschiedene Absichten, zwei verschiedene Tools:\n\n| Der Nutzer möchte                                         | Tool                             | Ergebnis                                                 |\n| --------------------------------------------------------- | -------------------------------- | -------------------------------------------------------- |\n| Eine Präsentation **im Design** dieses Foliensatzes       | `create_powerpoint_from_layouts` | Ein **neues** Dokument; der Anhang bleibt unverändert    |\n| Weitere Folien **in** diesem Foliensatz                   | `add_slides_from_layouts`        | **Derselbe** Foliensatz, direkt in der Datei erweitert   |\n| Eine Folie dieses Foliensatzes geändert                   | `set_powerpoint_slide_fields`    | **Derselbe** Foliensatz, eine Folie geändert             |\n\nBei einem Anhang bedeutet „direkt in der Datei“: Die Datei wird auf dem gemeinsamen LibreChat-Volume\nüberschrieben, wenn dieses Volume eingebunden ist (gleiche `file_id`); andernfalls wird die geänderte\nKopie als neues companyFILES-Dokument gespeichert. Die `message` in der Antwort sagt, was passiert\nist – gib das weiter, statt dem Nutzer zu versprechen, dass seine Originaldatei geändert wurde.\n\n**Ein aus Markdown erstellter Foliensatz hat keine befüllbaren Layouts.** `add_slides_from_layouts`\nlehnt ihn ab und nennt stattdessen `append_slides_to_powerpoint`; diese Ablehnung ist korrekt, umgehe\nsie nicht.\n\n---\n\n## 3. Weg A – von Grund auf (`create_powerpoint`)\n\n### Markdown-Modus (schnell, textlastige Foliensätze)\n\n`#` oder `##` beginnt eine neue Folie. Alle Folien erhalten das Layout `default`. Eine Zeile, die\ngenau `???` enthält, beginnt Sprechernotizen, die bis zur nächsten `#`\u002F`##`-Überschrift reichen.\n\n> **`title` fügt eine Folie hinzu.** Das Top-Level-Argument `title` von `create_powerpoint` stellt\n> eine generierte dunkle Titelfolie (Titel, Autor, heutiges Datum) voran. `n` Inhaltsfolien plus\n> `title` ergeben also `n + 1` Folien, und jede spätere `slide_number` verschiebt sich um eins. Lass\n> `title` weg, wenn du die Eröffnungsfolie selbst gestalten willst. `append_slides_to_powerpoint`\n> fügt nie eine hinzu.\n\n```json\n{\n  \"markdown\": \"# Quarterly Results\\n\\n- Revenue: €1.2M\\n- Growth: 15%\\n\\n???\\nOpen with the revenue number.\\n\\n## Key Highlights\\n\\n- Launched new product\\n- Expanded to 3 markets\",\n  \"filename\": \"q4_results\",\n  \"title\": \"Q4 2025 Results\",\n  \"author\": \"Strategy Team\"\n}\n```\n\nInline-Bilder im Markdown von `create_powerpoint` verwenden `doc:\u003CdocumentId>`, `lc:\u003Cfile_id>` oder\n`img:\u003Cname>` (Bildbibliothek, siehe §6):\n\n```markdown\n![Chart](doc:abc12345-...)\n![Attachment](lc:xyz-librechat-file-id)\n![Team](img:office-team)\n```\n\n### Modus mit typisierten Folien (Layout-Kontrolle)\n\nÜbergib `slides` statt `markdown`. Sind beide angegeben, gewinnt `slides`.\n\n| `type`         | Darstellung                                                  | Felder                                                               |\n| -------------- | ------------------------------------------------------------ | -------------------------------------------------------------------- |\n| `\"default\"`    | Akzentbalken + Titel + gestapelter Inhalt                    | `title`, `content`, `bullets`, `code`, `table`, `htmlTable`, `image` |\n| `\"section\"`    | Dunkler Hintergrund, großer zentrierter Titel – Kapiteltrenner | `title`, `subtitle`                                                |\n| `\"text-image\"` | Titel oben, Text\u002FAufzählung links, Bild rechts               | `title`, `content`, `bullets`, `htmlTable`, `image`, `imageAlt`      |\n\nJeder Typ akzeptiert zusätzlich `notes` (Sprechernotizen). Unbekannte `type`-Werte fallen auf\n`\"default\"` zurück. Fehlt `image` auf einer `text-image`-Folie, wird ein Skelett-Platzhalterkasten\ngezeichnet – nützlich für Entwürfe.\n\n**Titel bleiben einzeilig** (Inhalts-, Titel- und Abschnittsfolien): Ein langer Titel wird kleiner gesetzt (bis\n16 pt), einer mit mehr als etwa 60 Zeichen mit „…“ gekürzt. Halte Folientitel kurz und stell Details in den Inhalt.\n\n```json\n{\n  \"slides\": [\n    { \"type\": \"section\", \"title\": \"Q4 2025 Results\", \"subtitle\": \"Strategy Team\" },\n    {\n      \"type\": \"default\",\n      \"title\": \"Key Metrics\",\n      \"bullets\": [\"Revenue: €1.2M\", \"Growth: 15%\", \"NPS: 72\"],\n      \"notes\": \"Lead with revenue; growth is YoY, not QoQ — expect that question.\"\n    },\n    {\n      \"type\": \"text-image\",\n      \"title\": \"System Architecture\",\n      \"bullets\": [\"Microservices\", \"Auto-scaling\", \"99.9% uptime\"],\n      \"image\": \"https:\u002F\u002Fwww.example.com\u002Farchitecture.png\",\n      \"imageAlt\": \"Architecture diagram\"\n    }\n  ],\n  \"title\": \"Q4 2025 Results\",\n  \"filename\": \"q4_results\"\n}\n```\n\n`bullets` ist hier ein flaches `string[]` – für eingerückte Aufzählungen nutzt du Weg C (`level`)\noder eine Vorlage. Das Feld `image` nimmt `lc:\u003Cfile_id>` (Chat-Anhang oder erzeugtes Bild, siehe\n`list_my_files`), `doc:\u003Cdocument_id>`, `img:\u003Cname>` (Bildbibliothek), eine base64-Data-URI oder eine\nöffentliche http(s)-URL (siehe §6). `imageFit` legt fest, wie es seinen Bereich füllt: `\"contain\"`\n(Standard, ganzes Bild, mittig), `\"cover\"` (füllt den Bereich, beschneidet) oder `\"stretch\"` (verzerrt –\nnur auf Wunsch). Dasselbe gilt in `append_slides_to_powerpoint` und `update_powerpoint_slide`.\n\n**Natives Diagramm auf einer Folie:** Ergänze `chart` auf einer `default`-Folie (unter dem Text) oder einer\n`text-image`-Folie (ersetzt das Bild – nimm `image` **oder** `chart`, nicht beides). Es ist ein echtes,\nbearbeitbares PowerPoint-Diagramm („Daten bearbeiten“ öffnet die Zahlen in Excel) in den Farben und der\nSchrift der Corporate Identity. `section`-Folien zeigen keines. Die Daten haben dieselbe Form wie bei\n`show_interactive_chart`:\n\n```json\n{\n  \"type\": \"default\",\n  \"title\": \"Umsatz je Quartal\",\n  \"bullets\": [\"Q3 ist das stärkste Quartal\"],\n  \"chart\": {\n    \"type\": \"bar\",\n    \"labels\": [\"Q1\", \"Q2\", \"Q3\"],\n    \"datasets\": [{ \"label\": \"2026\", \"data\": [12, 15, 19] }],\n    \"showValues\": true\n  }\n}\n```\n\n`chart.type`: `bar`, `horizontalBar`, `stackedBar`, `line`, `area`, `pie`, `doughnut`, `scatter`, `radar`\n(`pie`\u002F`doughnut` zeigen nur die erste Datenreihe). Optional: `title`, `showLegend`, `showValues`,\n`numberFormat` (Excel-Format, z. B. `\"#,##0\"`), `xAxisTitle`, `yAxisTitle`. Grenzen: höchstens 20 Datenreihen\nmit je 1000 Punkten; jede Datenreihe braucht genau eine Zahl je Label, sonst bricht das Tool ab und nennt die\nDatenreihe. Funktioniert auch in `append_slides_to_powerpoint` und `update_powerpoint_slide`.\n\n### Formatierte Tabellen – `htmlTable`\n\nVerwende `htmlTable` statt `table`, wenn Zellen Farbe, Fettdruck oder Ausrichtung brauchen.\nUnterstützt auf `default` und `text-image`; hat Vorrang vor `table`.\n\n| Inline-CSS                        | Wirkung       |\n| --------------------------------- | ------------- |\n| `background-color: #hex`          | Zellfüllung   |\n| `color: #hex`                     | Textfarbe     |\n| `font-weight: bold`               | Fett          |\n| `font-style: italic`              | Kursiv        |\n| `text-align: left\\|center\\|right` | Ausrichtung   |\n\n`\u003Cth>`-Zellen erhalten automatisch Kopfzeilenfüllung\u002F-text des Themes, sofern nicht überschrieben.\n\n```json\n{\n  \"type\": \"default\",\n  \"title\": \"Revenue by Region\",\n  \"htmlTable\": \"\u003Ctable>\u003Ctr>\u003Cth>Region\u003C\u002Fth>\u003Cth>Q1\u003C\u002Fth>\u003Cth>vs PY\u003C\u002Fth>\u003C\u002Ftr>\u003Ctr>\u003Ctd style=\\\"font-weight:bold\\\">DACH\u003C\u002Ftd>\u003Ctd>€1.2M\u003C\u002Ftd>\u003Ctd style=\\\"color:#16A34A\\\">+18%\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd style=\\\"font-weight:bold\\\">US\u003C\u002Ftd>\u003Ctd>€0.8M\u003C\u002Ftd>\u003Ctd style=\\\"color:#DC2626\\\">-3%\u003C\u002Ftd>\u003C\u002Ftr>\u003C\u002Ftable>\"\n}\n```\n\nFür ein einfaches Raster reicht `table: string[][]` (erste Zeile = Kopfzeile).\n\n---\n\n## 4. Weg C – Corporate-Master ohne `{{}}` (layout-nativ)\n\nDas ist der Weg für einen Foliensatz, den das Design-Team geliefert hat, z. B. eine\n`Corporate-Master.pptx`. Solche Foliensätze enthalten **kein `{{}}`-Markup**, sondern nur benannte\nFolienlayouts mit den eigenen Platzhaltern von OOXML. Inhalte werden an diese Platzhalter gebunden\nund es wird **keine Formatierung geschrieben**, sodass Schriften, Farben, Logos und Geometrie aus dem\nMaster stammen. („Folie zurücksetzen“ in PowerPoint ändert nichts – das ist der Beweis.)\n\nLade einen solchen Master als Vorlage hoch (eine `.pptx` wird als Typ `potx` gespeichert) – oder,\nwenn der Nutzer ihn im Chat angehängt hat, verwende direkt seine `librechat_file_id` (Abschnitt 2a).\n\n### Schritt 1 – `describe_pptx_template`\n\n```json\n{ \"template_name\": \"folienmaster\" }\n```\n\nLiefert:\n\n```json\n{\n  \"hasLegacyPlaceholders\": false,\n  \"slideSize\": { \"widthEmu\": 12192000, \"heightEmu\": 6858000 },\n  \"roleMap\": { \"title\": \"slideLayout5.xml\", \"section\": \"slideLayout8.xml\", \"content\": \"slideLayout9.xml\" },\n  \"layouts\": [\n    {\n      \"layoutId\": \"slideLayout11.xml\",\n      \"name\": \"Titel_mit_Inhalt\",\n      \"masterId\": \"slideMaster3.xml\",\n      \"role\": \"content\",\n      \"exampleSlides\": [4],\n      \"slots\": [\n        { \"key\": \"title\", \"type\": \"title\" },\n        { \"key\": \"body:10\", \"type\": \"body\", \"hint\": \"Mastertextformat bearbeiten\" },\n        { \"key\": \"pic:14\", \"type\": \"pic\", \"isImage\": true, \"aspectRatio\": 1.78 }\n      ]\n    },\n    {\n      \"layoutId\": \"slideLayout9.xml\",\n      \"name\": \"Inhalt\",\n      \"role\": \"content\",\n      \"exampleSlides\": [],\n      \"slots\": [{ \"key\": \"title\" }, { \"key\": \"body:12\" }, { \"key\": \"body:13\" }]\n    }\n  ]\n}\n```\n\nSo liest du das:\n\n- **`layoutId` ist der stabile Bezeichner.** Layout-**Namen wiederholen sich** über Folienmaster\n  hinweg (ein echter Foliensatz hatte `Präsentationstitel` 3× verteilt auf 5 Master). Bevorzuge `layoutId`.\n- **Slot-Keys lauten `type` oder `type:idx`.** Der `idx` zählt: `body:12` + `body:13` im selben\n  Layout bedeutet ein zweispaltiges Layout – befülle beide, um beide Spalten zu nutzen. Die Nummer\n  sagt **nicht**, welcher Kasten links oder oben steht: `body:13` kann die rechte Spalte sein. Prüfe\n  die Position (der `at`-Wert von `--lists`, siehe „Listen kommen aus der Vorlage“ unten) oder\n  befülle die Spalten mit Texten, deren Reihenfolge egal ist.\n- **`role`** wird aus dem Layoutnamen (deutsche + englische Schlüsselwörter) und der Zusammensetzung\n  seiner Slots abgeleitet. Rollen: `title`, `title-image`, `section`, `content`, `two-content`,\n  `title-only`, `closing`, `reference`. `roleMap` wählt pro Rolle ein Layout.\n- **`hint`** ist der eigene Aufforderungstext des Layouts und nur ein Hinweis – echte Master sagen oft\n  „Mastertextformat bearbeiten“ oder Lorem ipsum. Urteile nach Name + Slot-Struktur, nicht nach dem Hinweis.\n- **`isImage`-Slots (`pic:*`) erhalten ein Bild über das separate Argument `images`**, nicht über\n  `fields`. `aspectRatio` (Breite ÷ Höhe des Slot-Rahmens) zeigt dir, was sich gut zuschneiden lässt –\n  das Bild wird mittig auf dieses Verhältnis zugeschnitten, nie verzerrt. Aus der Bildbibliothek wählst\n  du ein Bild mit ähnlichem `aspectRatio` (`list_image_templates` mit `aspect_ratio`). Ein Slot, für den du kein\n  Bild übergibst, bleibt leer und erscheint in `imageSlotsNotFilled`; versprich dem Nutzer dann kein Bild.\n- **`acceptsChart`-Slots** (Platzhaltertypen `chart`, `obj`, `body`) erhalten ein natives Diagramm über das\n  separate Argument `charts` (siehe „Diagramme“ unten). `read_powerpoint_slides` meldet `acceptsChart` ebenfalls.\n\n### Schritt 2 – `create_powerpoint_from_layouts`\n\nJede Folie wählt ihr Layout über `layoutId`, Layoutnamen oder Rolle – frei kombinierbar.\n\n```json\n{\n  \"template_name\": \"folienmaster\",\n  \"filename\": \"strategie-2027\",\n  \"slides\": [\n    {\n      \"layout\": \"title\",\n      \"fields\": { \"title\": \"Digitalisierungsstrategie 2027\", \"body:11\": \"Dr. Max Mustermann\\n27.07.2026\" },\n      \"notes\": \"Begrüßung, 2 Minuten.\"\n    },\n    { \"layout\": \"Kapiteltrenner\", \"fields\": { \"title\": \"1. Ausgangslage\" } },\n    {\n      \"layout\": \"slideLayout11.xml\",\n      \"fields\": {\n        \"title\": \"Kernbefunde\",\n        \"body:10\": [\n          \"Drei Systeme decken 80 % ab\",\n          { \"text\": \"Redundante Datenhaltung\", \"level\": 1 },\n          \"Betriebskosten +9 % p. a.\"\n        ]\n      }\n    },\n    {\n      \"layout\": \"Inhalt\",\n      \"fields\": {\n        \"title\": \"Handlungsoptionen\",\n        \"body:12\": [\"Option A: Konsolidierung\", \"Aufwand: hoch\"],\n        \"body:13\": [\"Option B: Schnittstellen\", \"Aufwand: mittel\"]\n      }\n    },\n    { \"layout\": \"closing\", \"fields\": { \"body:11\": \"Muster GmbH\\n12345 Musterstadt\" } }\n  ]\n}\n```\n\n**Bilder** gehören in ein `images`-Objekt pro Folie, mit Keys wie bei `fields` (exakter Slot-Key, der\nbloße Typ `pic` oder die Synonyme `image`\u002F`picture`\u002F`photo`). Als Quellen dienen die üblichen drei:\n\n```json\n{\n  \"layout\": \"title-image\",\n  \"fields\": { \"title\": \"Standort München\" },\n  \"images\": { \"pic:14\": { \"librechat_file_id\": \"abc-attachment-id\" } }\n}\n```\n\n`{ \"document_id\": \"...\" }` (ein PVC-Upload), `{ \"image_template\": \"...\" }` (Bildbibliothek) und\n`{ \"base64\": \"...\" }` funktionieren genauso. Das Bild übernimmt Position und Größe aus dem Layout und wird\nauf das Seitenverhältnis des Slots zugeschnitten (`cover`). Soll das ganze Bild zu sehen sein, nutze die\nObjektform mit `\"fit\": \"contain\"` (ein Rahmen im Seitenverhältnis des Bildes, mittig im Slot); `\"stretch\"`\nnur auf Wunsch. Auch einfache Strings gehen: `\"images\": { \"pic:14\": \"lc:abc-attachment-id\" }` (ebenso\n`doc:\u003Cdocument_id>`, `img:\u003Cname>` oder eine `data:image\u002F…`-URI). Eine nicht auflösbare\n`lc:`\u002F`doc:`\u002F`img:`-Referenz bricht den Aufruf ab, der Fehler nennt sie.\n\n**Diagramme** gehören in ein `charts`-Objekt pro Folie, mit Keys wie bei `fields` (exakter Slot-Key wie\n`chart:15` oder der bloße Typ; `content`\u002F`chart` nehmen den ersten freien Chart-, Obj- oder Body-Slot).\nDas Diagramm füllt den Rahmen des Slots (aus dem Layout, sonst aus dem Folienmaster; ohne Rahmen ein Fehler\nmit dem Slot-Namen) in den Theme-Farben (Design → Farben) und der Theme-Schrift des Decks. Ein Slot nimmt ein\nFeld **oder** ein Diagramm, nicht beides. Dasselbe Diagrammobjekt wie bei `slides[].chart` oben:\n\n```json\n{\n  \"layout\": \"Diagramm\",\n  \"fields\": { \"title\": \"Umsatz je Quartal\" },\n  \"charts\": {\n    \"chart:15\": {\n      \"type\": \"bar\",\n      \"labels\": [\"Q1\", \"Q2\", \"Q3\"],\n      \"datasets\": [{ \"label\": \"2026\", \"data\": [12, 15, 19] }]\n    }\n  }\n}\n```\n\n`charts` funktioniert genauso in `add_slides_from_layouts` und `set_powerpoint_slide_fields`.\n\n**Slot-Werte** akzeptieren drei Formen:\n\n| Wert                              | Ergebnis                                                   |\n| --------------------------------- | ---------------------------------------------------------- |\n| `\"one line\"`                      | Ein Absatz auf Ebene 0; `\\n` teilt in mehrere Absätze      |\n| `[\"a\", \"b\"]`                      | Ein Absatz pro Element, alle auf Ebene 0                   |\n| `[{ \"text\": \"sub\", \"level\": 1 }]` | Ein Absatz auf Ebene `level` 0–8                           |\n\nIm Text werden `**fett**`, `*kursiv*` und `~~durchgestrichen~~` formatiert; Schrift, Größe und Farbe bleiben die des\nLayouts. Links erscheinen als „Text (URL)“, nicht klickbar.\n\nWeggelassene Slots bleiben leer und zeigen in PowerPoint den Aufforderungstext des Layouts.\n\n**Listen kommen aus der Vorlage, nicht von dir.** Das Tool schreibt keine eigenen Aufzählungs- oder\nNummerierungseinstellungen. Jeder Absatz übernimmt das Zeichen seiner Ebene aus dem Listenformat des\nPlatzhalters im Master: einen Aufzählungspunkt, eine Nummer oder nichts. Ein String und ein Array\nsehen **gleich** aus. Das Array teilt den Text nur in Absätze; es schaltet keine Aufzählung ein oder\naus. Das heißt:\n\n- **Tippe nie selbst Listenzeichen.** Kein `•`, `-`, `–`, `*`, `1.`, `a)` oder `→` am Zeilenanfang.\n  Auf einer Ebene mit Aufzählungszeichen entsteht sonst `• • Text` oder `• 1. Text`. Schreib den\n  reinen Text, die Vorlage setzt das Zeichen.\n- **Ein Absatz kann sein Aufzählungszeichen nicht abschalten.** In einem Platzhalter, dessen Ebene 0\n  Aufzählungszeichen hat, bekommt jede Zeile auf Ebene 0 einen Punkt, auch eine Überschrift oder ein\n  Einleitungssatz. Überschriften gehören in den `title`-\u002F`ctrTitle`-Slot des Layouts oder in ein\n  Layout mit eigenem Überschrift-Slot oder einer Ebene ohne Zeichen. Schreib „OPTION A“ nicht als\n  ersten Punkt einer Spalte.\n- **Nummerierte oder schlichte Zeilen brauchen eine Ebene oder einen Slot, der so formatiert ist.**\n  Nummeriert die Vorlage eine Ebene, nutze sie; sonst ist die Liste eine Aufzählung, also setz keine\n  eigenen Nummern dazu. Agendapunkte, Schritte und Kapitelnummern gehören in Slots ohne\n  Aufzählungszeichen. Passt keiner, schreib die Punkte ohne Nummern.\n- **Viele Firmen-Master nutzen Ebene 0 für Fließtext und Ebene 1 für Aufzählungen** (Beispieltext\n  „Mastertextformat bearbeiten \u002F Zweite Ebene …“). Bei so einem Master schreibst du Einleitungstext\n  auf Ebene 0 und die Listenpunkte mit `\"level\": 1`.\n\nWelche Ebene Aufzählungszeichen hat, zeigt `describe_pptx_template` nicht. Mit Code-Ausführung liest\ndu es aus der Vorlage (siehe unten), ohne Code hältst du dich an die Regeln oben. Lies das Deck nach\ndem Erstellen mit `read_powerpoint_slides` zurück: Zeilen, die mit einem selbst getippten `•`, `-`\noder einer Nummer beginnen, sind ein Fehler. Sag dem Nutzer, dass die Aufzählungszeichen aus der\nVorlage kommen, und bitte ihn, eine Inhaltsfolie zu prüfen.\n\n**Wenn Code-Ausführung verfügbar ist**, lies Listenformat und Position jedes Slots aus, bevor du\nplanst. Hänge die Vorlage an (`attach_template_to_chat`, siehe **templates-skill**) und führe das\nmitgelieferte Skript aus. Es ist nur da, wenn der Skill als Paket installiert wurde (Zip \u002F Sync):\n\n```bash\npython3 \u002Fmnt\u002Fdata\u002Fskills\u002Fpowerpoint-skill\u002Fscripts\u002Fpptx_inventory.py \"\u002Fmnt\u002Fdata\u002F\u003Cvorlage>.pptx\" --lists\n```\n\n```text\n== slideLayout9.xml \"Text_Box_OB\"\n  body:13      at 52%,30%  L0=bullet '•'  L1=bullet '–'  L2=none …\n  body:14      at  5%,30%  L0=bullet '•'  L1=bullet '–'  L2=none …\n```\n\n`L0=bullet` = Zeilen auf Ebene 0 bekommen einen Aufzählungspunkt, `L0=number arabicPeriod` =\nnummeriert, `L0=none` = schlichter Text. Ein Zeichen wie `'§'` oder `'n'` stammt aus einer\nSymbolschrift (Quadrat, Strich, …) und ist trotzdem ein Aufzählungszeichen. `at x%,y%` ist die linke\nobere Ecke des Slots: Hier ist `body:14` die **linke** Spalte, obwohl die Nummer höher ist. Fehlt das\nSkript, gelten die Regeln oben ohne es.\n\n**Optionen für den Basis-Foliensatz:**\n\n- `drop_template_slides` (Standard `true`) entfernt die eigenen Folien des Quell-Foliensatzes.\n  Folienmaster, Layouts, Themes und Medien bleiben **immer** erhalten.\n- `drop_template_slides: false` behält sie und hängt danach an – das Ergebnis wird jedoch als **neues**\n  Dokument gespeichert. Um einen Foliensatz direkt in der Datei wachsen zu lassen, verwende\n  `add_slides_from_layouts` (Schritt 3).\n- Statt `template_name` kannst du `document_id` (eine gespeicherte `.pptx`) oder `librechat_file_id`\n  (einen Anhang) übergeben, um diesen Foliensatz als Basis zu verwenden. Da die Layouts erhalten\n  bleiben, lässt sich ein so erstellter Foliensatz später erweitern – das ist der iterative Weg für Weg C.\n- `role_map` überschreibt die Ableitung: `{ \"content\": \"slideLayout4.xml\" }`.\n\nDie **Antwort** meldet pro Folie: `layoutId`, `layoutName`, `filledSlots`, `filledImageSlots`,\n`unknownFields`, `emptySlots`. Prüfe immer `unknownFields` – ein vertippter Slot-Key wird gemeldet,\nnicht stillschweigend verworfen. Bild-Slots, die kein Bild erhalten haben, stehen in\n`imageSlotsNotFilled` (mit einer `note`).\n\n### Schritt 3 – `add_slides_from_layouts` (Foliensatz direkt in der Datei erweitern)\n\nDas In-place-Gegenstück zu Schritt 2: dasselbe `slides`-Array, aber es zielt über `document_id` \u002F\n`librechat_file_id` auf einen bestehenden Foliensatz und **behält dasselbe Dokument**. So wächst ein\nWeg-C-Foliensatz über mehrere Runden – erstelle den Foliensatz nie neu, um Folien hinzuzufügen.\n\n```json\n{\n  \"document_id\": \"\u003Cid>\",\n  \"slides\": [\n    { \"layout\": \"Kapiteltrenner\", \"fields\": { \"title\": \"2. Zielbild\" } },\n    { \"layout\": \"slideLayout11.xml\", \"fields\": { \"title\": \"Roadmap\", \"body:10\": [\"Q1\", \"Q2\"] } }\n  ]\n}\n```\n\n- `insert_after: n` setzt die neuen Folien hinter Folie `n` (`0` = vor Folie 1). Weglassen, um anzuhängen.\n- Liefert `slides_before` \u002F `slides_after` \u002F `slides_added` plus denselben Bericht pro Folie.\n- Lehnt einen Foliensatz ab, dessen Layouts keine nativen Platzhalter haben (einen aus Markdown\n  erstellten Foliensatz), und nennt stattdessen `append_slides_to_powerpoint` – in diesem Fall wird\n  nichts geschrieben. Ebenfalls ohne zu schreiben lehnt es ab, wenn überhaupt kein Slot befüllt wird\n  (typischerweise: keiner der übergebenen Keys passt zu einem Slot).\n\n### Schritt 4 – `set_powerpoint_slide_fields` (eine Folie ändern)\n\nÄndert **eine** Folie direkt in der Datei. Nur die übergebenen Slots ändern sich; alle anderen Slots,\nFormen, Bilder und die Position der Folie bleiben unberührt. Slots, die das Layout anbietet, die Folie\naber noch nicht enthält, werden hinzugefügt – auch Bild-Slots.\n\n```json\n{\n  \"document_id\": \"\u003Cid>\",\n  \"slide_number\": 3,\n  \"fields\": { \"title\": \"Kernbefunde (überarbeitet)\", \"body:10\": [\"Neuer Punkt 1\", \"Neuer Punkt 2\"] },\n  \"images\": { \"pic:14\": { \"librechat_file_id\": \"abc-attachment-id\" } }\n}\n```\n\n`fields` oder `images` allein genügt – übergib beides nur, wenn du beides ändern willst. Das ist das\nTool, das du über mehrere Runden immer wieder aufrufst, während der Nutzer den Foliensatz prüft.\nAkzeptiert auch `librechat_file_id` (der Anhang wird auf dem gemeinsamen Volume aktualisiert, sofern\nverfügbar).\n\n### Wie eine `layout`-Referenz aufgelöst wird\n\nDas `layout` einer Folie wird in dieser Reihenfolge abgeglichen: eine `layoutId` → eine Rolle (ein\nexpliziter `role_map`-Eintrag überschreibt die abgeleitete `roleMap`) → ein Layoutname.\n`{{slide_type:x}}`-Marker spielen hier keine Rolle; sie steuern nur `repeat`-Datensätze in\n`create_powerpoint_from_template` (siehe **templates-skill**). **Bitte den Nutzer nie, `{{}}`-Marker\nin einen Corporate-Master einzutippen** – genau das macht Weg C überflüssig.\n\n---\n\n## 4a. Weg D – Design-Deck mit Blindtext auf den Musterfolien\n\nViele Firmenvorlagen sind nicht so gebaut, wie PowerPoint es vorsieht. Die Designer haben die\nInhaltsbereiche als **einfache Textfelder auf Musterfolien** angelegt (Titelfolie, Agenda,\nKapiteltrenner, Inhaltsfolie, Abschlussfolie) und mit Blindtext gefüllt: „Text“, „XXX“, „TITEL“,\n„UNTERTITEL“, „Text 1 … Text 4“, „01 XXX“. Die Layouts hinter diesen Folien tragen nur Hintergrund,\nLogo, Fußzeile und Foliennummer. Deshalb finden die Layout-Tools aus Weg C nichts zum Befüllen.\n\nSo ein Deck nutzt du so, wie es ein Mensch tun würde: **die passende Musterfolie duplizieren, ihre\nTextfelder überschreiben, die nicht genutzten Musterfolien löschen.** companyFILES hat kein Tool, das\neinfache Textfelder bearbeitet, deshalb braucht dieser Weg Code-Ausführung.\n\n**Erst planen, wie in §1:** Nenne für jede Folie des neuen Decks die Musterfolie, die sie kopiert\n(„Folie 5 = Inhaltsfolie mit drei Bullets“), und den Text für jedes ihrer Textfelder. Eine Musterfolie\nkannst du beliebig oft verwenden; nicht benötigte Musterfolien fallen weg. Halte die Texte ungefähr so\nlang wie den Blindtext. Die Felder haben eine feste Größe, und niemand sieht die Folie, bevor der\nNutzer sie öffnet.\n\n### Wenn Code-Ausführung verfügbar ist\n\nDas angehängte Deck liegt in der Sandbox unter `\u002Fmnt\u002Fdata\u002F\u003Cdateiname>.pptx` (eine companyFILES-Vorlage:\nerst `attach_template_to_chat`, siehe **templates-skill**). Dieser Skill bringt zwei Skripte mit, unter\n`\u002Fmnt\u002Fdata\u002Fskills\u002Fpowerpoint-skill\u002Fscripts\u002F`, wenn er als Paket installiert wurde:\n\n1. **Inventur**: listet jedes Shape mit ID und Absätzen auf:\n\n   ```bash\n   python3 \u002Fmnt\u002Fdata\u002Fskills\u002Fpowerpoint-skill\u002Fscripts\u002Fpptx_inventory.py \"\u002Fmnt\u002Fdata\u002F\u003Cdeck>.pptx\"\n   ```\n\n   Jede Zeile lautet `id=\u003Cshape id> \u003Cart> \"\u003Cname>\"  [0] 'Absatz 0'  [1] 'Absatz 1' …`.\n   `box` = einfaches Textfeld (Inhalt für Weg D), `ph:*` = echter Platzhalter, `tbl` = Tabelle\n   (Zellen als `r\u003Czeile>c\u003Cspalte>`), `in=\u003Cid>` = in einer Gruppe. `!DUMMY` markiert Blindtext. Große\n   Decks: `--slides 1-10` anhängen (die Ausgabe eines Aufrufs ist auf etwa 64 KB begrenzt).\n   - `fit≈22ch×3 lines` = ungefähr so viel Text fasst das Feld laut Design. Die farbige Kachel oder\n     der abgerundete Kasten hinter einem Textfeld ist für seinen Blindtext bemessen. Plane deine\n     Texte innerhalb dieser Grenze: Eine Überschrift mit 6 Zeichen braucht einen kurzen Ersatz, keinen\n     Satz.\n   - `\u003Cr>` in einem Absatz markiert einen Formatwechsel, z. B. `'01 \u003Cr>TITEL'` = fette Nummer + normaler\n     Titel. Behalte das `\u003Cr>` in deinem Text (`\"02 \u003Cr>PORTFOLIO\"`), dann bleiben beide Formate.\n\n2. **Befüllen**: Plan schreiben und das Deck in einem Aufruf bauen:\n\n   ```bash\n   cat > \u002Ftmp\u002Fplan.json \u003C\u003C'EOF'\n   {\"slides\": [\n     {\"from\": 1, \"texts\": {\"8\": \"Jahresbericht 2026\", \"18\": \"Berlin, 28.10.2026\"}, \"notes\": \"Begrüßung\"},\n     {\"from\": 2, \"texts\": {\"3\": [\"Markt\", \"Produkte\", \"Team\", \"Ausblick\"]}},\n     {\"from\": 5, \"texts\": {\"4\": [\"Stärke eins\", \"Stärke zwei\", \"Stärke drei\"], \"6\": \"01 UNTERNEHMEN\"}},\n     {\"from\": 5, \"texts\": {\"4\": [\"Zweite Folie\", \"im selben Design\"], \"6\": \"02 PRODUKTE\"}},\n     {\"from\": 8, \"replace\": {\"Musterfirma\": \"Acme GmbH\"}}\n   ]}\n   EOF\n   python3 \u002Fmnt\u002Fdata\u002Fskills\u002Fpowerpoint-skill\u002Fscripts\u002Fpptx_fill.py \"\u002Fmnt\u002Fdata\u002F\u003Cdeck>.pptx\" \u002Ftmp\u002Fplan.json \"\u002Fmnt\u002Fdata\u002F\u003Cergebnis>.pptx\"\n   ```\n\n   - `from` = Nummer der Musterfolie, `texts` = Shape-ID → neuer Text. Die Shape-IDs bleiben auf\n     jeder Kopie einer Musterfolie gleich.\n   - Ein Text ist ein String (`\\n` = neuer Absatz, `\u003Cbr>` = Zeilenumbruch), eine Liste von Absätzen\n     (einer pro Bullet; `null` behält einen Absatz) oder `{\"\u003Cabsatz-index>\": \"text\"}`, um einzelne\n     Zeilen eines Felds zu ändern (ein Feld mit `'XXX'  ''  'XXX'` = Überschrift, Leerzeile,\n     Beschreibung).\n   - Außerdem: `tables` (Shape-ID → Zeilen × Zellen), `images` (Shape-ID → `\u002Fmnt\u002Fdata\u002F\u003Cbild>`, tauscht\n     ein Bild und behält seinen Rahmen), `delete` (Shape-IDs, z. B. ein „ABBILDUNG“-Feld, für das du kein\n     Bild hast), `replace` (Teilstring auf der ganzen Folie), `notes`.\n   - Schreib den Plan im **selben** Aufruf nach `\u002Ftmp`. Dateien in `\u002Fmnt\u002Fdata` werden zu Chat-Anhängen,\n     und `\u002Ftmp` wird nach jedem Aufruf geleert.\n   - Das Skript behält die Formatierung jedes Absatzes (Schrift, Größe, Farbe, Bullet), kopiert Diagramme\n     und Bilder mit der Folie und überschreibt die Quelle nie.\n\n3. **Prüfen**: Das Befüll-Skript endet mit einer Prüfung und beendet sich mit Code 2, wenn Blindtext\n   übrig ist (`CHECK FAILED` mit Folie, Shape-ID und Text). Korrigiere den Plan und führe ihn erneut aus.\n   Eine `FIT WARNING` heißt: Ein Text ist zu lang für sein Feld oder die Form dahinter und läuft über das\n   Design hinaus. Kürze genau diese Texte und führe den Plan erneut aus, bis keine Warnung mehr kommt.\n   Einzeln prüfen geht auch: `pptx_inventory.py \"\u002Fmnt\u002Fdata\u002F\u003Cergebnis>.pptx\" --check`. Lass die Inventur\n   noch einmal über das Ergebnis laufen und vergleiche sie mit deinem Plan, bevor du antwortest.\n\n4. **Antworten**: Das Ergebnis kommt als Chat-Anhang zurück. Sag, aus welcher Musterfolie jede Folie\n   stammt und dass du nur den Text prüfen konntest, nicht das Aussehen. Bitte den Nutzer, auf Text zu\n   achten, der zu lang für sein Feld ist.\n\n**Schreib keinen eigenen Befüll-Code, wenn die Skripte da sind.** Prüfe zuerst:\n`ls \u002Fmnt\u002Fdata\u002Fskills\u002Fpowerpoint-skill\u002Fscripts\u002F`. Code, der allen Text ins größte Shape schreibt oder\n`text_frame.clear()` aufruft bzw. `paragraph.text` setzt, löscht Schriften und Bullets der Vorlage,\nlegt Text über Bilder und lässt den Blindtext in den anderen Feldern stehen.\n\n**Ohne die Skripte** (der Skill wurde als einzelne `SKILL.md` eingefügt): Führe dieselben Schritte\nselbst mit python-pptx aus (zuerst `import pptx`; schlägt das fehl, siehe „Ohne Code-Ausführung“).\n\n- Geh alle Shapes durch, auch Gruppen (`shape.shapes`) und Tabellenzellen.\n- Ersetze Text **pro Absatz**: Schreib den Text in den ersten Run des Absatzes, leere die anderen Runs\n  und entferne oder kopiere ganze Absätze. `shape.text` oder `text_frame.text` zu setzen löscht die\n  Formatierung.\n- Zum Duplizieren einer Folie legst du eine Folie mit demselben Layout an, kopierst die Kinder des\n  `spTree` der Quellfolie und kopierst ihre Beziehungen (Bilder, Diagramme) mit neuen\n  Beziehungs-IDs.\n- Entferne nicht genutzte Folien aus `prs.slides._sldIdLst` und lösche ihre Beziehung.\n- Durchsuche das Ergebnis nach übrig gebliebenem Blindtext, bevor du antwortest.\n\n**Grenzen der Sandbox:**\n\n- Die Sandbox hat kein LibreOffice, also rendert nichts eine Folie zum Anschauen als Bild.\n- Jeder Aufruf endet nach etwa 15 Sekunden. Die Skripte brauchen etwa eine Sekunde, auch bei großen\n  Decks.\n- Eine einzelne Datei darf höchstens etwa 25 MB groß sein.\n\n### Ohne Code-Ausführung\n\nEs gibt keinen Tool-Weg, der diese Textfelder befüllt. Baue **keine** Layout-Folien, die leer\nherauskommen, und wechsle nicht zu `create_powerpoint`, um das Ergebnis dann Vorlage zu nennen. Sag dem\nNutzer klar:\n\n- Die Vorlage hat ihre Inhaltsbereiche als einfache Textfelder auf Musterfolien. companyGPT kann sie nur\n  mit Code-Ausführung befüllen. Der Nutzer kann Code-Ausführung für den Chat oder Agenten einschalten\n  oder einen Admin um die Berechtigung `RUN_CODE` bitten.\n- Alternativ lässt sich der Folienmaster einmal mit echten Platzhaltern in seinen Layouts neu bauen\n  (PowerPoint: Ansicht → Folienmaster → Platzhalter einfügen). Danach funktioniert Weg C ohne Code.\n- Biete an, was jetzt geht: die Folientexte als strukturierte Gliederung zum Einfügen in die Vorlage\n  oder ein Deck im companyFILES-Design (Weg A), klar als **nicht** die Firmenvorlage gekennzeichnet.\n\n---\n\n## 5. Iteratives Bearbeiten beliebiger Foliensätze\n\nAlle drei folgenden Tools adressieren den Foliensatz über `document_id` **oder** `librechat_file_id`\n(ein LibreChat-Anhang, der direkt auf dem gemeinsamen Volume aktualisiert wird, wenn es eingebunden ist).\n\n### `append_slides_to_powerpoint`\n\nZwei sich gegenseitig ausschließende Modi.\n\n**(1) Generieren** – `markdown` oder `slides`, dasselbe Schema wie bei `create_powerpoint`:\n\n```json\n{\n  \"document_id\": \"\u003Cid>\",\n  \"slides\": [\n    { \"type\": \"section\", \"title\": \"Part 2: Deep Dive\" },\n    { \"type\": \"default\", \"title\": \"Technical Details\", \"bullets\": [\"Detail A\", \"Detail B\"] }\n  ]\n}\n```\n\n**(2) Klonen und neu befüllen** – `reference_slide` kopiert eine **bestehende Folie desselben\nFoliensatzes** (Design, Layout, Schriften, Hintergrund) und befüllt ihre `{{placeholders}}` neu. So\nwird ein `{{}}`-Vorlagen-Foliensatz erweitert, damit die neue Folie genau wie die Vorlage aussieht:\n\n```json\n{\n  \"document_id\": \"\u003Cid>\",\n  \"reference_slide\": 4,\n  \"placeholders\": { \"region\": \"APAC\", \"revenue\": \"€0.9M\" },\n  \"notes\": \"APAC is the newest market — numbers are 2 quarters old.\"\n}\n```\n\n`reference_slide` lässt sich nicht mit `markdown`\u002F`slides` kombinieren. Im Klonmodus verwendest du\ndas Top-Level-Feld `notes`, im Generierungsmodus `slides[].notes`.\n\nEinschränkungen des Klonmodus:\n\n- Strukturierte Felder (`bullets`, `code`, `table`) werden **nicht** gerendert – die geklonte Folie\n  hat nur die Formen, die die Vorlage definiert. Inhalte fließen über `{{placeholders}}` ein.\n- Nur `{{text placeholders}}` werden neu befüllt; das Neubefüllen von Bildern (`{%name}`) wird hier\n  nicht unterstützt – dafür nimmst du `create_powerpoint_from_template`.\n\n### `update_powerpoint_slide`\n\nErsetzt eine Folie und behält ihre Position sowie die Gesamtzahl der Folien. Dieselben zwei Modi:\n\n```json\n{\n  \"document_id\": \"\u003Cid>\",\n  \"slide_number\": 3,\n  \"slides\": [{ \"type\": \"section\", \"title\": \"Chapter 2\", \"subtitle\": \"The Deep Dive\" }]\n}\n```\n\n```json\n{ \"document_id\": \"\u003Cid>\", \"slide_number\": 3, \"reference_slide\": 4, \"placeholders\": { \"region\": \"EMEA\" } }\n```\n\nOder schnell nur Text: `{ \"document_id\": \"\u003Cid>\", \"slide_number\": 2, \"markdown\": \"## New Title\\n\\n- Bullet\" }`\n(`##` setzt den Titel, `???` fügt Notizen hinzu).\n\nIst `reference_slide` gleich `slide_number`, wird die Folie direkt neu befüllt – so reparierst du eine\nFolie, die noch rohe `{{placeholders}}` zeigt.\n\n### `read_powerpoint_slides`\n\n```json\n{ \"document_id\": \"\u003Cid>\" }\n```\n\nLiefert `{ slide_count, hasLegacyPlaceholders, layoutsAvailable, slides: [...] }`, jede Folie mit\n`{ slideNumber, title, textLines, layoutId, layoutName, role, slots, emptySlots }`. Verwende es, bevor\ndu einen Foliensatz bearbeitest, den du nicht gerade selbst erstellt hast, und nach mehreren\nAnhängevorgängen, um die Nummerierung zu prüfen.\n\n`slideNumber` ist die Position, **die PowerPoint anzeigt** (Reihenfolge in `sldIdLst`), keine interne\nDateinummer – es ist also die Nummer, die du an `set_powerpoint_slide_fields` \u002F\n`update_powerpoint_slide` übergibst, auch bei einem Foliensatz, dessen Folien umsortiert wurden, bevor\ner bei uns ankam.\n\nDie Layout-Felder machen einen unbekannten Foliensatz bearbeitbar: `layoutId` speist\n`add_slides_from_layouts`, `slots` zeigt, was jede Folie aktuell enthält, und `emptySlots` listet die\nnoch freien Keys. Übergib `include_layouts: false` für ein reines Textlesen eines sehr großen\nFoliensatzes (nur `slideNumber`, `title`, `textLines`).\n\n---\n\n## 6. Diagramme und Bilder in Folien\n\n- **Diagramm als eigene Folie:** `embed_chart_in_document` mit `document_type: \"powerpoint\"` rendert\n  das Diagramm auf eine eigene Folie; ist `title` gesetzt, kommt zuerst eine generierte Titelfolie,\n  sodass der Foliensatz **zwei** Folien hat. Das Ergebnis ist ein Foliensatz – hänge mit\n  `append_slides_to_powerpoint` weiter daran an. Seine `id` ist eine `.pptx`, **kein Bild**: Als\n  `doc:\u003Cid>` oder als Bild-`document_id` übergeben, wird sie als „not an image“ abgelehnt.\n- **Diagramm auf einer Inhaltsfolie:** Nimm das native Diagramm – `slides[].chart` (generierte Decks, §3)\n  oder `charts` je Slot (Corporate-Decks, Weg C). Es bleibt in PowerPoint bearbeitbar. Nur wenn ein Bild\n  gewünscht ist (oder das Deck eine `{{}}`-Vorlage ist, in der `charts` nur Datenreihen umbenennt),\n  referenziere ein gespeichertes Diagrammbild als `![chart](doc:\u003Cid>)` im Markdown, über einen\n  `{%name}`-Bildplatzhalter in einer `{{}}`-Vorlage oder über einen Layout-Bild-Slot (`images`, Weg C).\n- **Bildbibliothek:** Stockfotos, Key Visuals und Icons der Organisation (und eigene des Nutzers).\n  Finde sie mit `list_image_templates` (`search`, `tag`, `orientation`, `aspect_ratio` sortiert nach\n  Nähe, `limit`); jedes Ergebnis hat `ref` (`\"img:\u003Cname>\"`), Beschreibung, Schlagwörter und\n  `aspectRatio`. Übergib das `aspect_ratio` des Zielbereichs (das `aspectRatio` eines Slots aus\n  `describe_pptx_template`, 16:9 = 1.78), damit wenig beschnitten wird; einen Kandidaten siehst du dir\n  mit `view_image { \"image_template\": \"\u003Cname>\" }` an. Ein unbekannter `img:`-Name bricht den Aufruf mit\n  einem Fehler ab, der ihn nennt.\n- **Bildquellen** unterscheiden sich je nach Tool:\n  - Markdown in `create_powerpoint`: `doc:\u003CdocumentId>` (gespeichertes Bild), `lc:\u003Cfile_id>`\n    (LibreChat-Anhang – siehe `list_my_files`), `img:\u003Cname>` (Bildbibliothek), eine base64-Data-URI\n    oder eine öffentliche http(s)-URL.\n  - `image`-Felder in `slides[]` sowie Markdown in `append_slides_to_powerpoint` \u002F\n    `update_powerpoint_slide`: `lc:\u003Cfile_id>`, `doc:\u003Cdocument_id>`, `img:\u003Cname>`, eine\n    base64-Data-URI (`data:image\u002F…`) oder eine öffentliche http(s)-URL. Bevorzuge `lc:`\u002F`doc:`\u002F`img:`\n    statt base64. Eine nicht auflösbare Referenz in `slides[].image` ist ein Fehler, der sie nennt; im\n    Markdown fällt die Folie auf den Alt-Text zurück.\n  - http(s)-Bilder müssen von einem **öffentlich erreichbaren** Host stammen; interne oder private\n    Adressen werden abgelehnt.\n  - `{%name}`-Vorlagenbilder und Layout-Bild-Slots (`images`) nehmen\n    `{ base64 | document_id | librechat_file_id | image_template }`; `images` der Layout-Tools nehmen\n    auch die Strings `lc:…`, `doc:…`, `img:…` oder `data:image\u002F…`.\n- **Bilder werden nie verzerrt**, außer auf Wunsch (`stretch`):\n\n  | Wo                       | Standard                                    | Option                          |\n  | ------------------------ | ------------------------------------------- | ------------------------------- |\n  | `slides[].image`         | `contain`: ganzes Bild, mittig im Bereich   | `imageFit: \"cover\"` beschneidet |\n  | Layout-Bild-Slots        | `cover`: füllt den Slot, mittiger Beschnitt | `{ …, \"fit\": \"contain\" }`       |\n  | `{%name}`-Vorlagenbilder | `cover`; `contain` für Namen mit „logo“     | `fit` je Bild                   |\n\n- Siehe **charts-diagrams-skill** für das Erstellen von Diagrammen, **templates-skill** für\n  `{%image}`-Platzhalter, `charts` (benennt nur Datenreihen um – die Diagrammdaten der Vorlage bleiben)\n  und `repeat`.\n\n---\n\n## 7. Stolperfallen\n\n- **Weiche nie auf Weg A aus, wenn ein Corporate-Master gewünscht war.** Wird ein Layout-Aufruf\n  abgelehnt, korrigiere den Aufruf – wechsle nicht zu `create_powerpoint`. Dessen Ausgabe nutzt das\n  eigene Design, sodass genau das verloren geht, worum gebeten wurde (der Corporate-Master), und ein\n  nach dem Master benannter Foliensatz, der ihn nicht verwendet, wirkt wie ein Erfolg, obwohl er ein\n  Fehlschlag ist. Bekommst du den Aufruf nicht durch, sag das und hör auf; liefere nicht\n  stillschweigend einen Ersatz.\n- **Übergib `slides`, `fields` und `role_map` als echtes JSON, nicht als String.** Ein serialisiertes\n  `\"[{\\\"layout\\\":…}]\"` toleriert der Server, aber nur als Sicherheitsnetz – sende strukturierte\n  Argumente. Eine Schema-Ablehnung bedeutet, dass die _Struktur_ falsch ist: Lies das Beispiel in\n  dieser Datei erneut, statt dieselbe Nutzlast noch einmal zu senden.\n- **`slides` schlägt `markdown`**, wenn beide im selben Aufruf übergeben werden.\n- **`title` bei `create_powerpoint` stellt eine zusätzliche generierte Titelfolie voran** – das\n  verschiebt jede `slide_number`. Lass es weg, um Folie 1 selbst zu gestalten.\n- **`reference_slide` + `markdown`\u002F`slides` ist ein Fehler.** Wähle einen Modus.\n- **`slide_number` beginnt bei 1**; ein Wert außerhalb des Bereichs ist ein Fehler, der die\n  tatsächliche Folienanzahl meldet.\n- **Ein Layout ohne Text-Slots ist keine leere Folie zum Befüllen.** Listet `describe_pptx_template`\n  für die Layouts, die du brauchst, keine `title`\u002F`body`-Slots, bleibt eine Layout-Folie leer: nur\n  Hintergrund, Logo und Fußzeile. Das ist Weg D (§4a), kein Aufruf, den du mit anderen Feldnamen\n  wiederholst.\n- **„Fertig“ heißt: zurückgelesen und frei von Blindtext.** Ein Deck, das noch „Text“, „XXX“ oder\n  „TITEL“ zeigt oder leere Inhaltsfolien hat, darf nicht als fertig gemeldet werden. Es als fertig zu\n  melden und den Nutzer den Blindtext selbst finden zu lassen, ist das schlechteste Ergebnis.\n- **`unknownFields` \u002F `emptySlots`** in einer Layout-Antwort signalisieren, dass ein Slot-Key falsch\n  war – lies `describe_pptx_template` erneut, statt zu raten. Gängige Synonyme werden akzeptiert\n  (`title` für einen `ctrTitle`-Platzhalter, `subtitle` für `subTitle`, `content`\u002F`bullets` für\n  `body`), exakte Slot-Keys sind aber immer am sichersten.\n- **Getippte Listenzeichen verdoppeln sich.** `\"• Punkt\"` oder `\"1. Punkt\"` in einem Layout-Slot\n  erscheint als `• • Punkt` oder `• 1. Punkt`, weil das Listenformat der Vorlage ein eigenes Zeichen\n  setzt. Aufzählungszeichen und Nummern kommen nur aus der Vorlage (siehe „Listen kommen aus der\n  Vorlage“).\n- **Ein Synonym befüllt einen Slot, nicht alle passenden.** Bei einem Layout mit zwei\n  Body-Platzhaltern (`body:12`, `body:13`) befüllt ein einzelnes `bullets` den **ersten freien** und\n  meldet den anderen in `emptySlots` – es wird nicht in beide dupliziert. Um beide Spalten zu befüllen,\n  adressiere sie mit exaktem Key. Exakte Keys gewinnen gegen Synonyme, daher befüllt\n  `{ \"body:13\": \"right\", \"content\": \"left\" }` beide korrekt.\n- **`subtitle` bei einem Master ohne `subTitle`-Platzhalter** (häufig bei Corporate-Mastern: Die\n  Untertitelzeile eines Titellayouts ist ein normaler `body`-Platzhalter) fällt auf den ersten freien\n  `body`-Slot zurück, statt in `unknownFields` zu landen.\n- **`create_powerpoint_from_template` lehnt eine Vorlage ohne `{{}}`-Platzhalter ab** – wenn auch\n  `images`, `charts` und `speaker_notes` fehlen – und nennt in der Fehlermeldung die Layout-Tools. Das\n  ist das Signal für Weg C, keine defekte Vorlage – versuche das Legacy-Tool nicht erneut und füge\n  einem Corporate-Master keine `{{}}`-Marker hinzu.\n- **`pic:*`-Slots erhalten Bilder über `images`, nicht über `fields`.** Ein `pic`-Key in `fields`\n  befüllt nichts – der Slot bleibt leer.\n- **Nur `add_slides_from_layouts` behält die Dokument-id**, wenn du einen Weg-C-Foliensatz\n  erweiterst. `create_powerpoint_from_layouts` mit `drop_template_slides: false` erzeugt ein _neues_\n  Dokument – nützlich, wenn der Nutzer eine Kopie will, falsch, wenn er das Vorhandene erweitern wollte.\n- **`append_slides_to_powerpoint` auf einem Corporate-Foliensatz liefert Folien im\n  companyFILES-Stil.** Die generierten Folien bringen ihr eigenes Design mit und werden auf das erste\n  Layout des Foliensatzes umgemappt, sodass sie auf einem Design-Foliensatz unpassend aussehen. Die\n  Antwort weist in `designNote` darauf hin; verwende `add_slides_from_layouts`.\n- **Layoutnamen sind nicht eindeutig.** Mehrdeutige Namensreferenzen werden zum ersten Treffer\n  aufgelöst und protokollieren eine Warnung; verwende `layoutId`.\n- **`list_templates` enthält den Layout-Katalog nicht.** `describe_pptx_template` schon.\n- **Schreibe in Weg C keine Formatierung.** Farben\u002FSchriften zu übergeben ist weder möglich noch\n  gewollt – der Master bestimmt das Design.\n- **Downloads:** Jeder Erstellungsaufruf sowie jeder Append-\u002FUpdate-\u002FPatch-Aufruf auf einem\n  companyFILES-Dokument liefert `{ id, filename, downloadUrl, markdownLink }` (plus\n  `librechat_file_id`, wenn der Foliensatz auch als Chat-Datei gespeichert ist). Gib in der Antwort\n  immer `markdownLink` aus. Bei einem direkt aktualisierten Chat-Anhang enthält die Antwort\n  `librechat_file_id`, `filename` und `message`, aber **keinen** Download-Link – teile dem Nutzer mit,\n  dass der angehängte Foliensatz aktualisiert wurde. Konnte der Anhang nicht direkt aktualisiert\n  werden, wird ein neues Dokument mit eigener `id` und eigenem `markdownLink` zurückgegeben.\n- **Theming (Weg A):** `create_powerpoint` übernimmt die CI automatisch aus den Einstellungen: Farben,\n  Theme-Schriften, Linkfarbe, Firmenname in den Dateieigenschaften und – auf Inhaltsfolien – Fußzeilentext,\n  Foliennummer und das Logo (wenn „Logo in Dokumenten“ an ist, an der Folienkante der eingestellten\n  Logo-Position; Titel- und Abschnittsfolien bleiben ohne). Theme-Argumente sind nicht nötig.\n- **Weg B (Vorlagen):** Nur `{{company_name}}` wird automatisch befüllt (aus dem Firmennamen in den\n  Einstellungen); ein Logo braucht einen `{%logo}`-Bildplatzhalter und einen expliziten `images`-Eintrag.\n  Weg C schreibt keine Formatierung, die Vorlage bestimmt das Aussehen.\n\n---\n\n## 8. End-to-End-Testlauf\n\nEin einziger Durchlauf, der alle Folienfunktionen abdeckt. Nützlich, um ein Deployment zu überprüfen.\n\n**Weg A – Foliensatz von Grund auf, iterativ erstellt**\n\n1. `create_powerpoint` – ohne `title`-Argument, 3 Folien: `section`, `default` (Aufzählung +\n   `htmlTable` mit farbigen Zellen), `text-image` **ohne** `image` → Skelettkasten erwartet.\n   → 3 Folien, `document_id` notieren. (Einmal **mit** `title` wiederholen, um zu bestätigen, dass die\n   generierte Titelfolie erscheint und die Nummerierung auf 4 verschiebt.)\n2. `append_slides_to_powerpoint` – `slides`: ein `default` mit `code`-Block und `table` sowie ein\n   `text-image` **mit** `image` als base64-Data-URI. → dieselbe `document_id`, 5 Folien.\n3. `append_slides_to_powerpoint` – `markdown` mit zwei `##`-Überschriften und einem `???`-Notizblock.\n   → 7 Folien, Notizen in der Referentenansicht sichtbar.\n4. `update_powerpoint_slide` – `slide_number: 2`, ein `slides`-Array mit einem Element vom Typ\n   `section`. → weiterhin 7 Folien, Folie 2 ist jetzt ein Kapiteltrenner.\n5. `read_powerpoint_slides` → `slide_count: 7`, Titel in der erwarteten Reihenfolge.\n\n**Weg C – Corporate-Master, iterativ erstellt**\n\n6. Master als `potx`-Vorlage hochladen → Logzeile\n   `Auto-extracted N slide layout(s) from PPTX template …`, `placeholders` leer.\n7. `describe_pptx_template` → `hasLegacyPlaceholders: false`, Layouts mit `layoutId`, `name`,\n   `masterId`, `role`, Slot-Keys mit mindestens einem `body:idx`-Paar und einem `pic:*`.\n8. `create_powerpoint_from_layouts` – 5 Folien, gemischt über **Rolle**, **Name** und **layoutId**\n   adressiert; mit mehrstufiger Aufzählung, einem zweispaltigen Layout, das `body:12` + `body:13`\n   befüllt, einem `\\n` innerhalb eines Werts und `notes` auf Folie 1.\n   → in PowerPoint öffnen: Corporate-Schriften\u002F-Farben\u002F-Logos, echte Master-Aufzählungszeichen, und\n   **„Folie zurücksetzen“ ändert nichts**.\n9. `set_powerpoint_slide_fields` – nur den `title` von Folie 2 ändern → dieselbe `document_id`,\n   gleiche Folienanzahl, andere Slots unberührt.\n10. `add_slides_from_layouts` mit dieser `document_id` → **dieselbe** `document_id`, 6 Folien, die neue\n    im selben Corporate Design. Mit `insert_after: 1` wiederholen → die Folie landet an Position 2.\n11. `set_powerpoint_slide_fields` mit `images: { \"pic:14\": { \"librechat_file_id\": \"\u003Cpng>\" } }` auf\n    einer Titel-Bild-Folie → das Bild füllt den Platzhalterrahmen, zugeschnitten statt verzerrt, und\n    `slide.filledImageSlots` in der Antwort listet `pic:14`.\n\n**Ein im Chat angehängter Foliensatz (§2a)**\n\n12. Eine `.pptx` an eine Chat-Nachricht anhängen → `list_my_files` zeigt sie mit einer `file_id`.\n13. `describe_pptx_template { \"librechat_file_id\": \"\u003Cfile_id>\" }` → derselbe Katalog wie in Schritt 7,\n    ohne Vorlagen-Upload.\n14. `read_powerpoint_slides { \"librechat_file_id\": \"\u003Cfile_id>\" }` → Folien in der Reihenfolge, in der\n    PowerPoint sie anzeigt, jeweils mit `layoutId` und `slots`.\n15. `add_slides_from_layouts` gegen diese `file_id` → die `message` in der Antwort sagt, dass der\n    Anhang direkt aktualisiert wurde (gleiche `file_id`, `librechat_file_id` in der Antwort) oder dass\n    die geänderte Kopie als neues Dokument gespeichert wurde (neue `id` und `markdownLink`).\n\n**Weg D – Design-Deck mit Blindtext (Code-Ausführung)**\n\n16. Ein Deck anhängen, dessen Inhaltsfolien einfache Textfelder sind („Text“, „XXX“) →\n    `describe_pptx_template` zeigt Layouts ohne Text-Slots, `read_powerpoint_slides` zeigt den Blindtext.\n17. `pptx_inventory.py` auf `\u002Fmnt\u002Fdata\u002F\u003Cdeck>.pptx` → Zeilen mit `box` und `!DUMMY`.\n18. `pptx_fill.py` mit einem Plan, der eine Musterfolie zweimal nutzt, eine Liste von Bullets, eine\n    Absatz-Map `{\"0\": …, \"2\": …}` und ein `delete` → `saved … N slides`, `CHECK OK`, und das Ergebnis\n    kommt als Chat-Anhang zurück; in PowerPoint sehen die Kopien aus wie die Musterfolie.\n19. Derselbe Plan mit einer weggelassenen Shape-ID → `CHECK FAILED` mit dieser Folie und Shape,\n    Exit-Code 2.\n\n**Fehlerpfade**\n\n20. `\"layout\": \"GibtsNicht\"` → Fehler, der alle Layouts **und** Rollen auflistet.\n21. `fields: { \"untertitel\": \"x\" }` auf einem Layout ohne diesen Slot → `unknownFields: [\"untertitel\"]`.\n22. `slide_number: 99` bei `set_powerpoint_slide_fields` → Fehler mit der tatsächlichen Folienanzahl.\n23. `reference_slide` zusammen mit `slides` → Fehler.\n24. Ein Foliensatz **mit** `{{}}`-Markup durch `describe_pptx_template` →\n    `hasLegacyPlaceholders: true` → zu `create_powerpoint_from_template` wechseln.\n25. `add_slides_from_layouts` auf einem mit `create_powerpoint` erstellten Foliensatz → Fehler, der\n    `append_slides_to_powerpoint` nennt, und die Folienanzahl des Foliensatzes bleibt unverändert.\n26. `add_slides_from_layouts` mit `insert_after` jenseits der Folienanzahl → Fehler mit der\n    tatsächlichen Anzahl.\n27. `pptx_inventory.py \u003CFirmen-Master> --lists` → eine Zeile pro Text-Slot mit `at x%,y%` und\n    `L0`…`L4`; ein Slot, dessen Master-Ebene 0 Aufzählungszeichen hat, zeigt `L0=bullet`. Befülle ihn\n    mit `[\"Punkt A\", \"Punkt B\"]` (ohne getipptes `•`) → PowerPoint zeigt genau einen Punkt pro Zeile.\n\n`MANUAL_TESTS.md` §4.6 (Corporate-Master) und §4.9 (im Chat angehängter Foliensatz) enthalten diese\nSzenarien als direkt ausführbare cURL-Befehle.\n","# PowerPoint Skill\n\nAlles, was du brauchst, um `.pptx`-Foliensätze zu erstellen, zu erweitern und zu reparieren.\n\n## Tool-Übersicht\n\n| Tool                              | Zweck                                                                                |\n| --------------------------------- | ------------------------------------------------------------------------------------ |\n| `create_powerpoint`               | Neuer Foliensatz aus Markdown oder einem typisierten `slides`-Array (eigenes Design) |\n| `create_powerpoint_from_template` | Neuer Foliensatz aus einer POTX\u002FPPTX-Vorlage mit `{{placeholders}}`                  |\n| `describe_pptx_template`          | Liest die **nativen Folienlayouts** eines Foliensatzes – kein `{{}}` nötig           |\n| `create_powerpoint_from_layouts`  | Neuer Foliensatz durch Instanziieren dieser nativen Layouts (Corporate Design)       |\n| `add_slides_from_layouts`         | Hängt layout-native Folien an einen bestehenden Foliensatz an, **direkt in der Datei** |\n| `set_powerpoint_slide_fields`     | Ändert die nativen Platzhalter einer Folie (Text + Bilder) direkt in der Datei       |\n| `append_slides_to_powerpoint`     | Hängt Folien an einen bestehenden Foliensatz an, direkt in der Datei                 |\n| `update_powerpoint_slide`         | Ersetzt eine Folie eines bestehenden Foliensatzes, direkt in der Datei               |\n| `read_powerpoint_slides`          | Liest Foliennummern, Titel, Text **sowie Layout\u002FSlots jeder Folie**                  |\n| `list_my_files`                   | Findet einen Foliensatz, den der Nutzer im Chat angehängt hat (`file_id`)            |\n| `list_templates`                  | Findet verfügbare Vorlagen (`type: \"potx\"`) vor dem Erstellen                        |\n| `list_image_templates`            | Findet Bilder in der Bildbibliothek (`img:\u003Cname>`)                                   |\n| `embed_chart_in_document`         | Chart.js-Diagramm als neuer Foliensatz; `title` fügt eine Titelfolie hinzu           |\n\n---\n\n## 1. Iterativ arbeiten – keinen Foliensatz in einem Rutsch erzeugen\n\n**Ein Foliensatz mit mehr als ~6 Folien muss in mehreren Tool-Aufrufen entstehen.** Ein einziger\nriesiger `create_powerpoint`-Aufruf ist der häufigste Fehler: Die Argumente werden abgeschnitten,\nLayout-Entscheidungen lassen sich nicht korrigieren, und eine einzige fehlerhafte Folie bedeutet,\ndass alles neu generiert werden muss.\n\nDer Ablauf:\n\n```\nPLAN   → zuerst die Gliederung in deiner Antwort schreiben (Foliennummer, Rolle\u002FLayout, Überschrift, Inhaltsskizze)\nPROBE  → describe_pptx_template \u002F list_templates \u002F read_powerpoint_slides – herausfinden, was vorhanden ist\nSEED   → create_powerpoint* nur mit den ERSTEN 3–5 Folien → die zurückgegebene id (document_id) merken\nEXTEND → append_slides_to_powerpoint (Weg A\u002FB) oder add_slides_from_layouts (Weg C)\n         in Paketen von 3–5 Folien, wiederholt\nREFINE → set_powerpoint_slide_fields oder update_powerpoint_slide für einzelne Korrekturen\nVERIFY → read_powerpoint_slides, um Folienanzahl, Reihenfolge, Titel und übrig gebliebenen Blindtext zu prüfen\n```\n\n**Melde einen Foliensatz nie als fertig, bevor du ihn zurückgelesen hast.** Folien, die noch den\nBlindtext der Vorlage zeigen („Text“, „XXX“, „TITEL“, „Lorem ipsum“) oder leer herauskommen, sind ein\nFehler, kein Ergebnis. Korrigiere sie oder sag dem Nutzer genau, welche Folien nicht befüllt sind und\nwarum.\n\n### PLAN vor dem ersten Tool-Aufruf\n\nZeige dem Nutzer bei allem, was über ein paar Folien hinausgeht, einen Plan und lass ihn reagieren.\nDas kostet eine Nachricht und erspart den Neuaufbau eines 20-Folien-Foliensatzes.\n\n```\nPlan — \"Digitalstrategie 2027\" (12 Folien, Corporate-Master `folienmaster`)\n\n #  Layout \u002F Rolle     Überschrift                   Inhalt\n 1  title              Digitalisierungsstrategie 2027 Autor + Datum\n 2  section            1. Ausgangslage\n 3  content            Kernbefunde                   3 Aufzählungspunkte, 1 eingerückt\n 4  two-content        Handlungsoptionen             Option A | Option B\n 5  section            2. Zielbild\n …\n12  closing            —                             Kontaktblock\n\nIch erstelle zuerst 1–5 und hänge dann 6–12 in zwei Paketen an. Sag Bescheid, wenn sich die Struktur ändern soll.\n```\n\n### Faustregeln\n\n- **Paketgröße 3–5 Folien** pro Aufruf. Bei langen Aufzählungstexten oder `htmlTable`-Inhalten → 2–3.\n- **Behalte die `document_id`.** Der erste Erstellungsaufruf gibt die `id` des Foliensatzes zurück;\n  jeder Append-\u002FUpdate-\u002FPatch-Aufruf auf diesen Foliensatz behält _dieselbe_ id. Verwende sie weiter;\n  erstelle nie einen zweiten Foliensatz, um den ersten zu reparieren.\n- **Eine fehlerhafte Folie → nur diese Folie ändern.** `set_powerpoint_slide_fields` (layout-nativ)\n  oder `update_powerpoint_slide` (eigenes Design \u002F Klonmodus). Beide erhalten Folienanzahl und Position.\n- **`read_powerpoint_slides` zwischen den Paketen**, wenn du mehrfach angehängt hast, um sicherzugehen,\n  dass du die Folien von der richtigen Basis aus nummerierst.\n- **Melde den Fortschritt**, z. B. „Folien 1–5 fertig, als Nächstes hänge ich 6–9 an“, und gib den\n  zurückgegebenen `markdownLink` aus, damit der Nutzer den Zwischenstand öffnen kann.\n- **Nie neu erstellen, um anzuhängen.** `add_slides_from_layouts` \u002F `append_slides_to_powerpoint`\n  gibt es genau dafür, dass ein Foliensatz über mehrere Runden wachsen kann.\n\nJede Folie in einem **typisierten** `slides`-Array (`create_powerpoint`, `append_slides_to_powerpoint`,\n`update_powerpoint_slide`) **benötigt einen `title`** (Pflichtfeld, auch bei `section`-Folien) – eine\nFolie ohne `title` scheitert an der Validierung. Die `slides` der Layout-Tools haben eine andere\nStruktur – `layout`, `fields`, `images`, `notes` – und kein `title`-Feld; ein Titel gehört in\n`fields.title`.\n\n---\n\n## 2. Den Erstellungsweg wählen\n\nEntscheide einmal, ganz am Anfang. Werden Wege in einem Foliensatz gemischt, entsteht ein\nuneinheitliches Design.\n\n| Situation                                                     | Weg                                     |\n| ------------------------------------------------------------- | --------------------------------------- |\n| Keine Vorlage erwähnt, companyFILES-Design passt              | **A** `create_powerpoint`               |\n| Eine Vorlage existiert **und** enthält `{{key}}`-Markup       | **B** `create_powerpoint_from_template` |\n| Ein Corporate-Master \u002F Folienmaster **ohne** `{{}}`-Markup    | **C** `create_powerpoint_from_layouts`  |\n| Ein Design-Deck, dessen **Musterfolien** das Design als einfache Textfelder mit Blindtext tragen und dessen Layouts (fast) keine Text-Slots haben | **D** Musterfolien klonen und befüllen (Code-Ausführung, §4a) |\n\n**So unterscheidest du B, C und D:** Führe `describe_pptx_template` auf der Vorlage aus und lies\n`hasLegacyPlaceholders`.\n\n- `true` → der Foliensatz verwendet `{{}}` → Weg **B** (siehe auch **templates-skill**)\n- `false` → sieh dir die `slots` der Layouts an:\n  - die Layouts, die du brauchst, haben Text-Slots (`title`, `body:*`, …) → Weg **C**\n  - die Layouts haben **keine oder fast keine Text-Slots**, aber `read_powerpoint_slides` (mit\n    `include_layouts: false`) zeigt Text auf den eigenen Folien des Decks („Text“, „XXX“, „TITEL“,\n    „UNTERTITEL“, „Text 1 … Text 4“, eine Agenda mit „01 XXX“) → Weg **D**. Das Design steckt in den\n    Musterfolien, nicht in den Layouts. Eine Layout-Folie aus so einem Master kommt **leer** heraus\n    (nur Hintergrund, Logo und Fußzeile), und `set_powerpoint_slide_fields` meldet jeden Key als\n    `unknownFields`.\n- Gemischte Decks sind häufig: ein Titellayout mit echten Slots, aber Inhaltsfolien als Musterfolien.\n  Entscheide pro Folientyp; im Zweifel nimm Weg D für das ganze Deck, damit alle Folien aus derselben\n  Quelle stammen.\n\n`list_templates` (`type: \"potx\"`) listet Kandidaten auf und liefert für `{{}}`-Foliensätze eine\nAufschlüsselung der Platzhalter pro Folie. Den Layout-Katalog liefert es **nicht** – dafür nimmst du\n`describe_pptx_template`.\n\nEin Foliensatz, den der Nutzer im Chat angehängt hat, muss für Weg C nicht als Vorlage hochgeladen\nwerden – siehe nächster Abschnitt. Weg B ist die Ausnahme: `create_powerpoint_from_template` nimmt\nnur einen `template_name` entgegen.\n\n---\n\n## 2a. Der Nutzer hat eine `.pptx` im Chat angehängt\n\nDas ist der Normalfall: Jemand legt seinen Folienmaster oder einen bestehenden Foliensatz in die\nUnterhaltung und bittet um eine Präsentation „in diesem Design“ oder darum, den gerade geschickten\nFoliensatz zu erweitern. Bei einem Corporate-Master (ohne `{{}}`) **bitte den Nutzer nicht, ihn als\nVorlage hochzuladen** – die Layout-Tools, `read_powerpoint_slides`, `append_slides_to_powerpoint` und\n`update_powerpoint_slide` nehmen den Anhang direkt entgegen. `create_powerpoint_from_template` nicht:\nEs hat nur `template_name`, kein `document_id` \u002F `librechat_file_id`.\n\n```\nFIND    file_id aus dem Block \"Attached files in this message:\"\n        (kein Block: list_my_files → die .pptx anhand des Dateinamens wählen; list_documents \u002F\n        search_documents funktionieren auch – die id des Eintrags übergeben)\nPROBE   describe_pptx_template { \"librechat_file_id\": \"\u003Cfile_id>\" }\n        → hasLegacyPlaceholders entscheidet den Weg (B oder C)\n        read_powerpoint_slides { \"librechat_file_id\": \"\u003Cfile_id>\" }, wenn der Foliensatz Inhalte hat,\n        die du sehen oder erweitern musst – es meldet Layout und Slot-Keys jeder Folie\n        → Layouts ohne Text-Slots + Blindtext auf den Folien = Weg D (§4a)\nBUILD   (Weg C)\n        neuer Foliensatz → create_powerpoint_from_layouts { \"librechat_file_id\": ..., \"slides\": [...] }\n        erweitern        → add_slides_from_layouts     { \"librechat_file_id\": ..., \"slides\": [...] }\n        eine korrigieren → set_powerpoint_slide_fields { \"librechat_file_id\": ..., \"slide_number\": n, ... }\n```\n\n**Ein angehängter `{{}}`-Foliensatz (Weg B)** hat zwei Wege:\n\n- Um ihn mit `create_powerpoint_from_template` zu befüllen (Bilder, Diagramme, `repeat`), muss er\n  zuerst als Vorlage hochgeladen werden (Web-UI, `open_companyfiles_ui page=\"upload\"`); danach rufst du\n  das Tool mit diesem `template_name` auf.\n- Oder du bearbeitest den Anhang selbst im Klonmodus (§5): `update_powerpoint_slide` mit\n  `reference_slide` gleich `slide_number` plus `placeholders` befüllt eine Folie direkt in der Datei;\n  `append_slides_to_powerpoint` mit `reference_slide` plus `placeholders` fügt eine befüllte Kopie hinzu.\n\n**`librechat_file_id` und `document_id` sind austauschbare Eingaben.** Der Server löst beide auf,\nzuerst über das PVC. Übergib die id, die dir die Auflistung geliefert hat.\n\n**Neuer Foliensatz oder bearbeiteter Foliensatz?** Zwei verschiedene Absichten, zwei verschiedene Tools:\n\n| Der Nutzer möchte                                         | Tool                             | Ergebnis                                                 |\n| --------------------------------------------------------- | -------------------------------- | -------------------------------------------------------- |\n| Eine Präsentation **im Design** dieses Foliensatzes       | `create_powerpoint_from_layouts` | Ein **neues** Dokument; der Anhang bleibt unverändert    |\n| Weitere Folien **in** diesem Foliensatz                   | `add_slides_from_layouts`        | **Derselbe** Foliensatz, direkt in der Datei erweitert   |\n| Eine Folie dieses Foliensatzes geändert                   | `set_powerpoint_slide_fields`    | **Derselbe** Foliensatz, eine Folie geändert             |\n\nBei einem Anhang bedeutet „direkt in der Datei“: Die Datei wird auf dem gemeinsamen LibreChat-Volume\nüberschrieben, wenn dieses Volume eingebunden ist (gleiche `file_id`); andernfalls wird die geänderte\nKopie als neues companyFILES-Dokument gespeichert. Die `message` in der Antwort sagt, was passiert\nist – gib das weiter, statt dem Nutzer zu versprechen, dass seine Originaldatei geändert wurde.\n\n**Ein aus Markdown erstellter Foliensatz hat keine befüllbaren Layouts.** `add_slides_from_layouts`\nlehnt ihn ab und nennt stattdessen `append_slides_to_powerpoint`; diese Ablehnung ist korrekt, umgehe\nsie nicht.\n\n---\n\n## 3. Weg A – von Grund auf (`create_powerpoint`)\n\n### Markdown-Modus (schnell, textlastige Foliensätze)\n\n`#` oder `##` beginnt eine neue Folie. Alle Folien erhalten das Layout `default`. Eine Zeile, die\ngenau `???` enthält, beginnt Sprechernotizen, die bis zur nächsten `#`\u002F`##`-Überschrift reichen.\n\n> **`title` fügt eine Folie hinzu.** Das Top-Level-Argument `title` von `create_powerpoint` stellt\n> eine generierte dunkle Titelfolie (Titel, Autor, heutiges Datum) voran. `n` Inhaltsfolien plus\n> `title` ergeben also `n + 1` Folien, und jede spätere `slide_number` verschiebt sich um eins. Lass\n> `title` weg, wenn du die Eröffnungsfolie selbst gestalten willst. `append_slides_to_powerpoint`\n> fügt nie eine hinzu.\n\n```json\n{\n  \"markdown\": \"# Quarterly Results\\n\\n- Revenue: €1.2M\\n- Growth: 15%\\n\\n???\\nOpen with the revenue number.\\n\\n## Key Highlights\\n\\n- Launched new product\\n- Expanded to 3 markets\",\n  \"filename\": \"q4_results\",\n  \"title\": \"Q4 2025 Results\",\n  \"author\": \"Strategy Team\"\n}\n```\n\nInline-Bilder im Markdown von `create_powerpoint` verwenden `doc:\u003CdocumentId>`, `lc:\u003Cfile_id>` oder\n`img:\u003Cname>` (Bildbibliothek, siehe §6):\n\n```markdown\n![Chart](doc:abc12345-...)\n![Attachment](lc:xyz-librechat-file-id)\n![Team](img:office-team)\n```\n\n### Modus mit typisierten Folien (Layout-Kontrolle)\n\nÜbergib `slides` statt `markdown`. Sind beide angegeben, gewinnt `slides`.\n\n| `type`         | Darstellung                                                  | Felder                                                               |\n| -------------- | ------------------------------------------------------------ | -------------------------------------------------------------------- |\n| `\"default\"`    | Akzentbalken + Titel + gestapelter Inhalt                    | `title`, `content`, `bullets`, `code`, `table`, `htmlTable`, `image` |\n| `\"section\"`    | Dunkler Hintergrund, großer zentrierter Titel – Kapiteltrenner | `title`, `subtitle`                                                |\n| `\"text-image\"` | Titel oben, Text\u002FAufzählung links, Bild rechts               | `title`, `content`, `bullets`, `htmlTable`, `image`, `imageAlt`      |\n\nJeder Typ akzeptiert zusätzlich `notes` (Sprechernotizen). Unbekannte `type`-Werte fallen auf\n`\"default\"` zurück. Fehlt `image` auf einer `text-image`-Folie, wird ein Skelett-Platzhalterkasten\ngezeichnet – nützlich für Entwürfe.\n\n**Titel bleiben einzeilig** (Inhalts-, Titel- und Abschnittsfolien): Ein langer Titel wird kleiner gesetzt (bis\n16 pt), einer mit mehr als etwa 60 Zeichen mit „…“ gekürzt. Halte Folientitel kurz und stell Details in den Inhalt.\n\n```json\n{\n  \"slides\": [\n    { \"type\": \"section\", \"title\": \"Q4 2025 Results\", \"subtitle\": \"Strategy Team\" },\n    {\n      \"type\": \"default\",\n      \"title\": \"Key Metrics\",\n      \"bullets\": [\"Revenue: €1.2M\", \"Growth: 15%\", \"NPS: 72\"],\n      \"notes\": \"Lead with revenue; growth is YoY, not QoQ — expect that question.\"\n    },\n    {\n      \"type\": \"text-image\",\n      \"title\": \"System Architecture\",\n      \"bullets\": [\"Microservices\", \"Auto-scaling\", \"99.9% uptime\"],\n      \"image\": \"https:\u002F\u002Fwww.example.com\u002Farchitecture.png\",\n      \"imageAlt\": \"Architecture diagram\"\n    }\n  ],\n  \"title\": \"Q4 2025 Results\",\n  \"filename\": \"q4_results\"\n}\n```\n\n`bullets` ist hier ein flaches `string[]` – für eingerückte Aufzählungen nutzt du Weg C (`level`)\noder eine Vorlage. Das Feld `image` nimmt `lc:\u003Cfile_id>` (Chat-Anhang oder erzeugtes Bild, siehe\n`list_my_files`), `doc:\u003Cdocument_id>`, `img:\u003Cname>` (Bildbibliothek), eine base64-Data-URI oder eine\nöffentliche http(s)-URL (siehe §6). `imageFit` legt fest, wie es seinen Bereich füllt: `\"contain\"`\n(Standard, ganzes Bild, mittig), `\"cover\"` (füllt den Bereich, beschneidet) oder `\"stretch\"` (verzerrt –\nnur auf Wunsch). Dasselbe gilt in `append_slides_to_powerpoint` und `update_powerpoint_slide`.\n\n**Natives Diagramm auf einer Folie:** Ergänze `chart` auf einer `default`-Folie (unter dem Text) oder einer\n`text-image`-Folie (ersetzt das Bild – nimm `image` **oder** `chart`, nicht beides). Es ist ein echtes,\nbearbeitbares PowerPoint-Diagramm („Daten bearbeiten“ öffnet die Zahlen in Excel) in den Farben und der\nSchrift der Corporate Identity. `section`-Folien zeigen keines. Die Daten haben dieselbe Form wie bei\n`show_interactive_chart`:\n\n```json\n{\n  \"type\": \"default\",\n  \"title\": \"Umsatz je Quartal\",\n  \"bullets\": [\"Q3 ist das stärkste Quartal\"],\n  \"chart\": {\n    \"type\": \"bar\",\n    \"labels\": [\"Q1\", \"Q2\", \"Q3\"],\n    \"datasets\": [{ \"label\": \"2026\", \"data\": [12, 15, 19] }],\n    \"showValues\": true\n  }\n}\n```\n\n`chart.type`: `bar`, `horizontalBar`, `stackedBar`, `line`, `area`, `pie`, `doughnut`, `scatter`, `radar`\n(`pie`\u002F`doughnut` zeigen nur die erste Datenreihe). Optional: `title`, `showLegend`, `showValues`,\n`numberFormat` (Excel-Format, z. B. `\"#,##0\"`), `xAxisTitle`, `yAxisTitle`. Grenzen: höchstens 20 Datenreihen\nmit je 1000 Punkten; jede Datenreihe braucht genau eine Zahl je Label, sonst bricht das Tool ab und nennt die\nDatenreihe. Funktioniert auch in `append_slides_to_powerpoint` und `update_powerpoint_slide`.\n\n### Formatierte Tabellen – `htmlTable`\n\nVerwende `htmlTable` statt `table`, wenn Zellen Farbe, Fettdruck oder Ausrichtung brauchen.\nUnterstützt auf `default` und `text-image`; hat Vorrang vor `table`.\n\n| Inline-CSS                        | Wirkung       |\n| --------------------------------- | ------------- |\n| `background-color: #hex`          | Zellfüllung   |\n| `color: #hex`                     | Textfarbe     |\n| `font-weight: bold`               | Fett          |\n| `font-style: italic`              | Kursiv        |\n| `text-align: left\\|center\\|right` | Ausrichtung   |\n\n`\u003Cth>`-Zellen erhalten automatisch Kopfzeilenfüllung\u002F-text des Themes, sofern nicht überschrieben.\n\n```json\n{\n  \"type\": \"default\",\n  \"title\": \"Revenue by Region\",\n  \"htmlTable\": \"\u003Ctable>\u003Ctr>\u003Cth>Region\u003C\u002Fth>\u003Cth>Q1\u003C\u002Fth>\u003Cth>vs PY\u003C\u002Fth>\u003C\u002Ftr>\u003Ctr>\u003Ctd style=\\\"font-weight:bold\\\">DACH\u003C\u002Ftd>\u003Ctd>€1.2M\u003C\u002Ftd>\u003Ctd style=\\\"color:#16A34A\\\">+18%\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd style=\\\"font-weight:bold\\\">US\u003C\u002Ftd>\u003Ctd>€0.8M\u003C\u002Ftd>\u003Ctd style=\\\"color:#DC2626\\\">-3%\u003C\u002Ftd>\u003C\u002Ftr>\u003C\u002Ftable>\"\n}\n```\n\nFür ein einfaches Raster reicht `table: string[][]` (erste Zeile = Kopfzeile).\n\n---\n\n## 4. Weg C – Corporate-Master ohne `{{}}` (layout-nativ)\n\nDas ist der Weg für einen Foliensatz, den das Design-Team geliefert hat, z. B. eine\n`Corporate-Master.pptx`. Solche Foliensätze enthalten **kein `{{}}`-Markup**, sondern nur benannte\nFolienlayouts mit den eigenen Platzhaltern von OOXML. Inhalte werden an diese Platzhalter gebunden\nund es wird **keine Formatierung geschrieben**, sodass Schriften, Farben, Logos und Geometrie aus dem\nMaster stammen. („Folie zurücksetzen“ in PowerPoint ändert nichts – das ist der Beweis.)\n\nLade einen solchen Master als Vorlage hoch (eine `.pptx` wird als Typ `potx` gespeichert) – oder,\nwenn der Nutzer ihn im Chat angehängt hat, verwende direkt seine `librechat_file_id` (Abschnitt 2a).\n\n### Schritt 1 – `describe_pptx_template`\n\n```json\n{ \"template_name\": \"folienmaster\" }\n```\n\nLiefert:\n\n```json\n{\n  \"hasLegacyPlaceholders\": false,\n  \"slideSize\": { \"widthEmu\": 12192000, \"heightEmu\": 6858000 },\n  \"roleMap\": { \"title\": \"slideLayout5.xml\", \"section\": \"slideLayout8.xml\", \"content\": \"slideLayout9.xml\" },\n  \"layouts\": [\n    {\n      \"layoutId\": \"slideLayout11.xml\",\n      \"name\": \"Titel_mit_Inhalt\",\n      \"masterId\": \"slideMaster3.xml\",\n      \"role\": \"content\",\n      \"exampleSlides\": [4],\n      \"slots\": [\n        { \"key\": \"title\", \"type\": \"title\" },\n        { \"key\": \"body:10\", \"type\": \"body\", \"hint\": \"Mastertextformat bearbeiten\" },\n        { \"key\": \"pic:14\", \"type\": \"pic\", \"isImage\": true, \"aspectRatio\": 1.78 }\n      ]\n    },\n    {\n      \"layoutId\": \"slideLayout9.xml\",\n      \"name\": \"Inhalt\",\n      \"role\": \"content\",\n      \"exampleSlides\": [],\n      \"slots\": [{ \"key\": \"title\" }, { \"key\": \"body:12\" }, { \"key\": \"body:13\" }]\n    }\n  ]\n}\n```\n\nSo liest du das:\n\n- **`layoutId` ist der stabile Bezeichner.** Layout-**Namen wiederholen sich** über Folienmaster\n  hinweg (ein echter Foliensatz hatte `Präsentationstitel` 3× verteilt auf 5 Master). Bevorzuge `layoutId`.\n- **Slot-Keys lauten `type` oder `type:idx`.** Der `idx` zählt: `body:12` + `body:13` im selben\n  Layout bedeutet ein zweispaltiges Layout – befülle beide, um beide Spalten zu nutzen. Die Nummer\n  sagt **nicht**, welcher Kasten links oder oben steht: `body:13` kann die rechte Spalte sein. Prüfe\n  die Position (der `at`-Wert von `--lists`, siehe „Listen kommen aus der Vorlage“ unten) oder\n  befülle die Spalten mit Texten, deren Reihenfolge egal ist.\n- **`role`** wird aus dem Layoutnamen (deutsche + englische Schlüsselwörter) und der Zusammensetzung\n  seiner Slots abgeleitet. Rollen: `title`, `title-image`, `section`, `content`, `two-content`,\n  `title-only`, `closing`, `reference`. `roleMap` wählt pro Rolle ein Layout.\n- **`hint`** ist der eigene Aufforderungstext des Layouts und nur ein Hinweis – echte Master sagen oft\n  „Mastertextformat bearbeiten“ oder Lorem ipsum. Urteile nach Name + Slot-Struktur, nicht nach dem Hinweis.\n- **`isImage`-Slots (`pic:*`) erhalten ein Bild über das separate Argument `images`**, nicht über\n  `fields`. `aspectRatio` (Breite ÷ Höhe des Slot-Rahmens) zeigt dir, was sich gut zuschneiden lässt –\n  das Bild wird mittig auf dieses Verhältnis zugeschnitten, nie verzerrt. Aus der Bildbibliothek wählst\n  du ein Bild mit ähnlichem `aspectRatio` (`list_image_templates` mit `aspect_ratio`). Ein Slot, für den du kein\n  Bild übergibst, bleibt leer und erscheint in `imageSlotsNotFilled`; versprich dem Nutzer dann kein Bild.\n- **`acceptsChart`-Slots** (Platzhaltertypen `chart`, `obj`, `body`) erhalten ein natives Diagramm über das\n  separate Argument `charts` (siehe „Diagramme“ unten). `read_powerpoint_slides` meldet `acceptsChart` ebenfalls.\n\n### Schritt 2 – `create_powerpoint_from_layouts`\n\nJede Folie wählt ihr Layout über `layoutId`, Layoutnamen oder Rolle – frei kombinierbar.\n\n```json\n{\n  \"template_name\": \"folienmaster\",\n  \"filename\": \"strategie-2027\",\n  \"slides\": [\n    {\n      \"layout\": \"title\",\n      \"fields\": { \"title\": \"Digitalisierungsstrategie 2027\", \"body:11\": \"Dr. Max Mustermann\\n27.07.2026\" },\n      \"notes\": \"Begrüßung, 2 Minuten.\"\n    },\n    { \"layout\": \"Kapiteltrenner\", \"fields\": { \"title\": \"1. Ausgangslage\" } },\n    {\n      \"layout\": \"slideLayout11.xml\",\n      \"fields\": {\n        \"title\": \"Kernbefunde\",\n        \"body:10\": [\n          \"Drei Systeme decken 80 % ab\",\n          { \"text\": \"Redundante Datenhaltung\", \"level\": 1 },\n          \"Betriebskosten +9 % p. a.\"\n        ]\n      }\n    },\n    {\n      \"layout\": \"Inhalt\",\n      \"fields\": {\n        \"title\": \"Handlungsoptionen\",\n        \"body:12\": [\"Option A: Konsolidierung\", \"Aufwand: hoch\"],\n        \"body:13\": [\"Option B: Schnittstellen\", \"Aufwand: mittel\"]\n      }\n    },\n    { \"layout\": \"closing\", \"fields\": { \"body:11\": \"Muster GmbH\\n12345 Musterstadt\" } }\n  ]\n}\n```\n\n**Bilder** gehören in ein `images`-Objekt pro Folie, mit Keys wie bei `fields` (exakter Slot-Key, der\nbloße Typ `pic` oder die Synonyme `image`\u002F`picture`\u002F`photo`). Als Quellen dienen die üblichen drei:\n\n```json\n{\n  \"layout\": \"title-image\",\n  \"fields\": { \"title\": \"Standort München\" },\n  \"images\": { \"pic:14\": { \"librechat_file_id\": \"abc-attachment-id\" } }\n}\n```\n\n`{ \"document_id\": \"...\" }` (ein PVC-Upload), `{ \"image_template\": \"...\" }` (Bildbibliothek) und\n`{ \"base64\": \"...\" }` funktionieren genauso. Das Bild übernimmt Position und Größe aus dem Layout und wird\nauf das Seitenverhältnis des Slots zugeschnitten (`cover`). Soll das ganze Bild zu sehen sein, nutze die\nObjektform mit `\"fit\": \"contain\"` (ein Rahmen im Seitenverhältnis des Bildes, mittig im Slot); `\"stretch\"`\nnur auf Wunsch. Auch einfache Strings gehen: `\"images\": { \"pic:14\": \"lc:abc-attachment-id\" }` (ebenso\n`doc:\u003Cdocument_id>`, `img:\u003Cname>` oder eine `data:image\u002F…`-URI). Eine nicht auflösbare\n`lc:`\u002F`doc:`\u002F`img:`-Referenz bricht den Aufruf ab, der Fehler nennt sie.\n\n**Diagramme** gehören in ein `charts`-Objekt pro Folie, mit Keys wie bei `fields` (exakter Slot-Key wie\n`chart:15` oder der bloße Typ; `content`\u002F`chart` nehmen den ersten freien Chart-, Obj- oder Body-Slot).\nDas Diagramm füllt den Rahmen des Slots (aus dem Layout, sonst aus dem Folienmaster; ohne Rahmen ein Fehler\nmit dem Slot-Namen) in den Theme-Farben (Design → Farben) und der Theme-Schrift des Decks. Ein Slot nimmt ein\nFeld **oder** ein Diagramm, nicht beides. Dasselbe Diagrammobjekt wie bei `slides[].chart` oben:\n\n```json\n{\n  \"layout\": \"Diagramm\",\n  \"fields\": { \"title\": \"Umsatz je Quartal\" },\n  \"charts\": {\n    \"chart:15\": {\n      \"type\": \"bar\",\n      \"labels\": [\"Q1\", \"Q2\", \"Q3\"],\n      \"datasets\": [{ \"label\": \"2026\", \"data\": [12, 15, 19] }]\n    }\n  }\n}\n```\n\n`charts` funktioniert genauso in `add_slides_from_layouts` und `set_powerpoint_slide_fields`.\n\n**Slot-Werte** akzeptieren drei Formen:\n\n| Wert                              | Ergebnis                                                   |\n| --------------------------------- | ---------------------------------------------------------- |\n| `\"one line\"`                      | Ein Absatz auf Ebene 0; `\\n` teilt in mehrere Absätze      |\n| `[\"a\", \"b\"]`                      | Ein Absatz pro Element, alle auf Ebene 0                   |\n| `[{ \"text\": \"sub\", \"level\": 1 }]` | Ein Absatz auf Ebene `level` 0–8                           |\n\nIm Text werden `**fett**`, `*kursiv*` und `~~durchgestrichen~~` formatiert; Schrift, Größe und Farbe bleiben die des\nLayouts. Links erscheinen als „Text (URL)“, nicht klickbar.\n\nWeggelassene Slots bleiben leer und zeigen in PowerPoint den Aufforderungstext des Layouts.\n\n**Listen kommen aus der Vorlage, nicht von dir.** Das Tool schreibt keine eigenen Aufzählungs- oder\nNummerierungseinstellungen. Jeder Absatz übernimmt das Zeichen seiner Ebene aus dem Listenformat des\nPlatzhalters im Master: einen Aufzählungspunkt, eine Nummer oder nichts. Ein String und ein Array\nsehen **gleich** aus. Das Array teilt den Text nur in Absätze; es schaltet keine Aufzählung ein oder\naus. Das heißt:\n\n- **Tippe nie selbst Listenzeichen.** Kein `•`, `-`, `–`, `*`, `1.`, `a)` oder `→` am Zeilenanfang.\n  Auf einer Ebene mit Aufzählungszeichen entsteht sonst `• • Text` oder `• 1. Text`. Schreib den\n  reinen Text, die Vorlage setzt das Zeichen.\n- **Ein Absatz kann sein Aufzählungszeichen nicht abschalten.** In einem Platzhalter, dessen Ebene 0\n  Aufzählungszeichen hat, bekommt jede Zeile auf Ebene 0 einen Punkt, auch eine Überschrift oder ein\n  Einleitungssatz. Überschriften gehören in den `title`-\u002F`ctrTitle`-Slot des Layouts oder in ein\n  Layout mit eigenem Überschrift-Slot oder einer Ebene ohne Zeichen. Schreib „OPTION A“ nicht als\n  ersten Punkt einer Spalte.\n- **Nummerierte oder schlichte Zeilen brauchen eine Ebene oder einen Slot, der so formatiert ist.**\n  Nummeriert die Vorlage eine Ebene, nutze sie; sonst ist die Liste eine Aufzählung, also setz keine\n  eigenen Nummern dazu. Agendapunkte, Schritte und Kapitelnummern gehören in Slots ohne\n  Aufzählungszeichen. Passt keiner, schreib die Punkte ohne Nummern.\n- **Viele Firmen-Master nutzen Ebene 0 für Fließtext und Ebene 1 für Aufzählungen** (Beispieltext\n  „Mastertextformat bearbeiten \u002F Zweite Ebene …“). Bei so einem Master schreibst du Einleitungstext\n  auf Ebene 0 und die Listenpunkte mit `\"level\": 1`.\n\nWelche Ebene Aufzählungszeichen hat, zeigt `describe_pptx_template` nicht. Mit Code-Ausführung liest\ndu es aus der Vorlage (siehe unten), ohne Code hältst du dich an die Regeln oben. Lies das Deck nach\ndem Erstellen mit `read_powerpoint_slides` zurück: Zeilen, die mit einem selbst getippten `•`, `-`\noder einer Nummer beginnen, sind ein Fehler. Sag dem Nutzer, dass die Aufzählungszeichen aus der\nVorlage kommen, und bitte ihn, eine Inhaltsfolie zu prüfen.\n\n**Wenn Code-Ausführung verfügbar ist**, lies Listenformat und Position jedes Slots aus, bevor du\nplanst. Hänge die Vorlage an (`attach_template_to_chat`, siehe **templates-skill**) und führe das\nmitgelieferte Skript aus. Es ist nur da, wenn der Skill als Paket installiert wurde (Zip \u002F Sync):\n\n```bash\npython3 \u002Fmnt\u002Fdata\u002Fskills\u002Fpowerpoint-skill\u002Fscripts\u002Fpptx_inventory.py \"\u002Fmnt\u002Fdata\u002F\u003Cvorlage>.pptx\" --lists\n```\n\n```text\n== slideLayout9.xml \"Text_Box_OB\"\n  body:13      at 52%,30%  L0=bullet '•'  L1=bullet '–'  L2=none …\n  body:14      at  5%,30%  L0=bullet '•'  L1=bullet '–'  L2=none …\n```\n\n`L0=bullet` = Zeilen auf Ebene 0 bekommen einen Aufzählungspunkt, `L0=number arabicPeriod` =\nnummeriert, `L0=none` = schlichter Text. Ein Zeichen wie `'§'` oder `'n'` stammt aus einer\nSymbolschrift (Quadrat, Strich, …) und ist trotzdem ein Aufzählungszeichen. `at x%,y%` ist die linke\nobere Ecke des Slots: Hier ist `body:14` die **linke** Spalte, obwohl die Nummer höher ist. Fehlt das\nSkript, gelten die Regeln oben ohne es.\n\n**Optionen für den Basis-Foliensatz:**\n\n- `drop_template_slides` (Standard `true`) entfernt die eigenen Folien des Quell-Foliensatzes.\n  Folienmaster, Layouts, Themes und Medien bleiben **immer** erhalten.\n- `drop_template_slides: false` behält sie und hängt danach an – das Ergebnis wird jedoch als **neues**\n  Dokument gespeichert. Um einen Foliensatz direkt in der Datei wachsen zu lassen, verwende\n  `add_slides_from_layouts` (Schritt 3).\n- Statt `template_name` kannst du `document_id` (eine gespeicherte `.pptx`) oder `librechat_file_id`\n  (einen Anhang) übergeben, um diesen Foliensatz als Basis zu verwenden. Da die Layouts erhalten\n  bleiben, lässt sich ein so erstellter Foliensatz später erweitern – das ist der iterative Weg für Weg C.\n- `role_map` überschreibt die Ableitung: `{ \"content\": \"slideLayout4.xml\" }`.\n\nDie **Antwort** meldet pro Folie: `layoutId`, `layoutName`, `filledSlots`, `filledImageSlots`,\n`unknownFields`, `emptySlots`. Prüfe immer `unknownFields` – ein vertippter Slot-Key wird gemeldet,\nnicht stillschweigend verworfen. Bild-Slots, die kein Bild erhalten haben, stehen in\n`imageSlotsNotFilled` (mit einer `note`).\n\n### Schritt 3 – `add_slides_from_layouts` (Foliensatz direkt in der Datei erweitern)\n\nDas In-place-Gegenstück zu Schritt 2: dasselbe `slides`-Array, aber es zielt über `document_id` \u002F\n`librechat_file_id` auf einen bestehenden Foliensatz und **behält dasselbe Dokument**. So wächst ein\nWeg-C-Foliensatz über mehrere Runden – erstelle den Foliensatz nie neu, um Folien hinzuzufügen.\n\n```json\n{\n  \"document_id\": \"\u003Cid>\",\n  \"slides\": [\n    { \"layout\": \"Kapiteltrenner\", \"fields\": { \"title\": \"2. Zielbild\" } },\n    { \"layout\": \"slideLayout11.xml\", \"fields\": { \"title\": \"Roadmap\", \"body:10\": [\"Q1\", \"Q2\"] } }\n  ]\n}\n```\n\n- `insert_after: n` setzt die neuen Folien hinter Folie `n` (`0` = vor Folie 1). Weglassen, um anzuhängen.\n- Liefert `slides_before` \u002F `slides_after` \u002F `slides_added` plus denselben Bericht pro Folie.\n- Lehnt einen Foliensatz ab, dessen Layouts keine nativen Platzhalter haben (einen aus Markdown\n  erstellten Foliensatz), und nennt stattdessen `append_slides_to_powerpoint` – in diesem Fall wird\n  nichts geschrieben. Ebenfalls ohne zu schreiben lehnt es ab, wenn überhaupt kein Slot befüllt wird\n  (typischerweise: keiner der übergebenen Keys passt zu einem Slot).\n\n### Schritt 4 – `set_powerpoint_slide_fields` (eine Folie ändern)\n\nÄndert **eine** Folie direkt in der Datei. Nur die übergebenen Slots ändern sich; alle anderen Slots,\nFormen, Bilder und die Position der Folie bleiben unberührt. Slots, die das Layout anbietet, die Folie\naber noch nicht enthält, werden hinzugefügt – auch Bild-Slots.\n\n```json\n{\n  \"document_id\": \"\u003Cid>\",\n  \"slide_number\": 3,\n  \"fields\": { \"title\": \"Kernbefunde (überarbeitet)\", \"body:10\": [\"Neuer Punkt 1\", \"Neuer Punkt 2\"] },\n  \"images\": { \"pic:14\": { \"librechat_file_id\": \"abc-attachment-id\" } }\n}\n```\n\n`fields` oder `images` allein genügt – übergib beides nur, wenn du beides ändern willst. Das ist das\nTool, das du über mehrere Runden immer wieder aufrufst, während der Nutzer den Foliensatz prüft.\nAkzeptiert auch `librechat_file_id` (der Anhang wird auf dem gemeinsamen Volume aktualisiert, sofern\nverfügbar).\n\n### Wie eine `layout`-Referenz aufgelöst wird\n\nDas `layout` einer Folie wird in dieser Reihenfolge abgeglichen: eine `layoutId` → eine Rolle (ein\nexpliziter `role_map`-Eintrag überschreibt die abgeleitete `roleMap`) → ein Layoutname.\n`{{slide_type:x}}`-Marker spielen hier keine Rolle; sie steuern nur `repeat`-Datensätze in\n`create_powerpoint_from_template` (siehe **templates-skill**). **Bitte den Nutzer nie, `{{}}`-Marker\nin einen Corporate-Master einzutippen** – genau das macht Weg C überflüssig.\n\n---\n\n## 4a. Weg D – Design-Deck mit Blindtext auf den Musterfolien\n\nViele Firmenvorlagen sind nicht so gebaut, wie PowerPoint es vorsieht. Die Designer haben die\nInhaltsbereiche als **einfache Textfelder auf Musterfolien** angelegt (Titelfolie, Agenda,\nKapiteltrenner, Inhaltsfolie, Abschlussfolie) und mit Blindtext gefüllt: „Text“, „XXX“, „TITEL“,\n„UNTERTITEL“, „Text 1 … Text 4“, „01 XXX“. Die Layouts hinter diesen Folien tragen nur Hintergrund,\nLogo, Fußzeile und Foliennummer. Deshalb finden die Layout-Tools aus Weg C nichts zum Befüllen.\n\nSo ein Deck nutzt du so, wie es ein Mensch tun würde: **die passende Musterfolie duplizieren, ihre\nTextfelder überschreiben, die nicht genutzten Musterfolien löschen.** companyFILES hat kein Tool, das\neinfache Textfelder bearbeitet, deshalb braucht dieser Weg Code-Ausführung.\n\n**Erst planen, wie in §1:** Nenne für jede Folie des neuen Decks die Musterfolie, die sie kopiert\n(„Folie 5 = Inhaltsfolie mit drei Bullets“), und den Text für jedes ihrer Textfelder. Eine Musterfolie\nkannst du beliebig oft verwenden; nicht benötigte Musterfolien fallen weg. Halte die Texte ungefähr so\nlang wie den Blindtext. Die Felder haben eine feste Größe, und niemand sieht die Folie, bevor der\nNutzer sie öffnet.\n\n### Wenn Code-Ausführung verfügbar ist\n\nDas angehängte Deck liegt in der Sandbox unter `\u002Fmnt\u002Fdata\u002F\u003Cdateiname>.pptx` (eine companyFILES-Vorlage:\nerst `attach_template_to_chat`, siehe **templates-skill**). Dieser Skill bringt zwei Skripte mit, unter\n`\u002Fmnt\u002Fdata\u002Fskills\u002Fpowerpoint-skill\u002Fscripts\u002F`, wenn er als Paket installiert wurde:\n\n1. **Inventur**: listet jedes Shape mit ID und Absätzen auf:\n\n   ```bash\n   python3 \u002Fmnt\u002Fdata\u002Fskills\u002Fpowerpoint-skill\u002Fscripts\u002Fpptx_inventory.py \"\u002Fmnt\u002Fdata\u002F\u003Cdeck>.pptx\"\n   ```\n\n   Jede Zeile lautet `id=\u003Cshape id> \u003Cart> \"\u003Cname>\"  [0] 'Absatz 0'  [1] 'Absatz 1' …`.\n   `box` = einfaches Textfeld (Inhalt für Weg D), `ph:*` = echter Platzhalter, `tbl` = Tabelle\n   (Zellen als `r\u003Czeile>c\u003Cspalte>`), `in=\u003Cid>` = in einer Gruppe. `!DUMMY` markiert Blindtext. Große\n   Decks: `--slides 1-10` anhängen (die Ausgabe eines Aufrufs ist auf etwa 64 KB begrenzt).\n   - `fit≈22ch×3 lines` = ungefähr so viel Text fasst das Feld laut Design. Die farbige Kachel oder\n     der abgerundete Kasten hinter einem Textfeld ist für seinen Blindtext bemessen. Plane deine\n     Texte innerhalb dieser Grenze: Eine Überschrift mit 6 Zeichen braucht einen kurzen Ersatz, keinen\n     Satz.\n   - `\u003Cr>` in einem Absatz markiert einen Formatwechsel, z. B. `'01 \u003Cr>TITEL'` = fette Nummer + normaler\n     Titel. Behalte das `\u003Cr>` in deinem Text (`\"02 \u003Cr>PORTFOLIO\"`), dann bleiben beide Formate.\n\n2. **Befüllen**: Plan schreiben und das Deck in einem Aufruf bauen:\n\n   ```bash\n   cat > \u002Ftmp\u002Fplan.json \u003C\u003C'EOF'\n   {\"slides\": [\n     {\"from\": 1, \"texts\": {\"8\": \"Jahresbericht 2026\", \"18\": \"Berlin, 28.10.2026\"}, \"notes\": \"Begrüßung\"},\n     {\"from\": 2, \"texts\": {\"3\": [\"Markt\", \"Produkte\", \"Team\", \"Ausblick\"]}},\n     {\"from\": 5, \"texts\": {\"4\": [\"Stärke eins\", \"Stärke zwei\", \"Stärke drei\"], \"6\": \"01 UNTERNEHMEN\"}},\n     {\"from\": 5, \"texts\": {\"4\": [\"Zweite Folie\", \"im selben Design\"], \"6\": \"02 PRODUKTE\"}},\n     {\"from\": 8, \"replace\": {\"Musterfirma\": \"Acme GmbH\"}}\n   ]}\n   EOF\n   python3 \u002Fmnt\u002Fdata\u002Fskills\u002Fpowerpoint-skill\u002Fscripts\u002Fpptx_fill.py \"\u002Fmnt\u002Fdata\u002F\u003Cdeck>.pptx\" \u002Ftmp\u002Fplan.json \"\u002Fmnt\u002Fdata\u002F\u003Cergebnis>.pptx\"\n   ```\n\n   - `from` = Nummer der Musterfolie, `texts` = Shape-ID → neuer Text. Die Shape-IDs bleiben auf\n     jeder Kopie einer Musterfolie gleich.\n   - Ein Text ist ein String (`\\n` = neuer Absatz, `\u003Cbr>` = Zeilenumbruch), eine Liste von Absätzen\n     (einer pro Bullet; `null` behält einen Absatz) oder `{\"\u003Cabsatz-index>\": \"text\"}`, um einzelne\n     Zeilen eines Felds zu ändern (ein Feld mit `'XXX'  ''  'XXX'` = Überschrift, Leerzeile,\n     Beschreibung).\n   - Außerdem: `tables` (Shape-ID → Zeilen × Zellen), `images` (Shape-ID → `\u002Fmnt\u002Fdata\u002F\u003Cbild>`, tauscht\n     ein Bild und behält seinen Rahmen), `delete` (Shape-IDs, z. B. ein „ABBILDUNG“-Feld, für das du kein\n     Bild hast), `replace` (Teilstring auf der ganzen Folie), `notes`.\n   - Schreib den Plan im **selben** Aufruf nach `\u002Ftmp`. Dateien in `\u002Fmnt\u002Fdata` werden zu Chat-Anhängen,\n     und `\u002Ftmp` wird nach jedem Aufruf geleert.\n   - Das Skript behält die Formatierung jedes Absatzes (Schrift, Größe, Farbe, Bullet), kopiert Diagramme\n     und Bilder mit der Folie und überschreibt die Quelle nie.\n\n3. **Prüfen**: Das Befüll-Skript endet mit einer Prüfung und beendet sich mit Code 2, wenn Blindtext\n   übrig ist (`CHECK FAILED` mit Folie, Shape-ID und Text). Korrigiere den Plan und führe ihn erneut aus.\n   Eine `FIT WARNING` heißt: Ein Text ist zu lang für sein Feld oder die Form dahinter und läuft über das\n   Design hinaus. Kürze genau diese Texte und führe den Plan erneut aus, bis keine Warnung mehr kommt.\n   Einzeln prüfen geht auch: `pptx_inventory.py \"\u002Fmnt\u002Fdata\u002F\u003Cergebnis>.pptx\" --check`. Lass die Inventur\n   noch einmal über das Ergebnis laufen und vergleiche sie mit deinem Plan, bevor du antwortest.\n\n4. **Antworten**: Das Ergebnis kommt als Chat-Anhang zurück. Sag, aus welcher Musterfolie jede Folie\n   stammt und dass du nur den Text prüfen konntest, nicht das Aussehen. Bitte den Nutzer, auf Text zu\n   achten, der zu lang für sein Feld ist.\n\n**Schreib keinen eigenen Befüll-Code, wenn die Skripte da sind.** Prüfe zuerst:\n`ls \u002Fmnt\u002Fdata\u002Fskills\u002Fpowerpoint-skill\u002Fscripts\u002F`. Code, der allen Text ins größte Shape schreibt oder\n`text_frame.clear()` aufruft bzw. `paragraph.text` setzt, löscht Schriften und Bullets der Vorlage,\nlegt Text über Bilder und lässt den Blindtext in den anderen Feldern stehen.\n\n**Ohne die Skripte** (der Skill wurde als einzelne `SKILL.md` eingefügt): Führe dieselben Schritte\nselbst mit python-pptx aus (zuerst `import pptx`; schlägt das fehl, siehe „Ohne Code-Ausführung“).\n\n- Geh alle Shapes durch, auch Gruppen (`shape.shapes`) und Tabellenzellen.\n- Ersetze Text **pro Absatz**: Schreib den Text in den ersten Run des Absatzes, leere die anderen Runs\n  und entferne oder kopiere ganze Absätze. `shape.text` oder `text_frame.text` zu setzen löscht die\n  Formatierung.\n- Zum Duplizieren einer Folie legst du eine Folie mit demselben Layout an, kopierst die Kinder des\n  `spTree` der Quellfolie und kopierst ihre Beziehungen (Bilder, Diagramme) mit neuen\n  Beziehungs-IDs.\n- Entferne nicht genutzte Folien aus `prs.slides._sldIdLst` und lösche ihre Beziehung.\n- Durchsuche das Ergebnis nach übrig gebliebenem Blindtext, bevor du antwortest.\n\n**Grenzen der Sandbox:**\n\n- Die Sandbox hat kein LibreOffice, also rendert nichts eine Folie zum Anschauen als Bild.\n- Jeder Aufruf endet nach etwa 15 Sekunden. Die Skripte brauchen etwa eine Sekunde, auch bei großen\n  Decks.\n- Eine einzelne Datei darf höchstens etwa 25 MB groß sein.\n\n### Ohne Code-Ausführung\n\nEs gibt keinen Tool-Weg, der diese Textfelder befüllt. Baue **keine** Layout-Folien, die leer\nherauskommen, und wechsle nicht zu `create_powerpoint`, um das Ergebnis dann Vorlage zu nennen. Sag dem\nNutzer klar:\n\n- Die Vorlage hat ihre Inhaltsbereiche als einfache Textfelder auf Musterfolien. companyGPT kann sie nur\n  mit Code-Ausführung befüllen. Der Nutzer kann Code-Ausführung für den Chat oder Agenten einschalten\n  oder einen Admin um die Berechtigung `RUN_CODE` bitten.\n- Alternativ lässt sich der Folienmaster einmal mit echten Platzhaltern in seinen Layouts neu bauen\n  (PowerPoint: Ansicht → Folienmaster → Platzhalter einfügen). Danach funktioniert Weg C ohne Code.\n- Biete an, was jetzt geht: die Folientexte als strukturierte Gliederung zum Einfügen in die Vorlage\n  oder ein Deck im companyFILES-Design (Weg A), klar als **nicht** die Firmenvorlage gekennzeichnet.\n\n---\n\n## 5. Iteratives Bearbeiten beliebiger Foliensätze\n\nAlle drei folgenden Tools adressieren den Foliensatz über `document_id` **oder** `librechat_file_id`\n(ein LibreChat-Anhang, der direkt auf dem gemeinsamen Volume aktualisiert wird, wenn es eingebunden ist).\n\n### `append_slides_to_powerpoint`\n\nZwei sich gegenseitig ausschließende Modi.\n\n**(1) Generieren** – `markdown` oder `slides`, dasselbe Schema wie bei `create_powerpoint`:\n\n```json\n{\n  \"document_id\": \"\u003Cid>\",\n  \"slides\": [\n    { \"type\": \"section\", \"title\": \"Part 2: Deep Dive\" },\n    { \"type\": \"default\", \"title\": \"Technical Details\", \"bullets\": [\"Detail A\", \"Detail B\"] }\n  ]\n}\n```\n\n**(2) Klonen und neu befüllen** – `reference_slide` kopiert eine **bestehende Folie desselben\nFoliensatzes** (Design, Layout, Schriften, Hintergrund) und befüllt ihre `{{placeholders}}` neu. So\nwird ein `{{}}`-Vorlagen-Foliensatz erweitert, damit die neue Folie genau wie die Vorlage aussieht:\n\n```json\n{\n  \"document_id\": \"\u003Cid>\",\n  \"reference_slide\": 4,\n  \"placeholders\": { \"region\": \"APAC\", \"revenue\": \"€0.9M\" },\n  \"notes\": \"APAC is the newest market — numbers are 2 quarters old.\"\n}\n```\n\n`reference_slide` lässt sich nicht mit `markdown`\u002F`slides` kombinieren. Im Klonmodus verwendest du\ndas Top-Level-Feld `notes`, im Generierungsmodus `slides[].notes`.\n\nEinschränkungen des Klonmodus:\n\n- Strukturierte Felder (`bullets`, `code`, `table`) werden **nicht** gerendert – die geklonte Folie\n  hat nur die Formen, die die Vorlage definiert. Inhalte fließen über `{{placeholders}}` ein.\n- Nur `{{text placeholders}}` werden neu befüllt; das Neubefüllen von Bildern (`{%name}`) wird hier\n  nicht unterstützt – dafür nimmst du `create_powerpoint_from_template`.\n\n### `update_powerpoint_slide`\n\nErsetzt eine Folie und behält ihre Position sowie die Gesamtzahl der Folien. Dieselben zwei Modi:\n\n```json\n{\n  \"document_id\": \"\u003Cid>\",\n  \"slide_number\": 3,\n  \"slides\": [{ \"type\": \"section\", \"title\": \"Chapter 2\", \"subtitle\": \"The Deep Dive\" }]\n}\n```\n\n```json\n{ \"document_id\": \"\u003Cid>\", \"slide_number\": 3, \"reference_slide\": 4, \"placeholders\": { \"region\": \"EMEA\" } }\n```\n\nOder schnell nur Text: `{ \"document_id\": \"\u003Cid>\", \"slide_number\": 2, \"markdown\": \"## New Title\\n\\n- Bullet\" }`\n(`##` setzt den Titel, `???` fügt Notizen hinzu).\n\nIst `reference_slide` gleich `slide_number`, wird die Folie direkt neu befüllt – so reparierst du eine\nFolie, die noch rohe `{{placeholders}}` zeigt.\n\n### `read_powerpoint_slides`\n\n```json\n{ \"document_id\": \"\u003Cid>\" }\n```\n\nLiefert `{ slide_count, hasLegacyPlaceholders, layoutsAvailable, slides: [...] }`, jede Folie mit\n`{ slideNumber, title, textLines, layoutId, layoutName, role, slots, emptySlots }`. Verwende es, bevor\ndu einen Foliensatz bearbeitest, den du nicht gerade selbst erstellt hast, und nach mehreren\nAnhängevorgängen, um die Nummerierung zu prüfen.\n\n`slideNumber` ist die Position, **die PowerPoint anzeigt** (Reihenfolge in `sldIdLst`), keine interne\nDateinummer – es ist also die Nummer, die du an `set_powerpoint_slide_fields` \u002F\n`update_powerpoint_slide` übergibst, auch bei einem Foliensatz, dessen Folien umsortiert wurden, bevor\ner bei uns ankam.\n\nDie Layout-Felder machen einen unbekannten Foliensatz bearbeitbar: `layoutId` speist\n`add_slides_from_layouts`, `slots` zeigt, was jede Folie aktuell enthält, und `emptySlots` listet die\nnoch freien Keys. Übergib `include_layouts: false` für ein reines Textlesen eines sehr großen\nFoliensatzes (nur `slideNumber`, `title`, `textLines`).\n\n---\n\n## 6. Diagramme und Bilder in Folien\n\n- **Diagramm als eigene Folie:** `embed_chart_in_document` mit `document_type: \"powerpoint\"` rendert\n  das Diagramm auf eine eigene Folie; ist `title` gesetzt, kommt zuerst eine generierte Titelfolie,\n  sodass der Foliensatz **zwei** Folien hat. Das Ergebnis ist ein Foliensatz – hänge mit\n  `append_slides_to_powerpoint` weiter daran an. Seine `id` ist eine `.pptx`, **kein Bild**: Als\n  `doc:\u003Cid>` oder als Bild-`document_id` übergeben, wird sie als „not an image“ abgelehnt.\n- **Diagramm auf einer Inhaltsfolie:** Nimm das native Diagramm – `slides[].chart` (generierte Decks, §3)\n  oder `charts` je Slot (Corporate-Decks, Weg C). Es bleibt in PowerPoint bearbeitbar. Nur wenn ein Bild\n  gewünscht ist (oder das Deck eine `{{}}`-Vorlage ist, in der `charts` nur Datenreihen umbenennt),\n  referenziere ein gespeichertes Diagrammbild als `![chart](doc:\u003Cid>)` im Markdown, über einen\n  `{%name}`-Bildplatzhalter in einer `{{}}`-Vorlage oder über einen Layout-Bild-Slot (`images`, Weg C).\n- **Bildbibliothek:** Stockfotos, Key Visuals und Icons der Organisation (und eigene des Nutzers).\n  Finde sie mit `list_image_templates` (`search`, `tag`, `orientation`, `aspect_ratio` sortiert nach\n  Nähe, `limit`); jedes Ergebnis hat `ref` (`\"img:\u003Cname>\"`), Beschreibung, Schlagwörter und\n  `aspectRatio`. Übergib das `aspect_ratio` des Zielbereichs (das `aspectRatio` eines Slots aus\n  `describe_pptx_template`, 16:9 = 1.78), damit wenig beschnitten wird; einen Kandidaten siehst du dir\n  mit `view_image { \"image_template\": \"\u003Cname>\" }` an. Ein unbekannter `img:`-Name bricht den Aufruf mit\n  einem Fehler ab, der ihn nennt.\n- **Bildquellen** unterscheiden sich je nach Tool:\n  - Markdown in `create_powerpoint`: `doc:\u003CdocumentId>` (gespeichertes Bild), `lc:\u003Cfile_id>`\n    (LibreChat-Anhang – siehe `list_my_files`), `img:\u003Cname>` (Bildbibliothek), eine base64-Data-URI\n    oder eine öffentliche http(s)-URL.\n  - `image`-Felder in `slides[]` sowie Markdown in `append_slides_to_powerpoint` \u002F\n    `update_powerpoint_slide`: `lc:\u003Cfile_id>`, `doc:\u003Cdocument_id>`, `img:\u003Cname>`, eine\n    base64-Data-URI (`data:image\u002F…`) oder eine öffentliche http(s)-URL. Bevorzuge `lc:`\u002F`doc:`\u002F`img:`\n    statt base64. Eine nicht auflösbare Referenz in `slides[].image` ist ein Fehler, der sie nennt; im\n    Markdown fällt die Folie auf den Alt-Text zurück.\n  - http(s)-Bilder müssen von einem **öffentlich erreichbaren** Host stammen; interne oder private\n    Adressen werden abgelehnt.\n  - `{%name}`-Vorlagenbilder und Layout-Bild-Slots (`images`) nehmen\n    `{ base64 | document_id | librechat_file_id | image_template }`; `images` der Layout-Tools nehmen\n    auch die Strings `lc:…`, `doc:…`, `img:…` oder `data:image\u002F…`.\n- **Bilder werden nie verzerrt**, außer auf Wunsch (`stretch`):\n\n  | Wo                       | Standard                                    | Option                          |\n  | ------------------------ | ------------------------------------------- | ------------------------------- |\n  | `slides[].image`         | `contain`: ganzes Bild, mittig im Bereich   | `imageFit: \"cover\"` beschneidet |\n  | Layout-Bild-Slots        | `cover`: füllt den Slot, mittiger Beschnitt | `{ …, \"fit\": \"contain\" }`       |\n  | `{%name}`-Vorlagenbilder | `cover`; `contain` für Namen mit „logo“     | `fit` je Bild                   |\n\n- Siehe **charts-diagrams-skill** für das Erstellen von Diagrammen, **templates-skill** für\n  `{%image}`-Platzhalter, `charts` (benennt nur Datenreihen um – die Diagrammdaten der Vorlage bleiben)\n  und `repeat`.\n\n---\n\n## 7. Stolperfallen\n\n- **Weiche nie auf Weg A aus, wenn ein Corporate-Master gewünscht war.** Wird ein Layout-Aufruf\n  abgelehnt, korrigiere den Aufruf – wechsle nicht zu `create_powerpoint`. Dessen Ausgabe nutzt das\n  eigene Design, sodass genau das verloren geht, worum gebeten wurde (der Corporate-Master), und ein\n  nach dem Master benannter Foliensatz, der ihn nicht verwendet, wirkt wie ein Erfolg, obwohl er ein\n  Fehlschlag ist. Bekommst du den Aufruf nicht durch, sag das und hör auf; liefere nicht\n  stillschweigend einen Ersatz.\n- **Übergib `slides`, `fields` und `role_map` als echtes JSON, nicht als String.** Ein serialisiertes\n  `\"[{\\\"layout\\\":…}]\"` toleriert der Server, aber nur als Sicherheitsnetz – sende strukturierte\n  Argumente. Eine Schema-Ablehnung bedeutet, dass die _Struktur_ falsch ist: Lies das Beispiel in\n  dieser Datei erneut, statt dieselbe Nutzlast noch einmal zu senden.\n- **`slides` schlägt `markdown`**, wenn beide im selben Aufruf übergeben werden.\n- **`title` bei `create_powerpoint` stellt eine zusätzliche generierte Titelfolie voran** – das\n  verschiebt jede `slide_number`. Lass es weg, um Folie 1 selbst zu gestalten.\n- **`reference_slide` + `markdown`\u002F`slides` ist ein Fehler.** Wähle einen Modus.\n- **`slide_number` beginnt bei 1**; ein Wert außerhalb des Bereichs ist ein Fehler, der die\n  tatsächliche Folienanzahl meldet.\n- **Ein Layout ohne Text-Slots ist keine leere Folie zum Befüllen.** Listet `describe_pptx_template`\n  für die Layouts, die du brauchst, keine `title`\u002F`body`-Slots, bleibt eine Layout-Folie leer: nur\n  Hintergrund, Logo und Fußzeile. Das ist Weg D (§4a), kein Aufruf, den du mit anderen Feldnamen\n  wiederholst.\n- **„Fertig“ heißt: zurückgelesen und frei von Blindtext.** Ein Deck, das noch „Text“, „XXX“ oder\n  „TITEL“ zeigt oder leere Inhaltsfolien hat, darf nicht als fertig gemeldet werden. Es als fertig zu\n  melden und den Nutzer den Blindtext selbst finden zu lassen, ist das schlechteste Ergebnis.\n- **`unknownFields` \u002F `emptySlots`** in einer Layout-Antwort signalisieren, dass ein Slot-Key falsch\n  war – lies `describe_pptx_template` erneut, statt zu raten. Gängige Synonyme werden akzeptiert\n  (`title` für einen `ctrTitle`-Platzhalter, `subtitle` für `subTitle`, `content`\u002F`bullets` für\n  `body`), exakte Slot-Keys sind aber immer am sichersten.\n- **Getippte Listenzeichen verdoppeln sich.** `\"• Punkt\"` oder `\"1. Punkt\"` in einem Layout-Slot\n  erscheint als `• • Punkt` oder `• 1. Punkt`, weil das Listenformat der Vorlage ein eigenes Zeichen\n  setzt. Aufzählungszeichen und Nummern kommen nur aus der Vorlage (siehe „Listen kommen aus der\n  Vorlage“).\n- **Ein Synonym befüllt einen Slot, nicht alle passenden.** Bei einem Layout mit zwei\n  Body-Platzhaltern (`body:12`, `body:13`) befüllt ein einzelnes `bullets` den **ersten freien** und\n  meldet den anderen in `emptySlots` – es wird nicht in beide dupliziert. Um beide Spalten zu befüllen,\n  adressiere sie mit exaktem Key. Exakte Keys gewinnen gegen Synonyme, daher befüllt\n  `{ \"body:13\": \"right\", \"content\": \"left\" }` beide korrekt.\n- **`subtitle` bei einem Master ohne `subTitle`-Platzhalter** (häufig bei Corporate-Mastern: Die\n  Untertitelzeile eines Titellayouts ist ein normaler `body`-Platzhalter) fällt auf den ersten freien\n  `body`-Slot zurück, statt in `unknownFields` zu landen.\n- **`create_powerpoint_from_template` lehnt eine Vorlage ohne `{{}}`-Platzhalter ab** – wenn auch\n  `images`, `charts` und `speaker_notes` fehlen – und nennt in der Fehlermeldung die Layout-Tools. Das\n  ist das Signal für Weg C, keine defekte Vorlage – versuche das Legacy-Tool nicht erneut und füge\n  einem Corporate-Master keine `{{}}`-Marker hinzu.\n- **`pic:*`-Slots erhalten Bilder über `images`, nicht über `fields`.** Ein `pic`-Key in `fields`\n  befüllt nichts – der Slot bleibt leer.\n- **Nur `add_slides_from_layouts` behält die Dokument-id**, wenn du einen Weg-C-Foliensatz\n  erweiterst. `create_powerpoint_from_layouts` mit `drop_template_slides: false` erzeugt ein _neues_\n  Dokument – nützlich, wenn der Nutzer eine Kopie will, falsch, wenn er das Vorhandene erweitern wollte.\n- **`append_slides_to_powerpoint` auf einem Corporate-Foliensatz liefert Folien im\n  companyFILES-Stil.** Die generierten Folien bringen ihr eigenes Design mit und werden auf das erste\n  Layout des Foliensatzes umgemappt, sodass sie auf einem Design-Foliensatz unpassend aussehen. Die\n  Antwort weist in `designNote` darauf hin; verwende `add_slides_from_layouts`.\n- **Layoutnamen sind nicht eindeutig.** Mehrdeutige Namensreferenzen werden zum ersten Treffer\n  aufgelöst und protokollieren eine Warnung; verwende `layoutId`.\n- **`list_templates` enthält den Layout-Katalog nicht.** `describe_pptx_template` schon.\n- **Schreibe in Weg C keine Formatierung.** Farben\u002FSchriften zu übergeben ist weder möglich noch\n  gewollt – der Master bestimmt das Design.\n- **Downloads:** Jeder Erstellungsaufruf sowie jeder Append-\u002FUpdate-\u002FPatch-Aufruf auf einem\n  companyFILES-Dokument liefert `{ id, filename, downloadUrl, markdownLink }` (plus\n  `librechat_file_id`, wenn der Foliensatz auch als Chat-Datei gespeichert ist). Gib in der Antwort\n  immer `markdownLink` aus. Bei einem direkt aktualisierten Chat-Anhang enthält die Antwort\n  `librechat_file_id`, `filename` und `message`, aber **keinen** Download-Link – teile dem Nutzer mit,\n  dass der angehängte Foliensatz aktualisiert wurde. Konnte der Anhang nicht direkt aktualisiert\n  werden, wird ein neues Dokument mit eigener `id` und eigenem `markdownLink` zurückgegeben.\n- **Theming (Weg A):** `create_powerpoint` übernimmt die CI automatisch aus den Einstellungen: Farben,\n  Theme-Schriften, Linkfarbe, Firmenname in den Dateieigenschaften und – auf Inhaltsfolien – Fußzeilentext,\n  Foliennummer und das Logo (wenn „Logo in Dokumenten“ an ist, an der Folienkante der eingestellten\n  Logo-Position; Titel- und Abschnittsfolien bleiben ohne). Theme-Argumente sind nicht nötig.\n- **Weg B (Vorlagen):** Nur `{{company_name}}` wird automatisch befüllt (aus dem Firmennamen in den\n  Einstellungen); ein Logo braucht einen `{%logo}`-Bildplatzhalter und einen expliziten `images`-Eintrag.\n  Weg C schreibt keine Formatierung, die Vorlage bestimmt das Aussehen.\n\n---\n\n## 8. End-to-End-Testlauf\n\nEin einziger Durchlauf, der alle Folienfunktionen abdeckt. Nützlich, um ein Deployment zu überprüfen.\n\n**Weg A – Foliensatz von Grund auf, iterativ erstellt**\n\n1. `create_powerpoint` – ohne `title`-Argument, 3 Folien: `section`, `default` (Aufzählung +\n   `htmlTable` mit farbigen Zellen), `text-image` **ohne** `image` → Skelettkasten erwartet.\n   → 3 Folien, `document_id` notieren. (Einmal **mit** `title` wiederholen, um zu bestätigen, dass die\n   generierte Titelfolie erscheint und die Nummerierung auf 4 verschiebt.)\n2. `append_slides_to_powerpoint` – `slides`: ein `default` mit `code`-Block und `table` sowie ein\n   `text-image` **mit** `image` als base64-Data-URI. → dieselbe `document_id`, 5 Folien.\n3. `append_slides_to_powerpoint` – `markdown` mit zwei `##`-Überschriften und einem `???`-Notizblock.\n   → 7 Folien, Notizen in der Referentenansicht sichtbar.\n4. `update_powerpoint_slide` – `slide_number: 2`, ein `slides`-Array mit einem Element vom Typ\n   `section`. → weiterhin 7 Folien, Folie 2 ist jetzt ein Kapiteltrenner.\n5. `read_powerpoint_slides` → `slide_count: 7`, Titel in der erwarteten Reihenfolge.\n\n**Weg C – Corporate-Master, iterativ erstellt**\n\n6. Master als `potx`-Vorlage hochladen → Logzeile\n   `Auto-extracted N slide layout(s) from PPTX template …`, `placeholders` leer.\n7. `describe_pptx_template` → `hasLegacyPlaceholders: false`, Layouts mit `layoutId`, `name`,\n   `masterId`, `role`, Slot-Keys mit mindestens einem `body:idx`-Paar und einem `pic:*`.\n8. `create_powerpoint_from_layouts` – 5 Folien, gemischt über **Rolle**, **Name** und **layoutId**\n   adressiert; mit mehrstufiger Aufzählung, einem zweispaltigen Layout, das `body:12` + `body:13`\n   befüllt, einem `\\n` innerhalb eines Werts und `notes` auf Folie 1.\n   → in PowerPoint öffnen: Corporate-Schriften\u002F-Farben\u002F-Logos, echte Master-Aufzählungszeichen, und\n   **„Folie zurücksetzen“ ändert nichts**.\n9. `set_powerpoint_slide_fields` – nur den `title` von Folie 2 ändern → dieselbe `document_id`,\n   gleiche Folienanzahl, andere Slots unberührt.\n10. `add_slides_from_layouts` mit dieser `document_id` → **dieselbe** `document_id`, 6 Folien, die neue\n    im selben Corporate Design. Mit `insert_after: 1` wiederholen → die Folie landet an Position 2.\n11. `set_powerpoint_slide_fields` mit `images: { \"pic:14\": { \"librechat_file_id\": \"\u003Cpng>\" } }` auf\n    einer Titel-Bild-Folie → das Bild füllt den Platzhalterrahmen, zugeschnitten statt verzerrt, und\n    `slide.filledImageSlots` in der Antwort listet `pic:14`.\n\n**Ein im Chat angehängter Foliensatz (§2a)**\n\n12. Eine `.pptx` an eine Chat-Nachricht anhängen → `list_my_files` zeigt sie mit einer `file_id`.\n13. `describe_pptx_template { \"librechat_file_id\": \"\u003Cfile_id>\" }` → derselbe Katalog wie in Schritt 7,\n    ohne Vorlagen-Upload.\n14. `read_powerpoint_slides { \"librechat_file_id\": \"\u003Cfile_id>\" }` → Folien in der Reihenfolge, in der\n    PowerPoint sie anzeigt, jeweils mit `layoutId` und `slots`.\n15. `add_slides_from_layouts` gegen diese `file_id` → die `message` in der Antwort sagt, dass der\n    Anhang direkt aktualisiert wurde (gleiche `file_id`, `librechat_file_id` in der Antwort) oder dass\n    die geänderte Kopie als neues Dokument gespeichert wurde (neue `id` und `markdownLink`).\n\n**Weg D – Design-Deck mit Blindtext (Code-Ausführung)**\n\n16. Ein Deck anhängen, dessen Inhaltsfolien einfache Textfelder sind („Text“, „XXX“) →\n    `describe_pptx_template` zeigt Layouts ohne Text-Slots, `read_powerpoint_slides` zeigt den Blindtext.\n17. `pptx_inventory.py` auf `\u002Fmnt\u002Fdata\u002F\u003Cdeck>.pptx` → Zeilen mit `box` und `!DUMMY`.\n18. `pptx_fill.py` mit einem Plan, der eine Musterfolie zweimal nutzt, eine Liste von Bullets, eine\n    Absatz-Map `{\"0\": …, \"2\": …}` und ein `delete` → `saved … N slides`, `CHECK OK`, und das Ergebnis\n    kommt als Chat-Anhang zurück; in PowerPoint sehen die Kopien aus wie die Musterfolie.\n19. Derselbe Plan mit einer weggelassenen Shape-ID → `CHECK FAILED` mit dieser Folie und Shape,\n    Exit-Code 2.\n\n**Fehlerpfade**\n\n20. `\"layout\": \"GibtsNicht\"` → Fehler, der alle Layouts **und** Rollen auflistet.\n21. `fields: { \"untertitel\": \"x\" }` auf einem Layout ohne diesen Slot → `unknownFields: [\"untertitel\"]`.\n22. `slide_number: 99` bei `set_powerpoint_slide_fields` → Fehler mit der tatsächlichen Folienanzahl.\n23. `reference_slide` zusammen mit `slides` → Fehler.\n24. Ein Foliensatz **mit** `{{}}`-Markup durch `describe_pptx_template` →\n    `hasLegacyPlaceholders: true` → zu `create_powerpoint_from_template` wechseln.\n25. `add_slides_from_layouts` auf einem mit `create_powerpoint` erstellten Foliensatz → Fehler, der\n    `append_slides_to_powerpoint` nennt, und die Folienanzahl des Foliensatzes bleibt unverändert.\n26. `add_slides_from_layouts` mit `insert_after` jenseits der Folienanzahl → Fehler mit der\n    tatsächlichen Anzahl.\n27. `pptx_inventory.py \u003CFirmen-Master> --lists` → eine Zeile pro Text-Slot mit `at x%,y%` und\n    `L0`…`L4`; ein Slot, dessen Master-Ebene 0 Aufzählungszeichen hat, zeigt `L0=bullet`. Befülle ihn\n    mit `[\"Punkt A\", \"Punkt B\"]` (ohne getipptes `•`) → PowerPoint zeigt genau einen Punkt pro Zeile.\n\n`MANUAL_TESTS.md` §4.6 (Corporate-Master) und §4.9 (im Chat angehängter Foliensatz) enthalten diese\nSzenarien als direkt ausführbare cURL-Befehle.\n",{"name":5,"description":7},"main","39e0752000720de2d20917bd46c1c5149c4a0221","de\u002Fskills\u002Ffiles\u002Fpowerpoint-skill","https:\u002F\u002Fgithub.com\u002FinnFactory-AI\u002Fcompany-ai-stack-skills","https:\u002F\u002Fgithub.com\u002FinnFactory-AI","https:\u002F\u002Finnfactory.ai","Engineering AI. Enabling Tomorrow.","2026-11-13 19:54:47",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add innFactory-AI\u002Fcompany-ai-stack-skills --skill powerpoint-skill",{"tool":38,"command":39},"bunx","bunx skills add innFactory-AI\u002Fcompany-ai-stack-skills --skill powerpoint-skill",{"tool":41,"command":42},"pnpm","pnpm dlx skills add innFactory-AI\u002Fcompany-ai-stack-skills --skill powerpoint-skill","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FinnFactory-AI\u002Fcompany-ai-stack-skills\u002Fblob\u002Fmain\u002Fde\u002Fskills\u002Ffiles\u002Fpowerpoint-skill\u002FSKILL.md",true,[46,52],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"scripts\u002Fpptx_fill.py","SCRIPT","脚本",16427,"https:\u002F\u002Fgithub.com\u002FinnFactory-AI\u002Fcompany-ai-stack-skills\u002Fblob\u002Fmain\u002Fde\u002Fskills\u002Ffiles\u002Fpowerpoint-skill\u002Fscripts\u002Fpptx_fill.py",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"scripts\u002Fpptx_inventory.py",17200,"https:\u002F\u002Fgithub.com\u002FinnFactory-AI\u002Fcompany-ai-stack-skills\u002Fblob\u002Fmain\u002Fde\u002Fskills\u002Ffiles\u002Fpowerpoint-skill\u002Fscripts\u002Fpptx_inventory.py",[57,64,71,78,85,92],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":19},"01M7AF4HHK5B987T44HW7BZFVZ","sales-asset-skill","Produce tailored one-pagers, landing pages, case study drafts, and demo narratives personalised to a specific deal and buyer persona. Use when preparing collateral for a specific deal, building leave-behind materials, or customising standard assets for a prospect. Trigger with \"create a one-pager for\", \"sales deck for [deal]\", \"customise this asset for\".","https:\u002F\u002Fgithub.com\u002FinnFactory-AI\u002Fcompany-ai-stack-skills\u002Fblob\u002Fmain\u002Fen\u002Fskills\u002Fsales\u002Fsales-asset-skill\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M7AF4D32V0FJE0QGCBZSQ7BW","pipeline-review-skill","Analyse deal health, surface stale or at-risk opportunities, and produce a prioritised weekly action plan. Use when preparing for a pipeline review meeting, assessing forecast accuracy, or identifying stuck deals. Trigger with \"review my pipeline\", \"pipeline health check\", \"deal risk analysis\".","https:\u002F\u002Fgithub.com\u002FinnFactory-AI\u002Fcompany-ai-stack-skills\u002Fblob\u002Fmain\u002Fen\u002Fskills\u002Fsales\u002Fpipeline-review-skill\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M7AF48W7G8DMAHRAM125B192","outreach-skill","Research a prospect then draft personalised outreach with research-backed hooks, subject-line variants, and follow-up sequences. Use when cold-emailing a prospect, writing LinkedIn outreach, or building a multi-touch sequence. Trigger with \"draft outreach to [person\u002Fcompany]\", \"write cold email to\", \"outreach sequence for\".","https:\u002F\u002Fgithub.com\u002FinnFactory-AI\u002Fcompany-ai-stack-skills\u002Fblob\u002Fmain\u002Fen\u002Fskills\u002Fsales\u002Foutreach-skill\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M7AF43VKNPQ7G1NTQ4MRH40J","forecast-skill","Build a weighted revenue forecast with risk flags, commit recommendations, and gap-to-quota analysis. Use when preparing for a forecast call, evaluating end-of-quarter projections, or assessing pipeline coverage. Trigger with \"build forecast\", \"forecast for this quarter\", \"where do I stand against quota\".","https:\u002F\u002Fgithub.com\u002FinnFactory-AI\u002Fcompany-ai-stack-skills\u002Fblob\u002Fmain\u002Fen\u002Fskills\u002Fsales\u002Fforecast-skill\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M7AF3Z5N61VYSEJRYWXR4JP1","deal-strategy-skill","Map stakeholder power dynamics, surface deal risks, and recommend a step-by-step engagement strategy. Use when entering a complex deal, preparing for an executive sponsor meeting, or diagnosing a stuck opportunity. Trigger with \"plan deal strategy for\", \"stakeholder map\", \"how do I advance this deal\".","https:\u002F\u002Fgithub.com\u002FinnFactory-AI\u002Fcompany-ai-stack-skills\u002Fblob\u002Fmain\u002Fen\u002Fskills\u002Fsales\u002Fdeal-strategy-skill\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":19},"01M7AF3VGG29AX0T2X9WQ5MWDN","call-summary-skill","Extract action items, key topics, and objections from call notes or transcripts and draft a customer-facing follow-up email. Use after a sales call, demo, or discovery session. Trigger with \"summarise this call\", \"call notes from\", \"write follow-up for this meeting\".","https:\u002F\u002Fgithub.com\u002FinnFactory-AI\u002Fcompany-ai-stack-skills\u002Fblob\u002Fmain\u002Fen\u002Fskills\u002Fsales\u002Fcall-summary-skill\u002FSKILL.md",[],[]]