brand-video — konsistente, gestylte, gesichtslose Videos auf Abruf
Aufruf als /brand-video. Ein Befehl, viele Looks. Basiert auf dem validierten RestoreAssist-Lauf (9 Videos ausgeliefert). Wählt einen Stil aus styles.md, hält alles andere konstant, sodass die Ausgabe über mehrere Batches und Marken hinweg konsistent ist.
Eingaben (nur fragen, wenn nicht vorhanden; sinnvoll ableiten)
- brand — RestoreAssist / Synthex / DR / NRPG / CARSI / CCW / Unite oder ein Kunde. Legt Claims, CTA und Stimme fest.
- style — ein Schlüssel aus
styles.md(Standardflat-line). Dies ist der „Look“ / Dropdown-Wert. - topic(s) — ein Thema oder eine Liste für einen Batch (jeweils ein Video, parallel).
- voice —
ELEVENLABS_VOICE_ID(pro Marke; aus~/.hermes/.env). KRITISCH: Bestätigen Sie den aktuellen Wert vor der Generierung – der Benutzer ändert ihn. - upload? — Standard: nur rendern und bereitstellen. Upload zu YouTube (nicht gelistet) nur auf Anfrage.
Pipeline (pro Video – ein Slug-Ordner pro Video, niemals ein Verzeichnis teilen)
- Skript →
<slug>/script.md: ein sauberer VO-Absatz, ~120–140 Wörter, ~12–16 kurze Sätze (ein Satz = ein visueller Beat = ein Bild), Problem→Lösung→CTA. Behauptungen im Marken-Wiki verankern; niemals Funktionen erfinden. Enden mit der Marken-CTA-Zeile. - Voiceover → das gebündelte tts.py ausführen (liest
ELEVENLABS_API_KEY+ELEVENLABS_VOICE_ID+DIR):cd <workdir> && set -a && . ~/.hermes/.env && set +a && DIR=$PWD/<slug> python3 <skill>/pipeline/tts.pySchreibt<slug>/voiceover.mp3+<slug>/transcript.json(Beats). Die Beat-Anzahl notieren. - Bilder → eines pro Beat, Prompt = der POSITIVE-Token des gewählten Stils + eine konkrete Szene für diesen Satz + der NEGATIVE-Token des Stils, Querformat 16:9, gespeichert als null-aufgefüllte
<slug>/images/01.png ….- Produktion / Headless (Standard):
python3 <skill>/pipeline/image_gen.py "<prompt>" <out.png>— Geminigemini-2.5-flash-image(„Nano-Banana“) über HTTPS,GEMINI_API_KEYaus der Umgebungsvariable. Funktioniert serverseitig; Ende-zu-Ende validiert. Dies ist das, was App-Worker aufrufen (kein lokales MCP nötig). - Interaktiv (optional):
mcp__margot__image_generatebei Verwendung innerhalb einer Claude-Sitzung; Slug-präfigierte Dateinamen verwenden, um Kollisionen bei Parallelverarbeitung zu vermeiden (siehe [[parallel-agents-shared-output-collision]]).
- Produktion / Headless (Standard):
- Zusammenschnitt →
python3 <skill>/pipeline/stitch.py <slug>→<slug>/final-1080p.mp4(1920×1080@25, Bild-Timing basierend auf Beats). Endgültige Dauer mit der Voiceover-Dauer abgleichen.
Batches & neue Looks
- Batch: ein Unter-Agent pro Thema (parallel), jeder verwaltet seinen eigenen Slug-Ordner. Siehe den RestoreAssist-Lauf für die genaue Agent-Prompt-Form.
- Neu vertonen (Stimme geändert, gleiches Skript/Bilder): VO neu generieren, Dauer in
list.txtproportional zunew_total/old_totalskalieren, neu zusammenschneiden. (Neuvertonungsmuster.) - Look hinzufügen: einen Block an
styles.mdanhängen (positive/negative Token). Dieser Schlüssel wird sofort zu einem auswählbaren Stil – dieses Register IST die Datenquelle des Dropdowns.
Upload (YouTube, optional)
Browser-Datei-Upload ist tot (Host-Pfade werden abgelehnt). Verwenden Sie den YouTube-Data-API-Pfad, der in [[youtube-api-upload-restoreassist]] dokumentiert ist: Desktop-OAuth-Client → Token unter ~/.hermes/yt-restoreassist-token.json → videos().insert mit privacyStatus=unlisted, Kategorie 27, nicht für Kinder; Absicherung über Kanaltitel; idempotent über uploaded.json. Erfordert YouTube Data API v3, aktiviert im GCP-Projekt des OAuth-Clients.
Sicherheitsvorkehrungen
- Behauptungen müssen echt sein (Marken-Wiki / Produktwahrheit). Flache Illustration + synthetische Stimme → YouTube-KI-Offenlegung normalerweise „Nein“ (beim Upload bestätigen; auf „Ja“ umschalten, wenn KI-Musik hinzugefügt wurde).
- Pro Batch einen Stil beibehalten, um Konsistenz zu gewährleisten.
SKILL.md≤200 Zeilen halten, gemäß [[feedback-tight-code]]. - Referenzimplementierung + Assets:
/Users/phill-mac/restoreassist-videos/.