mshmsh03/video-xoshaka

Was macht video-xoshaka?

End-to-End-Videoproduktion: Interview, Briefing, Material, Designdatei, Skript, Storyboard, Voice, Bau, Musik, Prüfen, Ausliefern – mit Freigabeschleusen auf dem Weg. Ursprünglich als Skill für eine bestimmte Videoart entstanden, eine xoshaka (kurdisch für „der/die Lustige“) – eine Geschichte, die wie eine Mini-Doku erzählt und wie eine Meme-Seite witzelt. Dieser Stil ist noch immer einer von mehreren. Die gleiche Pipeline erstellt nun auch ernste Würdigungen, Produkt-Promos, Erklärvideos, Tutorials, Zusammenfassungen und Ankündigungen.

Was sie alle individuell aussehen lässt, ist echtes Material: der eigene Clip des Kunden, das Foto seines Freundes, seine tatsächlichen Websites und Apps, seine eigenen Worte aus Notizen, sein echtes Logo. Ein Video, das nach Stockmaterial aussieht, ist der Fehlerfall.

Was wann zu lesen ist

• references/brief.md: das Interview. Die Fragerunden, die Freitextfragen, Hinweise zu Sprache und Rechts-nach-links-Text, das Zusammenfassungsformat und wie brief.md gespeichert wird. Lies es zu Beginn jedes neuen Videos.
• references/storyboard-and-gates.md: die Vorlagen für design.md und STORYBOARD.md, die Freigabeschleusen, parallele Szenenbearbeiter und Frischeprüfungen. Lies es vor dem Schreiben des Skripts.
• references/styles.md: die Stile (lustige Geschichte, ernste Würdigung, Promo, Erklärvideo, Tutorial, Zusammenfassung, Ankündigung, nur Untertitel), die Form, den Ton, die Länge und die Musikstimmung jedes Stils sowie die Formate und die sicheren Zonen der Plattformen. Lies es direkt nach dem Briefing.
• references/story-and-comedy.md: Material finden und was privat bleibt, story.json schreiben, Bilder zeitlich auf Wörter abstimmen und das Comedy-Playbook (für den lustigen Stil).
• references/production.md: Projekteinrichtung, Komponenten, Formate, Screenshots, Überprüfung und bereits aufgetretene Fallstricke. Lies es vor dem Bau.
• references/music.md: HeyGen-Musikeinrichtung (einschließlich des Windows/WSL-Logins), einen Track auswählen, Ducking und Stille.
• references/toolbox.md: jedes Tool, Skill und CLI, das dieser Workflow verwendet, und wann du darauf zurückgreifen solltest: die Remotion-Skills, media-use, HeyGen, Kokoro, ElevenLabs, ffmpeg, Headless Chrome und die gebündelten Skripte.

Workflow

1. Die Person interviewen, dann das Briefing speichern

Die Antworten der Person bestimmen, was du baust, also frage, bevor du etwas anderes tust. Folge references/brief.md:

1. Runde 1, die Grundlagen (AskUserQuestion, bis zu 4 Fragen): Stil, wo es gepostet wird (bestimmt das Format), Länge, Stimme.
2. Runde 2, Look and Feel: Ton, was auf dem Bildschirm zu sehen ist (Fotos und Clips, Screenshots in Mockups, fetter Text und Grafiken, Karten oder Diagramme), Farben und Marke, Musik.
3. Runde 3, Material und Sicherheit: echte Namen oder nicht, Screenshots mit Namen oder nicht, Untertitel, das Ende.
4. Freitext-Runde, im Chat: der Punkt in einem Satz, die wahren Momente und Fakten, die eingebaut werden sollen, die ernste Zeile oder der genaue Call-to-Action, was vermieden oder nie gezeigt werden soll, wer wer ist, Referenzen, die der Kunde mag, und wo die Dateien sind.
5. Sprache: Wenn das Video nicht nur auf Englisch ist, frage nach der Sprache und prüfe die Unterstützung von Stimme und Textdarstellung (brief.md, „Sprache und rechts-nach-links-Text“).
6. Zusammenfassung und Bestätigung: wiederhole das Briefing als kurze Liste in den eigenen Worten des Kunden, frage „Noch etwas ändern?“, dann speichere es als brief.md im Projektverzeichnis.

Überspringe alles, was die Person bereits gesagt hat, empfehle für jede Frage einen Standardwert, passe die Optionen an den Stil an und frage nur das Nötigste. Wenn der Kunde sagt „Mach einfach“, frage nur Runde 1, liste deine Annahmen in der Zusammenfassung auf und überlasse die Stimme, wer genannt oder gezeigt werden darf und was privat ist, dem Kunden zur Entscheidung. Erstelle public/photos/ und teile die Dateinamen mit: me plus eine Person pro Person in der Geschichte. Videoclips und GIFs funktionieren auch.

brief.md ist der Vertrag. Jeder spätere Schritt folgt ihm. Wenn der Kunde seine Meinung ändert, aktualisiere zuerst brief.md, dann die Arbeit. Gib in der Auslieferungsnachricht an, wie das Ergebnis dem Briefing entspricht, und nenne, was davon abweicht.

Wenn der Kunde eine Geschichte („X hat mir gesagt, ich soll es kaufen, ich habe es mit meinem Freund Y gemacht“) oder eine Botschaft („Unser neues Menü einführen“) genannt hat, ist das die Grundlage. Alles andere kommt aus seinem Material.

2. Material sammeln

• Seine Notizen (Vault, Journal, Projektordner, Git-Verlauf): sende einen Recherche-Subagenten für eine datierte Zeitleiste, die Personen und Wendepunkte sowie eine Liste der privaten Dinge, die draußen bleiben sollen (story-and-comedy.md). Nichts Privates darf im Video landen.
• Seine Medien: sieh dir jeden Clip und jedes Foto selbst an. Überprüfe mehrere Bilder pro Clip auf Kennzeichen, Abzeichen und Bildschirme und entscheide über den Beschnitt (focusY). Frage, wer wer ist, wenn ein Clip mehr als eine Person zeigt.
• Seine Arbeit: Screenshots von Live-Seiten (Headless Chrome, Desktop und Handy) und vorhandene App-Screenshots in seinen Repos.
• Brand-Assets: sein echtes Logo, niemals nachgezeichnet (media-use resolve --type logo findet offizielle Marken), seine Farben und Schriftarten.
• Fakten für eine Promo oder ein Tutorial: jede Zahl, jeder Preis, jedes Feature und jeder Schritt stammen von der Person oder von etwas, das du überprüft hast. Erfinde keine Behauptungen.

3. Designdatei, Skript und Storyboard

Schreibe zuerst design.md (Palette, Schriftarten, Logo, Bewegungs- und Textregeln, aus dem Briefing und den echten Marken-Assets der Person; Vorlage in storyboard-and-gates.md). Schreibe dann story.json nach story-and-comedy.md und der Form des gewählten Stils in styles.md. Schreibe dann STORYBOARD.md: eine Zeile pro Szene mit der Zeile, was auf dem Bildschirm zu sehen ist, dem Ton und dem Wort, auf das jedes Bild fällt. Beginne mit einem Haken in den ersten zwei bis drei Sekunden. Schleuse: zeige der Person die Zeilen und die Storyboard-Tabelle und warte auf ein „Ja“, bevor du baust. Wörter zu ändern ist jetzt billig und später teuer. Frage die Person nach den wahren Geschichten hinter Witzen und nach der ernsten Zeile in ihren eigenen Worten, anstatt sie zu erfinden. Notiere, wo es gepostet wird: Reels, TikTok und Shorts benötigen höher platzierte Untertitel (styles.md, „Sichere Zonen“).

4. Stimme

Überspringe diesen Schritt für ein Video ohne Erzählung (dann tragen Untertitel die Worte). Generiere andernfalls Samples mit scripts/voice-samples.mjs, öffne den Ordner und lasse die Person nach Gehör auswählen (bm_george funktionierte gut für Comedy bei Geschwindigkeit 1.1; ruhigere Stimmen passen zu Würdigungen und Tutorials). Führe dann scripts/make-voice.mjs aus. Es gibt die Länge jeder Szene und eine Ausrichtungslinie „breaks“ aus. Gib die Wortzeitsteuerung aus und prüfe, ob kein Wort länger als eine Sekunde dauert (production.md, „Fallstricke“). Andere Sprachquellen sind in toolbox.md.

5. Vorschau früh öffnen

Sobald das Projekt läuft, starte Remotion Studio (npx remotion studio) und öffne die Vorschau, damit die Person zuschauen und lenken kann, während du baust. Rendere ein MP4, wenn der Kunde nach der Datei fragt oder wenn du ein Video zum Posten auslieferst; solange er noch iteriert, ist die Vorschau das Auslieferungsobjekt.

6. Bauen

Gerüst erstellen und die Vorlage und Skripte kopieren (production.md). Schreibe für jede Szene eine Komponente, normalerweise ein BeatScene mit Bildern, angepasst an assets/template/src/story/scenes/ (und an assets/examples/scenes/, wenn dieser Ordner existiert). Stimme jedes Bild zeitlich auf ein Wort mit wordAt(...) ab. Halte die Zeitleiste in StoryVideo.tsx einheitlich: Überblendungen, einen Slide plus Whoosh bei Kapitelwechseln. Setze die Kompositionsgröße auf das gewählte Format. Baue nach STORYBOARD.md und design.md, nicht aus dem Gedächtnis. Baue bei etwa fünf oder mehr unabhängigen Szenen parallel mit einem Subagenten pro Szene (storyboard-and-gates.md), setze dann zusammen und überprüfe die Nähte selbst. Verwende die Remotion-Skills für Remotion selbst (toolbox.md). Wenn der Kunde Code außerhalb des Chats bearbeitet hat, überschreibe ihn nicht; nimm an, dass es beabsichtigt war, oder frage nach.

7. Musik und Sound

Verwende echte Musik (music.md) in der Stimmung, die der Stil verlangt (styles.md). Installiere media-use und das HeyGen-CLI bei Bedarf, lasse den Kunden einloggen, suche ein paar Stimmungen, lade einen Haupttrack plus zwei Alternativen herunter, messe ihn, setze MUSIC_GAIN und plane um das natürliche Ende des Tracks herum. Soundeffekte nur dort, wo der Stil sie wünscht.

8. Prüfen, dann Freigabe zum Rendern einholen

• Betrachte Standbilder aller wichtigen Bilder und jedes Szenenendes (scripts/stills.mjs).
• Überprüfe Fakten bei Promos und Tutorials: jede Zahl, jeden Namen und jeden Schritt mit der Quelle.
• Vorschau-Schleuse: zeige die Studio-Vorschau oder die Schlüsselbilder und frage, was geändert werden soll. Rendere die endgültige MP4 erst, nachdem der Kunde die Vorschau genehmigt hat, oder wenn er ausdrücklich nach der Datei fragt.
• Rendere in eine neue versionierte Datei.
• Messe das Audio (scripts/check-audio.mjs).
• Überprüfe Bilder aus der finalen MP4 auf zeitkritische Aspekte.
• Öffne das Video für den Kunden.

9. Ausliefern

Berichte zurück:

• den Dateipfad, die Länge und Größe
• was sich geändert hat, falls es sich um ein Update handelt
• was du geprüft hast und dass du das Audio nicht hören konntest
• die offenen Fragen: wer wer ist, Musikstimmung, ob die Länge reduziert werden soll

Prinzipien

• Echt statt generisch. Ihr Clip, ihr Freund, ihre tatsächlichen Bildschirme und ihr Logo.
• Ton passt zum Zweck. Lustig ist eine Option. Ein Abschied, eine Produkteinführung und ein Tutorial brauchen jeweils ihren eigenen Ton; erzwinge keine Witze, wo sie nicht hingehören.
• Früh haken, eine Idee pro Szene. Der Punkt ist in den ersten zwei oder drei Sekunden sichtbar, und jede Szene verdient ihren Platz.
• Bilder fallen auf Wörter. Ein Bild, das auf seinem Wort ankommt, schlägt jede Anzahl zusätzlicher Effekte. Wenn nach „besser“ oder „lustiger“ gefragt wird, schärfe Timing und Wortwahl, bevor du die Lautstärke erhöhst.
• Ein zentraler Beat. Die ernste Zeile, der Call-to-Action oder die Kernbotschaft, klar ausgesprochen und mit Raum zum Wirken.
• Privatsphäre ist ein Feature. Ihre Notizen enthalten Dinge, die andere nicht sehen sollten. Der Kunde vertraut dir, diese ohne Aufforderung wegzulassen.
• Nicht über Menschen raten. Lass den Kunden die Erzählerstimme nach Gehör auswählen, niemals nach dem Namen. Bestätige, wer wer ist, in Gruppenclips. Erfinde keine Zitate, Gefühle oder Behauptungen, die das Material nicht stützt.
• Ehrliche Auslieferung. Sage, was du überprüft hast und was du nicht konntest (Audio nach Gehör). Wenn die Länge über das gewünschte Maß hinausgewachsen ist, sage es und nenne den einfachsten Schnitt.