JaviMaligno/agilabs-video-studio

Artikelvideo

Orchestriert den gesamten Pfad von einem Artikel zu einer fertigen MP4. Die anderen Skills enthalten die Details; lade sie bei dem Schritt, der sie benötigt:

• explainer-script: Schreiben des Skripts und Auswählen eines visuellen Elements pro Szene.
• explainer-animation: Der Komponentenkatalog, die Timeline, maßgeschneiderte Komponenten, Standbilder.
• narration: TTS (Cartesia, Kokoro als Fallback), Aussprache, Audio-QA.

Das Remotion-Projekt befindet sich im template/-Ordner des Plugins (${CLAUDE_PLUGIN_ROOT}/template bei Installation als Plugin; neben skills/ im Plugin-Repository).

Nicht verhandelbar

• Faktencheck. Jede Zahl und jede Behauptung auf dem Bildschirm oder gesprochen wird auf einen Satz des Artikels zurückgeführt. Führe die Tabelle in factcheck.md (Behauptung, wo sie erscheint, der zitierte Artikelsatz). Zahlen werden exakt so dargestellt, wie der Artikel sie schreibt: gleiche Rundung, gleiche Einheiten, gleiches „14/20“ statt „70%“. Eine Abweichung wird in der Timeline korrigiert, niemals im Artikel. Der Faktencheck deckt die Narration und die auf dem Bildschirm gezeigten Zahlen und Behauptungen ab, nichts anderes. Visuelle Elemente werden für die Wirkung ausgewählt, nicht als wörtliche Wiedergabe des Experiments: Eine illustrative Szene (reale Daten frei wiedergegeben, Markierungen zur Verdeutlichung platziert, ein stilisierter Mechanismus) ist in Ordnung, da die Genauigkeit im Artikel und dessen Repository liegt.
• Stimme. Die Narration spricht, wie der Artikel geschrieben ist: erste Person („Ich führte … durch“, „Ich fand …“), mit Behauptungen, die nicht stärker sind als die des Artikels. Wenn der Artikel abschwächt („in diesem Aufbau“, „bei diesen 20 Läufen“), schwächt das Skript ebenfalls ab. Keine reißerischere Formulierung als die Quelle.
• Branding. Nur AGILabs: das AGILabs-Abzeichen und javieraguilar.ai. Kein persönlicher Name irgendwo, nicht in den Karten, dem Poster, den Untertiteln oder den Dateimetadaten.
• Genehmigungsschleife. Es wird nichts gebaut, bevor das Skript genehmigt ist.

Arbeitsablauf

1. Artikel auswählen. Verwende den genannten. Wenn keiner genannt ist, lies die veröffentlichten Artikel und schlage 2–3 Kandidaten vor, jeweils mit Titel, einem Aufhänger, der Schlüsselzahl (zitiert) und einer visuellen Idee. Bevorzuge Artikel mit einem Experiment, einer klaren Zahl und einem darstellbaren Mechanismus. Lass die Person wählen.

2. Skript schreiben mit explainer-script: die Erzählzeilen (EN, ES optional), eine visuelle Idee pro Szene, die einer Bibliothekskomponente zugeordnet oder als „maßgeschneidert“ markiert ist, und der Quellsatz für jede Zahl.

3. STOP für Genehmigung. Zeige das Skript und warte. Wende bei Bedarf Bearbeitungen an und zeige es erneut.

4. Videoordner erstellen. Kopiere die Vorlage ohne ihre generierten Dateien:

   • innerhalb des Plugin-Repos: examples/<artikel-slug>/;
   • aus einem anderen Repository: ./video/<artikel-slug>/.

   rsync -a --exclude node_modules --exclude out --exclude public/audio --exclude public/music \
     --exclude .env "${CLAUDE_PLUGIN_ROOT}/template/" "video/<artikel-slug>/"
   cd "video/<artikel-slug>" && npm ci
   

   Speichere das genehmigte Skript als script.md in diesem Ordner.

5. Timeline bauen mit explainer-animation: setze src/settings.ts (articleTitle, voices, subtitles, targetSeconds, poster) und schreibe src/timeline.ts aus dem Skript. Füge maßgeschneiderte Komponenten hinzu, wenn das Skript welche markiert hat, jede mit ihrem frameState-Test.

6. Linten: npm run lint. Behebe jeden Befund (Länge, Untertitelgeschwindigkeit, unbekannte Komponente). Führe npm test auch aus, wenn eine Komponente hinzugefügt oder geändert wurde.

7. Faktencheck gegen den Artikel und schreibe factcheck.md (siehe oben).

8. Vertonen: npm run tts, dann npm run audio-qa (siehe narration). Höre alles an, was es markiert. Führe npm run lint erneut aus: echte Zeilenlängen ersetzen die Schätzungen.

9. Standbilder und deren Betrachtung. Rendere ein Standbild pro Szene plus eines alle ~3 s und lies jedes PNG. Überprüfe das Branding, die sicheren Bereiche, nichts läuft über, Zahlen stimmen mit dem Artikel überein, und Untertitel passen zum Takt auf dem Bildschirm. Ein sauberer Build ist kein Beweis dafür, dass ein Frame richtig aussieht.

10. Rendern: npm run render (vertikal EN). -- --es für den spanischen Schnitt, -- --landscape für 1920×1080. Dann führe npm run audio-qa erneut aus, um den Mix zu messen (-16 LUFS integriert).

11. Ausliefern: npm run deliver schreibt das Poster-PNG, die SRT und out/manifest.json. Betrachte das Poster. Übergib den MP4-Pfad und das Poster; die Veröffentlichung ist ein separater Schritt.

Erneutes Rendern eines vorhandenen Videos

Öffne seinen Ordner, führe npm ci aus, falls node_modules fehlt, ändere src/timeline.ts oder die Einstellungen, wiederhole dann ab Schritt 6. TTS vertont nur Zeilen neu, deren Text sich geändert hat.

Wo die Dinge hinkommen

• Quellcode (Timeline, Einstellungen, maßgeschneiderte Komponenten, script.md, factcheck.md) wird committet.
• out/, public/audio/, public/music/, node_modules/ und alle .mp4/.wav werden nicht committet.
• .env enthält den TTS-Schlüssel und wird weder committet noch ausgedruckt.