Alexander-Kz/video-layer-skill

Was macht video-layer-skill?

Produktionsreifer Multi-Agent-Claude-Code-Skill – wandelt ein Voiceover-MP3 in eine vollständige Whiteboard-Erklärvideo-YouTube-Episode um. Festplatten-Brief + SHA256-Verifikation, gesteuerte 2-Wellen-Generierung, visuelle Review-Loops.

Funktionsweise

1. Eingabe: Ein Voiceover-MP3 (z. B. eine gesprochene Erklärung) wird an den Skill übergeben.
2. Brief-on-Disk: Ein Drehbuch oder Brief auf der Festplatte dient als Grundlage – dieser wird mittels SHA256-Hash auf Integrität und Unveränderlichkeit geprüft.
3. 2-Wave-Generierung:
   • Welle 1: Erzeugt die statischen Whiteboard-Elemente (Diagramme, Text, Konzepte) synchron zum Audio.
   • Welle 2: Animiert die Elemente passend zum Voiceover – Timing und Übergänge werden automatisch berechnet.
4. Visuelle Review-Loops: Eine Multi-Agent-Schleife prüft jede Szene auf visuelle Kohärenz, Korrektheit und Timing. Bei Abweichungen wird automatisch nachgebessert.
5. Export: Das fertige Video wird als MP4 für YouTube ausgegeben.

Voraussetzungen

• Claude Code (CLI oder API) mit Multi-Agent-Funktionen
• Python 3.10+ installiert
• Abhängigkeiten: ffmpeg, Pillow, numpy, shapely (z. B. über pip install -r requirements.txt)

Verwendung

# Führe den Skill mit einer MP3-Datei aus
claude execute skill video-layer-skill --input voiceover.mp3 --config brief_on_disk.md

Der Skill sucht nach der Datei brief_on_disk.md im Projektverzeichnis (oder im angegebenen Pfad). Bei erfolgreicher SHA256-Prüfung startet die Pipeline automatisch.

Konfiguration

Erstelle eine brief_on_disk.md mit folgendem Format:

# Video-Brief

**Titel**: Einführung in Quantencomputing
**Zielpublikum**: Anfänger
**Dauer**: 5 Minuten
**Inhalt**: Erkläre die grundlegenden Konzepte von Qubits, Überlagerung und Verschränkung anhand von Whiteboard-Animationen.

Die SHA256-Signatur kann mit dem Tool brief-verify aktualisiert werden:

brief-verify --update brief_on_disk.md

CLI-Referenz

Befehl	Beschreibung
--input	Pfad zur MP3-Datei
--config	Pfad zur Brief-Datei
--verify	SHA256-Prüfung überspringen (nicht empfohlen)
--export	Exportformat (Standard: mp4)

Fehlerbehebung

• SHA256-Fehler: Stelle sicher, dass die Brief-Datei nicht nach der Signierung geändert wurde. Verwende brief-verify --update, um die Signatur zu aktualisieren.
• Video ruckelt: Erhöhe die Bildrate im Export (z. B. --fps 30).
• Audio-Desync: Überprüfe die Länge des Voiceovers und passe die Animationsgeschwindigkeit an.

Lizenz

MIT License – siehe LICENSE für Details.