Communitygithub.com

YuukiMarine/websiteskills

Verwandle einen Artikel oder ein Skript in eine klickbare, 16:9-Webpräsentation, die wie ein Video aussieht. Optional mit Sprachsynthese.

Was ist websiteskills?

Dieses Skill verwandelt einen geschriebenen Artikel oder ein Skript (z. B. für Voiceover) in eine interaktive, wie ein Video aussehende Webpräsentation im 16:9-Format. Der gesamte Arbeitsablauf ist in vier Phasen unterteilt: Zuerst wird aus dem Ausgangsmaterial ein Skript (script.md) und ein Entwicklungsplan (outline.md) erstellt. Nach einem Checkpoint, an dem Nutzer und Agent fünf Schlüsselpunkte (Skript, Outline, Thema, Assets, Entwicklungsmodus) abstimmen, folgt die Webentwicklung. Jedes Kapitel wird dabei unabhängig entwickelt und durchläuft eine strenge Selbstprüfung. Abschließend kann optional Sprachsynthese (Provider-unabhängig, inklusive MiniMax und OpenAI TTS) erfolgen, um eine synchronisierte „Auto-Play“-Aufnahme zu ermöglichen. Das Skill ist plattformunabhängig und betont Designmethodik und Kollaborationsworkflow, nicht spezifische Stile oder Farben.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/YuukiMarine/websiteskills/tree/HEAD/skills/web-video-presentation

In Ihrer bevorzugten KI fragen

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

Dokumentation

Web Video Präsentation

Verwandle einen Artikel oder ein Skript Schritt für Schritt in eine „als Video getarnte Webseite“, die aufgenommen werden kann. Optional mit Sprachsynthese. Das Ergebnis ist ein Vite + React + TS Projekt + nach Kapiteln getrennte Audiodateien.

Anwendungsbereiche

  • „Ich habe ein Skript/einen Artikel – mach daraus ein Video“ – inhaltsgetriebene Präsentationen
  • Dynamische „PowerPoint auf jedem Bildschirm“ erstellen
  • 16:9 Breitbildaufnahme (große Schrift, viel Weißraum, Animationen auf jeder Folie)
  • Lehrinhalte / Produktdemos / Keynotes mit filmischem Look
  • Bilibili / YouTube / TikTok Video-Inhalte

Dieses Skill konzentriert sich auf Methodik und Kollaborationsworkflow. Das Scaffold-Template bietet Tokens und Grundbausteine, aber jede ästhetische Entscheidung (Farbpalette, Schriftart, Animationsstil) sollte für dein spezifisches Thema neu gestaltet werden – nicht blind kopiert.


Workflow Übersicht

Phase 1   Inhaltserstellung
   1.1  Benutzereingabe identifizieren
   1.2  Einmalige Ausgabe von script.md + outline.md
        (Voiceover-Skript + Entwicklungsplan)
   ▼
[Checkpoint Plan]      ← Muss anhalten. 5 Dinge auf einmal abstimmen:
                         Skript / Outline / Thema / Assets / Entwicklungsmodus
   ▼
Phase 2   Webentwicklung
   2.1  Scaffold (nach gewähltem Thema)
   2.2  Kapitel 1 = Haupt-Thread + vollständige Version (obligatorischer Ankerpunkt)
        ▼
        [Harter Knoten] Benutzer akzeptiert Kapitel 1 ← Nicht überspringbar
        ▼
   2.3  Kapitel 2~N (nach gewähltem Modus: A Kapitel für Kapitel / B Sequentiell / C Parallel)
   ▼
[Checkpoint Audio]     ← Muss anhalten. Audio-Synthese oder nicht
   ▼
Phase 3   Audio-Synthese (optional)
   ▼
Phase 4   Bildschirmaufnahme + Postproduktion

Arbeitsverzeichnis Konvention (Agent erstellt/bearbeitet im aktuellen Verzeichnis des Benutzers):

my-video/
├── article.md          # Vorhanden, wenn Benutzer Originaltext liefert – nicht löschen! Informationsquelle für die visuelle Entwicklung
├── script.md           # Vorhanden: Plattformtaugliches Voiceover-Skript (bestimmt die Taktung)
├── outline.md          # Vorhanden: Entwicklungsplan (Kapitelaufteilung + Schritte + Informationspool)
└── presentation/       # Vite + React + TS Projekt (vom Scaffold erzeugt)
    ├── src/chapters/<NN>-<id>/
    │   ├── <Chapter>.tsx     # Visuelle Implementierung
    │   ├── <Chapter>.css
    │   └── narrations.ts     # ★ Einzige Quelle der Wahrheit für Schrittanzahl und Voiceover-Text
    ├── scripts/
    │   ├── extract-narrations.ts   # Scannt alle narrations.ts → audio-segments.json
    │   ├── synthesize-audio.sh     # Provider-unabhängiger Runner (durchläuft Segmente)
    │   └── tts-providers/          # Ein .sh pro Provider (2 integriert)
    │       ├── README.md           # Drei-Funktionen-Vertrag + 5 fertige Code-Snippets (11labs / edge-tts / say / azure / gcloud)
    │       ├── minimax.sh          # Standard-Provider, nutzt mmx-cli
    │       └── openai.sh           # Integrierter OpenAI TTS (curl + OPENAI_API_KEY)
    ├── audio-segments.json         # output von extract (vor Synthese prüfbar)
    └── public/audio/<id>/<N>.mp3   # Optional: Synthetisierte Audiodateien

Wichtig: narrations.ts ist die einzige Quelle der Wahrheit für Schrittanzahl und Audio-Synthese. Das maximale N + 1 in if (step === N) im Kapitel .tsx muss gleich narrations.length sein. Dadurch wird sichergestellt, dass die 5 Stellen (script / outline / Kapitelcode / chapters.ts / Audiodateien) niemals auseinanderdriften.


Harte Selbstprüfprotokolle (durchgängig im gesamten Skill)

Für die folgenden drei Ergebnisse MUSS nach Fertigstellung eine Selbstprüfung → Reparatur → erneute Meldung/Fortsetzung erfolgen:

ErgebnisQuelle der Prüfliste
script.mdSCRIPT-STYLE.md Drei-Ebenen-Prüfung (Form / Stimme / Vorlesen)
outline.mdOUTLINE-FORMAT.md Selbstprüfung
Kapitelimplementierung abgeschlossenCHAPTER-CRAFT.md Fertigstellungs-Selbstprüfung

Ausführungsmethode (nach Fähigkeiten absteigend, bevorzuge isoliertere Methoden):

  1. Agent Teams (Optimal): Starte einen unabhängigen Reviewer-Agenten, gib ihm "Pfad zur Ausgabedatei + entsprechende Liste + Kontext", lass ihn Punkt für Punkt prüfen und streng Schlussfolgerungen melden (welche bestanden / welche durchgefallen + Beweise + Verbesserungsvorschläge).
  2. subAgent (Sekundär): Wenn keine Teams-Fähigkeit vorhanden, aber subAgent möglich ist, verwende denselben Prozess mit subAgent.
  3. Selbstprüfung (Fallback): Wenn der aktuelle Agent keine der obigen Fähigkeiten hat, prüfe selbst streng Punkt für Punkt – ein flüchtiger Blick und Freigabe ist nicht erlaubt.

Eiserne Regel: Nach Erhalt der Schlussfolgerungen repariere zuerst alle fehlgeschlagenen Punkte, dann melde dem Benutzer "fertig + Prüfergebnis + was geändert wurde". Direktes Melden der rohen Ergebnisse ohne Korrektur = Regelverstoß.


Dateileseführer für jede Phase

Verschiedene Phasen lesen verschiedene Dateien. In langen Sitzungen vergisst der Agent leicht Prinzipien, besonders in Phase 2.4 "Kapitel implementieren", die N-mal wiederholt wird – jedes Mal müssen die Kernbeschränkungen erneut überprüft werden.

PhaseMuss gelesen werden (jedes Mal)Einmalig lesen / nach Bedarf nachschlagen
Phase 1.1-1.2 Inhaltserstellungreferences/SCRIPT-STYLE.md + references/OUTLINE-FORMAT.md + article.md (Originaltext des Benutzers, falls vorhanden)——
Checkpoint Plan Thema wählen——themes/*/theme.json (dynamisch alle lesen, Liste + bestFor Empfehlung + descriptionZh) auflisten; references/THEMES.md (wenn Benutzer das Themensystem verstehen möchte)
Phase 2.1 Scaffold——SKILL.md diesen Abschnitt einmal lesen
Phase 2.4 Kapitel implementieren (×N mal, aufgerufen von 2.2 / 2.3)references/CHAPTER-CRAFT.md Einzige Einstiegsseite – Teil 0 Zehn Prinzipien / Teil 1 5 Fragen vor Start / Teil 2 Beziehung→Aktion Entscheidungsbaum / Teil 3 Visuelles Toolkit / Teil 4 Zeitreferenzen / Teil 5 Anti-AI Anti-Patterns / Teil 6 Harte Code-Regeln (inkl. obligatorische narrations.ts Beschränkungen) / Teil 7 Fertigstellungs-Selbstprüfung / Teil 8 Feedback-Referenz + themes/<id>/theme.json des aktuellen Themas + Outline.md Absatz des aktuellen Kapitels + article.md entsprechender Abschnitt des Kapitels + Asset-Listereferences/EXAMPLES/ (Strukturreferenz, nicht zum Kopieren); references/THEMES.md Vollständiger Token-Vertrag
Phase 3 Audio-Synthesereferences/AUDIO.md (enthält Workflow narrations.ts → segments.json → beliebiger Provider, inklusive minimax + openai)templates/scripts/tts-providers/README.md (beim Wechseln/Hinzufügen von Providern / eigenem TTS)
Phase 4 Aufnahme + Postproduktionreferences/RECORDING.md (enthält ?auto=1 für automatische Aufnahme)——
Thema wählen / erstellen / anpassen——references/THEMES.md

Beim Schreiben von Kapiteln nur CHAPTER-CRAFT.md lesen. Zehn Prinzipien / Start-Self-Prompting / Entscheidungsbaum / Anti-AI Anti-Patterns / Fertigstellungs-Selbstprüfung sind alle in diesem einen Einstiegspunkt zusammengefasst. EXAMPLES/ ist nicht obligatorisch – zuerst nach Inhalt frei entwerfen, nur bei Stocken nachschlagen (nach Anker für "Form", nicht blind kopieren).


Phase 1 – Inhaltserstellung (einmalige Ausgabe)

1.1 Benutzereingabe identifizieren

Vom Benutzer gegebenZu tun
Originaler Artikel (schriftliche Sprache / Blog / Paper / Blog)Einmalige Ausgabe von script.md + outline.md (1.2), dann Checkpoint Plan
Direktes Voiceover-Skript / Video-SkriptAls script.md speichern, einmalige Ausgabe von outline.md (vereinfachte Version 1.2), dann Checkpoint Plan
Nichts außer "Mach mir ein Video zum Thema X"Nachfragen: Erst Material oder Gliederung geben. Skill ersetzt nicht die Ideenfindung des Benutzers

1.2 Einmalige Ausgabe von script.md + outline.md

Beide Ausgaben werden in einem Denkdurchlauf erstellt:

  1. script.md generieren: Nach den Regeln in references/SCRIPT-STYLE.md den Artikel in ein plattformtaugliches Voiceover-Skript umwandeln. article.md behalten und nicht löschen – es ist die Detailquelle für den Informationspool und die visuelle Umsetzung im Outline (Zwei-Quellen-Prinzip).
  2. outline.md generieren: Nach den Regeln in references/OUTLINE-FORMAT.md Kapitel teilen + Schritte teilen + pro Kapitel im ersten Absatz einen Informationspool extrahieren.

Grenzen des Outlines (Schlüssel):

Outline muss schreibenOutline darf nicht schreiben
Kapitelaufteilung / Schritte pro Kapitel / ZeitabschätzungSpezifische Animationstypen (blur clear / wipe / spring)
Bildschirminhalt pro Schritt (Hero / Daten / Slogan / Listeneinträge)CSS-Implementierungsmittel (filter / SVG / clip-path)
Kapitelweiser Informationspool: Aus dem Artikel extrahierte Zahlen / Zitate / Beispiele / TagsZeitwerte (nicht 2,5s / 80120ms)
Präfix für Beziehungsnamen auf Schritt-Ebene ("Kontrast & Vergleich" / "Progressive Liste" / "Kernaussage" etc. optionaler Hinweis)Mikro-Rhythmen wie Dauermikrobewegung / Staffelung

Grund für kein Schreiben von Animationen im Outline: Feste Animationen machen den Kapitel-Agenten zu einer Übersetzungsmaschine; der Freiraum erlaubt dem Kapitel-Agenten, bei jedem Schritt nach dem "inhaltsgetriebenen Entscheidungsbaum" in CHAPTER-CRAFT.md frei zu gestalten – nur so entsteht echtes Video-Gefühl. Siehe CHAPTER-CRAFT.md Teil 0, Prinzip 7.

Nach dem Speichern muss zuerst die Selbstprüfung durchgeführt werden, bevor der Checkpoint Plan betreten wird: Führe für script.md / outline.md das oben genannte "Harte Selbstprüfprotokoll" durch (bevorzugt Agent Teams → subAgent → Selbstprüfung), behebe die Ergebnisse nach Anweisung, dann betrete den Checkpoint Plan.


Checkpoint Plan – 5 Dinge auf einmal abstimmen (Harter Knoten)

Nachdem script.md + outline.md erstellt wurden, muss angehalten werden. Der Benutzer bestätigt an diesem einen Knoten gleichzeitig 5 Dinge.

Vorbereitungsarbeit des Agenten zu diesem Zeitpunkt

  1. Alle themes/*/theme.json lesen für nameZh / descriptionZh / bestFor / mood – Liste nicht hartcodieren
  2. Basierend auf Inhaltstyp / Schlüsselwörtern / Ton von script.md, aktiv 2–3 am besten passende Empfehlungen aus den Themen auswählen (passend zum bestFor Feld)
  3. Den Abschnitt "Asset-Liste" am Ende von outline.md überfliegen

Zusammenfassungsvorlage (Grundgerüst, Agent füllt nach Situation aus)

Inhaltsplan erstellt, Ausgabedateien:
  📄 article.md     {falls Benutzer Originaltext geliefert hat}
  📄 script.md      {X} Zeichen / ~{T} Minuten
  📄 outline.md     {N} Kapitel / {M} Schritte + Informationspool pro Kapitel + Asset-Liste am Ende

Kapitelübersicht:
  1. <id>     <Kapiteltitel>    <S> Schritte ~<T>s
  2. ...

Jetzt 5 Dinge auf einmal abstimmen:

  1. Skript (script.md) bearbeiten?
     Datei direkt editieren oder Änderungsrichtung mündlich mitteilen.

  2. Entwicklungsplan (outline.md) bearbeiten? Wichtige Punkte:
     - Ist die Kapitelaufteilung / Schrittanzahl / Zeitabschätzung sinnvoll? (Faustregel: 30–60s pro Kapitel)
     - Sind die Bildschirminhalte pro Schritt klar?
     - Hat der erste Absatz jedes Kapitels (Informationspool) genügend Details aus article.md für die visuelle Umsetzung?
     - Ist die Asset-Liste am Ende vollständig?

  3. Welches Thema wählen? Meine Empfehlung:
     ★ <Empfehlung 1: nameZh (id)> – weil <bestFor trifft zu>; <descriptionZh Zusammenfassung>
     ★ <Empfehlung 2 / Empfehlung 3>
     Andere Optionen: <Restliche Themen, nameZh + ein Satz>
     Kann auch ein neues Thema für dich erstellen (siehe references/THEMES.md).

  4. Wie werden echte Assets vorbereitet? Grobe Liste benötigter Bilder: <Grobe Liste>
     a) Ich suche aus <vorhandenem Asset-Pfad> aus   b) Du lieferst selbst   c) Alle Platzhalter

  5. Welcher Entwicklungsmodus?

     **Kapitel 1 muss in jedem Modus im Haupt-Thread fertiggestellt und vom Benutzer abgenommen werden** (obligatorischer Anker).
     Der Unterschied liegt in Kapitel 2 und danach:

     A) Standard · Kapitel für Kapitel bestätigen (empfohlen)
        Nach jedem Kapitel anhalten und prüfen → Risiko kontrollierbar / stabilster Rhythmus
     B) Sequentiell nach Kapitel 1 (nicht parallel)
        Kapitel 2~N im Haupt-Thread nacheinander fertig, dann gemeinsam prüfen → mittlere Geschwindigkeit / geeignet wenn Agent keine Parallelaufgaben unterstützt
     C) Parallel nach Kapitel 1 (subAgent)
        Kapitel 2~N mit subAgent parallelisieren → am schnellsten / Benutzer kontrolliert Parallelität (wie viele Kapitel auf einmal)
        ⚠️ Stilistische Unterschiede zwischen Kapiteln sind zu erwarten (dies ist beabsichtigt, Absturzsicherung durch Thementoken)

Nach Erhalt des Feedbacks:

  • Skript / Outline ändern: Datei direkt editieren, nach dem Editieren einmal ping (oder mündlich beschreiben, Agent ändert)
  • Thema muss klar sein, bevor Phase 2 betreten wird. Benutzer sagt "Such du das Thema aus" → Nimm deine erste Empfehlung, sag dem Benutzer, was du gewählt hast und warum, gib Gelegenheit zum Umdenken
  • Modus ausgewählt → Phase 2 betreten

Phase 2 – Webentwicklung

2.1 Scaffold

bash <path-to-web-video-presentation>/scripts/scaffold.sh \
  ./presentation \
  --theme=<id des vom Benutzer gewählten Themas>

bash <path-to-web-video-presentation>/scripts/scaffold.sh --list-themes

Eigenes Thema → Zuerst nach Workflow in references/THEMES.md "Neues Thema erstellen" ein themes/<my-theme>/ machen, dann --theme=<my-theme>.

Das Scaffold bringt ein 01-example Demo. Vor dem Schreiben des ersten echten Kapitels löschen:

rm -rf presentation/src/chapters/01-example

Und den Import und Array-Eintrag von EXAMPLE_CHAPTER in presentation/src/registry/chapters.ts entfernen.

2.2 Kapitel 1 – Haupt-Thread + obligatorische Abnahme

Kern: Kapitel 1 = Vollständige Version auf einen Schlag (Rhythmus + visuell + echte Assets komplett). Kein "Skelett-Konzept" – das erste Kapitel muss eine vom Benutzer direkt abnahmefähige Vorlage sein.

Warum Kapitel 1 im Haupt-Thread sein muss:

  • Es ist die erste Umsetzung der Anleitung aus CHAPTER-CRAFT.md für das aktuelle Thema + aktuelles Material
  • Wenn die Anleitung blinde Flecken hat / die Themenfarben oder Schriftarten-Token nicht ausreichen, wird das in Kapitel 1 auffallen – dann kann mit menschlichem Feedback die Anleitung repariert / das Thema angepasst werden, je früher, desto günstiger
  • Nachfolgende Kapitel (egal ob sequentiell oder parallel) müssen sich am Code-Muster von Kapitel 1 orientieren, also Kapitel 1 = "Stilanker" für das aktuelle Projekt (keine stilistische Einheitlichkeit zwischen Kapiteln erzwungen, aber das einzelne Kapitel muss in sich schlüssig und überzeugend sein)

Nach Fertigstellung von Kapitel 1 muss angehalten werden – warte auf Benutzerabnahme:

Kapitel 1 <id> fertig. Dev Server läuft auf localhost:5173.

Abnahmeschwerpunkte:
  □ Stimmt die visuelle Stimmung? Entspricht sie den Erwartungen von <theme nameZh>?
  □ Stimmt der Rhythmus? Sind bestimmte Schritte zu schnell / zu langsam / zu dünn?
  □ Ist die inhaltsgetriebene Animation gelungen? Oder gibt es Schritte mit uninspirierten Eintrittsanimationen?
  □ Zwei-Quellen-Prinzip: Enthält der Bildschirm Details, die "das Voiceover nicht nennt, aber article.md liefert"?
  □ Anti-AI-Geruch-Check: Gibt es lila-rosa Farbverläufe / runde farbige Ränder / falsche Illustrationen / Emojis?

Sag mir, was geändert werden muss. Sag "Weiter", wenn OK, dann mache ich Kapitel 2 und folgende nach dem gewählten Modus.

2.3 Kapitel 2~N – nach gewähltem Modus

Gemeinsame Regel für alle Modi: Jedes Kapitel unabhängig nach CHAPTER-CRAFT.md entwickeln. Stilistische Einheitlichkeit zwischen Kapiteln wird nicht erzwungen – Themenfarben / Schriftarten-Token gewährleisten visuelle Einheit, aber Animation / Rhythmus / visuelle Demonstration werden frei vom Kapitel gestaltet, das ist beabsichtigt.

Modus A · Standard · Kapitel für Kapitel bestätigen

Kapitel 2 fertig → Anhalten zur Prüfung → OK → Kapitel 3 → Anhalten → … → Kapitel N. Jedes Kapitel einzeln prüfen, Probleme jederzeit beheben, geringstes Risiko, stabilster Rhythmus. Wenn Benutzer keinen Modus explizit wählt, wird standardmäßig dieser verwendet.

Modus B · Sequentiell nach Kapitel 1

Kapitel 2 → Kapitel 3 → … → Kapitel N nacheinander im Haupt-Thread fertigstellen, dann am Ende gemeinsam prüfen. Mittlere Geschwindigkeit, geeignet für Umgebungen, in denen der Agent keine parallelen Aufgaben unterstützt.

Modus C · Parallel nach Kapitel 1 (subAgent)

Mit subAgent Kapitel 2~N parallel fertigstellen, maximale Parallelität vom Benutzer kontrolliert ("einmal 4 Kapitel" / "einmal 2 Kapitel"). Am schnellsten, aber stilistische Unterschiede zwischen Kapiteln sind zu erwarten – das ist beabsichtigt, weil:

  1. Jeder subAgent sieht die Ergebnisse der anderen subAgenten nicht, kann sich nicht mechanisch angleichen
  2. Kapitelcode ist physisch getrennt (eigener Ordner / eigenes CSS-Präfix), beeinträchtigen sich nicht gegenseitig
  3. Thementoken gewährleisten visuelle Einheit (Farben / Schriftarten / Hero-Zahlen / Karten / Trennlinien / Dekoration), Stimmung driftet nicht ab
  4. Stilistische Uneinheitlichkeit = Atmung einer handgeschriebenen Video-Erzählung (mehrere Stimmen / Perspektiven)

Das Prompt für parallele subAgenten MUSS enthalten:

  • Outline-Absatz des aktuellen Kapitels (mit Informationspool)
  • Pfad zu references/CHAPTER-CRAFT.md (Einziges Pflichtdokument – visuelle Anforderungen + schrittweise Enthüllung + Zwei-Quellen-Prinzip + Anti-AI-Geruch + Code-Rotlinien + Fertigstellungs-Selbstprüfung alles in einer Datei)
  • descriptionZh / mood / bestFor aus theme.json des aktuellen Themas (zur Stimmungsreferenz; Animation / Dauer / Schriftgröße / Emojis werden vom Kapitel-Agenten frei bestimmt)
  • Kapitel 1 Code als "Code-Stil" Referenz (nicht "visuelles Objekt zum Kopieren")
  • Harte Regeln: Jedes Kapitel hat eigenes CSS-Präfix (.cd- / .mg- / .pm- / …); chapters.ts nicht ändern; nach Fertigstellung npx tsc --noEmit ausführen

Wichtig: Egal welcher Modus gewählt wurde, der Benutzer kann jederzeit mitten im Prozess den Modus wechseln. Wenn Kapitel 2 OK ist und der Benutzer sagt "Rest parallel" / "Rest einzeln" – beides möglich.

2.4 Kapitel implementieren (jedes Kapitel muss durchlaufen)

Detaillierte Anleitung in references/CHAPTER-CRAFT.md – einziges Pflichtdokument, das abdeckt: Anforderungen an visuelle Demonstration / schrittweise Enthüllung / Inhaltsauswahl / Zwei-Quellen-Prinzip / grundlegende Ästhetik von Video-Demos / Anti-AI-Geruch / Code-Rotlinien / Fertigstellungs-Selbstprüfung.

Kernpunkte (ausführlich in CHAPTER-CRAFT.md):

  • Jedes Kapitel MUSS eine CSS / SVG / Canvas / JS visuelle Demonstration haben, reine Textkapitel verboten
  • Schrittweise Enthüllung: Listen / Aufzählungen MÜSSEN 1 Eintrag = 1 Schritt sein, kein gleichzeitiges Zeigen mehrerer Einträge verboten
  • Zwei-Quellen-Prinzip: Rhythmus folgt dem Voiceover (Reihenfolge darf nicht verändert werden), Details kommen aus dem Originalartikel (Informationspool + article.md Abschnitt des Kapitels)
  • Fertigstellungs-Selbstprüfung Punkt für Punkt durchgehen, nicht bestandene Punkte zurückgehen und beheben – nach obigem "Hartes Selbstprüfprotokoll" (bevorzugt Agent Teams → subAgent → Selbstprüfung), erst nach Korrektur die Fertigstellung des Kapitels an den Benutzer melden

2.5 STORAGE_KEY nach größeren Änderungen erhöhen

Nach Änderungen an chapters.ts (Kapitel hinzufügen / löschen / umordnen oder Längenänderung von narrations.ts in einem Kapitel), erhöhe den STORAGE_KEY in presentation/src/hooks/useStepper.ts (z. B. v4 → v5), um zu vermeiden, dass ein persistierter Cursor auf einem nicht mehr existierenden Schritt landet.


Checkpoint Audio – Audio-Synthese oder nicht (Harter Knoten)

Nach Abschluss von Phase 2 muss angehalten werden, frage den Benutzer:

Webseite fertig, {N} Kapitel {M} Schritte, Dev Server läuft auf localhost:5173.

Audio für "Auto-Play-Aufnahme" synthetisieren?
  ✓ Synthese → Scanne alle narrations.ts aller Kapitel → audio-segments.json,
               rufe TTS Provider auf → synthetisiere pro Schritt eine mp3 nach public/audio/.
               Danach mit ?auto=1 Modus in einem Take aufnehmen (Audio und Video automatisch synchron).
               Zwei integrierte Provider:
                 • minimax (mmx-cli)    – Standard, stabile chinesische Sprachqualität
                 • openai  (OPENAI_API_KEY) – curl-basiert, die meisten haben bereits einen Key
               Andere Backends (ElevenLabs / edge-tts kostenlos / macOS say offline /
               Azure / Google) siehe scripts/tts-providers/README.md mit fertigen Code-Snippets.
  ✗ Keine Synthese → Phase 3 überspringen, direkt Phase 4 mit manueller Aufnahme + nachträglicher Vertonung.

Bei Synthese → Phase 3. Keine Synthese → Direkt Phase 4.


Phase 3 – Audio-Synthese (optional)

Detaillierter Workflow in references/AUDIO.md. Kurzversion:

cd presentation
npm run extract-narrations   # Scannt alle narrations.ts → audio-segments.json
# Benutzer lässt audio-segments.json gegenchecken, Text stimmt
npm run synthesize-audio                       # Standard: minimax Provider, inkrementell
# Oder mit integriertem openai (benötigt OPENAI_API_KEY):
PRESENTATION_TTS=openai npm run synthesize-audio
# Oder benutzerdefiniert: scripts/tts-providers/<name>.sh schreiben, siehe README.md in diesem Verzeichnis

Nach der Synthese dem Benutzer mitteilen: Ausgabepfad / Gesamtzahl Segmente / welche Segmente zeitlich auffällig sind (zu lang = Schritt aufteilen; zu kurz = Text zu dünn) – letzte Gelegenheit zur Rhythmusanpassung. Dann Phase 4 betreten.


Phase 4 – Bildschirmaufnahme + Postproduktion

Details in references/RECORDING.md. Zwei Pfade:

SzenarioEmpfohlener Pfad
Phase 3 Audio synthetisiertAuto-Modus in einem Take: Browser öffnet localhost:5173/?auto=1 → SPACE drücken → gesamtes Video läuft automatisch → Aufnahme stoppen → Anfang und Ende trimmen → fertig, keine nachträgliche Synchronisation von Tonspuren nötig
Phase 3 übersprungenStandard Manual-Modus, manuell klicken, fortschreiten → Nachträglich beliebiger Schnitt zum Vertonen

Agent informiert Benutzer aktiv nach Phase 3 / Checkpoint Audio über den geeigneten Aufnahmepfad.


Zehn Prinzipien (Ein-Satz-Liste)

Vollständige Ausführung siehe references/CHAPTER-CRAFT.md Teil 0 – Beim Schreiben von Kapiteln dort nachschlagen, hier nur Index.

#PrinzipEin Satz
116:9 fester BildschirmInhalt 1920×1080 + transform scale, kein responsives Design
2Globaler Schritt-ZählerKapitel sind reine Funktionen der Schritte, kein Timer
3Jeder Schritt belegt gesamten Bildschirmif (step === N) return <FullScene />
4Voiceover-Takt = SchrittEin Takt = ein Schritt = ein fokussierter Gedanke
5Versteckte RandelementeFortschrittsbalken / Blätterer standardmäßig opacity 0
6Bühne ohne ChromeKein header / footer / Seitenzahl / Branding-Balken
7Inhaltsgetriebene AnimationZuerst innere Aktion finden, nur wenn nichts gefunden wird Eintrittsanimation als Fallback; Dauermikrobewegung sparsam einsetzen
8Mehrere Punkte einzeln enthüllen1 Eintrag = 1 Schritt, gleichzeitiges Zeigen mehrerer Einträge verboten
9Gleiches Thema für gesamtes VideoKapitel wechseln nicht die Oberflächenfarbe; Farben / Schriftarten via Token, andere Skalen frei im Kapitel
10Zwei-Quellen-Prinzipscript bestimmt Takt, article bestimmt visuelle Dichte (im Informationspool umgesetzt)

Häufiges Benutzerfeedback Nachschlagewerk

Vereinfachte Tabelle in references/CHAPTER-CRAFT.md Teil 8 "Häufiges Feedback". Wichtig: Zuerst identifizieren, auf welcher Ebene das Problem liegt (Rhythmus / Visuell / Inhalt / Code), dann die kleinste Änderung vornehmen, das ganze Kapitel nicht neu machen.


Verwandte Ressourcen

Markiert nach "Wann lesen" um zu vermeiden, dass alles auf einmal gelesen wird:

DateiWann lesenInhalt
references/SCRIPT-STYLE.mdPhase 1.2 PflichtlektüreArtikel → Voiceover-Regeln, plattformspezifische Varianten
references/OUTLINE-FORMAT.mdPhase 1.2 PflichtlektüreFeld-Spezifikation für outline.md, Namenskonventionen, Kapitelaufteilung, Informationspool
references/CHAPTER-CRAFT.mdPhase 2.4 Einziges Pflichtdokument pro KapitelTeil 0 Zehn Prinzipien / Teil 1 5 Fragen vor Start / Teil 2 Beziehung→Aktion Entscheidungsbaum / Teil 3 Visuelles Toolkit / Teil 4 Zeitabschätzung / Teil 5 Anti-AI Anti-Patterns / Teil 6 Harte Code-Regeln / Teil 7 Fertigstellungs-Selbstprüfung / Teil 8 Feedback-Nachschlagen
references/EXAMPLES/Optional – Struktur ansehenKapitel-Strukturbeispiele (hook / list-reveal / case-tech-review); Nicht zum Kopieren als Template
references/THEMES.mdBei Thema wählen / erstellen / anpassenVollständiger Token-Vertrag + Liste integrierter Themen + Erstellungs-Workflow
references/AUDIO.mdErst in Phase 3 lesenProvider-unabhängiger Audio-Synthese-Workflow, integrierte minimax Nutzung, Provider wechseln, Fehlerbehebung
templates/scripts/tts-providers/README.mdBeim Wechseln / Hinzufügen eines TTS-ProvidersDrei-Funktionen-Vertrag + 2 integrierte (minimax / openai) + 5 fertige Code-Snippets (ElevenLabs / edge-tts / macOS say / Azure / Google)
references/RECORDING.mdErst in Phase 4 lesenBildschirmaufnahme-Tools + Postproduktion
themes/Bei Checkpoint Plan / Phase 1.2 durchblätternIntegrierte Themen (jedes mit theme.json + tokens.css)
scripts/scaffold.shPhase 2.1 einmal ausführenOne-Click-Projekt-Scaffold

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills