Communitygithub.com

sharonzhang98/editorial-pptx-deck

Cursor Agent Skill: Erstelle bearbeitbare, editorial-minimalistische Business-PPTX-Deck aus HTML-Folien.

Was ist editorial-pptx-deck?

Diese Skill ermöglicht die Erstellung professioneller, redaktionell-minimalistischer Präsentationsdecks im PPTX-Format, die vollständig bearbeitbar sind (keine statischen PDFs oder Bilder). Der Workflow basiert auf HTML-Folien als Quellformat: Jede Folie wird als einzelne HTML-Datei verfasst, und ein Build-Skript (`scripts/html2pptx.js`) übersetzt jedes DOM-Element in native PowerPoint-Textfelder – doppelklickbar und editierbar. Das Skill unterstützt folienbasierte Vorlagen (Cover, Trennseiten, Inhaltsseiten, Vergleichstabellen, Pipeline-Diagramme, Abschlussfolien) und ein klares Designsystem mit definierten Farben, Schriftarten (Georgia für Titel, Arial/Helvetica für Fließtext) und einer roten Akzentfarbe. Die endgültige Ausgabe ist ausschließlich die PPTX-Datei; HTML- oder PDF-Exporte sind nicht erwünscht. Für Entwickler und Agent-Anwender ist diese Skill besonders nützlich, da sie die automatisierte, konsistente Erstellung von Präsentationen aus strukturierten HTML-Daten ermöglicht und sich nahtlos in CI/CD-Pipelines oder KI-gestützte Workflows integrieren lässt.

Funktioniert mit~Claude Code~Codex CLI✓Cursor
npx skills add sharonzhang98/editorial-pptx-deck

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Vorschau

Aus dem Skill-README

editorial-pptx-deck preview

Dokumentation

Editorial PPTX Deck

Erstelle eine polierte, redaktionell-minimalistische Folienpräsentation und exportiere sie als bearbeitbare PPTX. Die endgültige Ausgabe ist nur die .pptx – die HTML-Folien sind lediglich die Build-Quelle; PDF- oder HTML-Viewer werden nicht erstellt.

Funktionsweise

Die Folien werden als eingeschränktes HTML verfasst (eine Datei pro Folie). Anschließend übersetzt scripts/html2pptx.js jedes DOM-Element in ein natives PowerPoint-Objekt (echte, doppelklick-editierbare Textfelder). Die Folienbreite ist fest auf 1280px × 720px = 960pt × 540pt (LAYOUT_WIDE) festgelegt.

Build-Workflow

Kopiere diese Checkliste und verfolge den Fortschritt:

- [ ] 1. Projektstruktur anlegen (shared/ assets/ slides/ output/)
- [ ] 2. Erzählstruktur planen → jede Folie einem Vorlagentyp zuordnen
- [ ] 3. Folien slides/NN-name.html aus Vorlagen schreiben (nur Text bearbeiten)
- [ ] 4. check_overflow → jede Folie korrigieren, die nicht exakt 1280x720 ist
- [ ] 5. PPTX exportieren (nur)
- [ ] 6. Build-Quellen bereinigen (nur die .pptx behalten)

1. Projektstruktur anlegen. Erstelle im Arbeitsprojekt die Verzeichnisse shared/, assets/, slides/, output/. Kopiere shared/tokens.css aus dieser Skill in das shared/-Verzeichnis des Projekts. Kopiere nur die Fotos, die du verwenden wirst, aus dem assets/-Verzeichnis dieser Skill in das assets/-Verzeichnis des Projekts. Installiere Abhängigkeiten einmalig:

npm i pptxgenjs playwright sharp && npx playwright install chromium

2. Planen. Wandle den Quellinhalt in eine Folienliste um. Jede Folie ist einer der Vorlagentypen. Ein typisches Deck = Titelfolie → (Trennfolie → 1–3 Inhaltsfolien) × Abschnitte → Abschlussfolie. Halte den Text knapp; dieser Stil ist luftig.

3. Folien schreiben. Kopiere die nächstgelegene Vorlage aus templates/ nach slides/NN-name.html und ersetze den Text. Regeln:

  • Behalte <link rel="stylesheet" href="../shared/tokens.css">.
  • Titel verwenden die Serifenschrift; alles andere ist serifenlos (bereits in den Tokens hinterlegt).
  • Nur ein roter Akzent. Verwende das dunkle Panel (--ink-panel) sparsam für Kontrast, mit Gold #C9A24B als einzigem Akzent darin.
  • Fotos werden über <img> eingefügt (niemals mit CSS background-image). Siehe Fotobibliothek.

4. Passform prüfen. Folien, die überlaufen, werden in der PPTX abgeschnitten:

node scripts/check_overflow.mjs --slides slides

Korrigiere alles, was als OVERFLOW markiert wird (Text kürzen oder Positionen verschieben), bis alle Folien 1280x720 melden.

5. Nur PPTX exportieren.

node scripts/export_deck_pptx.mjs --slides slides --out output/DeckName.pptx

Die Folien werden nach Dateinamen sortiert (01-…, 02-…). Führe keinen PDF- oder HTML-Export aus – PPTX ist die alleinige Ausgabe.

6. Aufräumen. Lösche die HTML-Dateien in slides/ sowie alle temporären Dateien, sodass nur output/DeckName.pptx übrig bleibt (plus wiederverwendbare shared/ + assets/, falls der Nutzer iterieren möchte).

Designsystem

Definiert in shared/tokens.css. Keine neuen Farben erfinden.

TokenHEXVerwendung
--ink#1A1A1ATitel und primärer Fließtext
--soft#555555Sekundärer Fließtext
--muted#8C8C8CLabels, Notizen, Seitennummern
--red#C8102EDer eine Akzent: Balken, Vorspann, Schlüsselwörter, Unterstreichungen
--red-deep#A00C24Negative Hervorhebung in Tabellen
--red-pale#FBE9ECVerbindungschips (z. B. "→"-Kreise)
--box#F4F3F1Helle Karten / Zebra-Zeilen
--line#E4E2DEHaarfeine Trennlinien
--ink-panel#1C1C1CDunkle Kontrastpanels
gold#C9A24BAkzent nur auf dunklen Panels
Hintergrund#FFFFFFSeite
  • Schriftart: Georgia Serif für h*/Titel; Arial/Helvetica serifenlos für alles andere.
  • Signatur: Dünner roter vertikaler Balken links vom Titel + kleiner, sperrig gesetzter roter Vorspann darüber; winzige zentrierte Seitennummer unten.
  • Markenwechsel: Um an ein anderes Unternehmen anzupassen, ändere in tokens.css --red (und optional --ink-panel/gold) – nichts weiter.

Fotobibliothek

Die Fotos befinden sich im assets/-Ordner dieser Skill. Hochformat-Bilder füllen das rechte ~40% Trenn-/Cover-Panel (object-fit:cover); Querformat-Bilder eignen sich für randlose Cover.

DateiAusrichtungAm besten geeignet für
sail.pngHochformat 589×1024Trennfolie / rechtes Cover-Panel (Standard)
lighthouse-cliff.pngHochformat 627×1024Trennfolie / rechtes Cover-Panel
staircase.pngHoch 312×1024Ruhiger/abstrakter Trennstreifen
mast.pngSchmal 208×1024Schmaler Trennstreifen
hiker-clouds.pngSchmal 225×1024Schmaler Trennstreifen
lighthouse-sunset.pngQuerformat 1024×721Randloses Cover / oberes Band
sailboat-deck.pngQuerformat 1024×721Randloses Cover / oberes Band

Tausche ein Foto aus, indem du <img src="../assets/….png"> änderst. Verwende für alle Trennfolien ein einheitliches Foto (oder ein Motiv) für Kohärenz. Benutzer können auch eigene Bilder in assets/ ablegen.

Vorlagenkatalog

In templates/ (jede Vorlage ist eine vollständige, überlaufsichere 1280×720-Folie):

DateiTyp
01-cover.htmlGeteiltes Cover: Serifen-Titel links, Porträtfoto rechts
02-divider.htmlAbschnittstrenner: Vorspann + Serifen-Titel + roter Balken, Porträtfoto rechts
03-three-column.htmlVorspann/Titel + Kernzeile + 3 Spalten + Ergebnisstreifen
04-mapping.htmlZwei Spalten „Was sie wollen → Was wir tun“ mit Verbindungschips
05-compare-table.html3-spaltige Vergleichstabelle, Zebra-Zeilen
06-dark-contrast.htmlZwei Panels (hell vs. dunkel) + Serifen-Fußzeile
07-pipeline.htmlNummerierte horizontale Schritt-Pipeline + dunkle Ausgabezeile
08-closing.htmlAbschlusspitch: nummerierte Serifen-Zeilen + Porträtfoto rechts

Harte Einschränkungen

Die HTML→PPTX-Konvertierung schlägt fehl oder rendert falsch, wenn diese Regeln verletzt werden. Vollständige Details + Korrekturen in reference.md:

  1. Text nur innerhalb von <p>/<h1>–<h6> (niemals freier Text in einem <div>).
  2. Keine CSS-Verläufe.
  3. background/border/box-shadow nur auf <div>, niemals auf Text-Tags.
  4. Kein background-image; <img> verwenden.
  5. Inline-Tags (span/em/strong) dürfen keine Ränder haben.
  6. Die Folie bleibt 1280×720; nichts darf überlaufen.

Verwandte Skills