mrvijaykr56/youtubeshorts

YouTube-Shorts-Skript-Polierer & Storyboard-Regisseur

Dieser Skill führt den Agenten an, virale, hochgradig bindende YouTube-Shorts-Skripte zu erstellen und in strukturierte Storyboard-JSONs umzuwandeln, die mit der YTShorts-Rendering-Pipeline kompatibel sind.

---

1. Kernprinzipien der YouTube-Shorts-Bindung

1. Die 3-Sekunden-Hook-Regel:

   • Die erste Szene MUSS die Bildlaufunterbrechung mit einer Neugierde-Lücke, paradoxen Frage, kontraintuitiven Aussage oder einer Enthüllung mit hohem Einsatz erzwingen.
   • Schlecht: „Heute werden wir über Honig und seine Eigenschaften sprechen.“
   • Viral: „Wusstest du, dass Honig nie abläuft? 🍯 Wissenschaftler haben 3.000 Jahre alten Honig aus ägyptischen Gräbern gegessen!“

2. Tempo, Wortanzahl & der 2-Zeilen-pro-Szene-Standard 📜:

   • Szenenanzahl: 5 bis 6 Szenen.
   • 2 Zeilen pro Szene verpflichtend: Schreiben Sie niemals eine bloße 1-Zeilen-Szene. Jede Szene MUSS 2 ansprechende, beschreibende Satzzeilen haben (ca. 18–22 Wörter pro Szene).
   • Zieldauer: 95–110 Wörter insgesamt (~45–52 Sekunden). Einszenige Szenen enden zu schnell (~25s) und wirken unvollständig; 2 Zeilen pro Szene ermöglichen Charaktertiefe, sensorische Details und emotionale Handlungsauflösung, während die 60-Sekunden-Grenze für Shorts eingehalten wird.
   • 1 Szene = 2 Storylines = 1 kohärentes visuelles Bild (gehalten für 8–10 Sekunden mit dynamischer Ken-Burns-Bewegung).

3. Emoji-Injektion in Untertiteln:

   • Fügen Sie 1–2 kontextuell relevante Emojis in die Erzählung jeder Szene ein (z. B. 🏛️, 👑, ⚡, 💀).
   • Diese Emojis werden von der Untertitel-Styling-Engine (TikTok/Karaoke-Stil) für visuelle Effekte übernommen.

4. Strenge Sprachreinheit (Nur vollständiges Englisch ODER vollständiges Hindi) 🎙️:

   • Die gesprochene Erzählung muss zu 100 % reines Englisch ODER 100 % reines Hindi sein. Mischen Sie niemals englische Wörter oder Hinglish in Hindi-Erzählsätze.
   • Keine gesprochenen Emojis: Emojis sind ausschließlich für den visuellen Untertitel-Pop reserviert. Die TTS-Engine entfernt sie automatisch aus dem Audiostream, sodass Sprachmodelle niemals Emoji-Namen (z. B. „bittendes Gesicht“, „Glitzer“) vorlesen.

5. Standard-Untertitelstandards & zweisprachiges Setup 📺:

   • Position: Immer unten zentriert (Ausrichtung 2, MarginV=240), damit Untertitel sicher im unteren Drittel sitzen, ohne Charaktergesichter zu verdecken.
   • Schriftgröße: Verkleinerte, kompakte Schriftgröße (50px Basis), um die Leinwand sauber und lesbar zu halten.
   • Zweisprachige Shorts (Hindi-Stimme + Englische Untertitel): Fügen Sie immer sowohl "narration_hi" (gesprochen in 100 % reinem Hindi) als auch "narration" (angezeigt in englischen Untertiteln) ein.

6. Hoch-CTR virale Titelformel 💥:

   • Strukturieren Sie jeden Titel mit einem neugierig machenden Hindi-Hook, einem prägnanten englischen Untertitel und Ranking-Tags: [Emotionaler Hindi-Hook + Emoji] | [Prägnanter englischer Untertitel] | [Nischen-Tags #Shorts]
   • Beispiel: लालिची बंदर को मिली जादुई सीख! 🐒✨ Never Be Greedy | Hindi Kahaniya #Shorts
   • Beispiel: आसमान से गिरा एक जादुई तारा! 🐿️⭐ Cheeku's Magic Wish | Hindi Kids Story #Shorts

7. Nahtlose Schleife & vollständiges, inspirierendes Ende (Ziel >100 % APV) 🔄:

   • Konstruieren Sie Enden, die sauber, grammatikalisch vollständig und inspirierend sind.
   • 🚫 STRENGES VERBOT VON „NUR WIE…“ / „ठीक जैसे…“: Beenden Sie die Erzählung NIE mit nachlaufenden Vergleichsstämmen wie "just like…", "just like", "जैसे…" oder "ठीक जैसे…". Jeder letzte Satz MUSS vollständig aufgelöst, prägnant und in sich geschlossen sein.
   • Beispiel für den Anfang: „क्या आप जानते हैं कि एक जादुई बत्तख पूरे गांव को कैसे बदल सकती है? 🪺✨“
   • Beispiel für das Ende: „हमेशा याद रखें, सब्र और संतोष ही जीवन का सबसे बड़ा खजाना है! 🌟“ (Vollständige, inspirierende Botschaft).

8. Zielgruppen- & Wachstums-Metadaten-Payload 📈:

   • Fügen Sie immer in das Storyboard-JSON ein:
     • story_moral: Emotionale Moral auf Hindi (शिक्षा) zum Teilen durch die Eltern.
     • pinned_comment_question: Zum Nachdenken anregende Hindi-Frage, um die Kommentaraktivität zu steigern.
     • self_declared_made_for_kids: false (Allgemeines Publikum / familienfreundlich, um Kommentare und Benachrichtigungsglocken freizuschalten).

9. Top-10-Wettbewerber-SEO-Architektur (Verglichen mit Koo Koo TV, Infobells, PunToon Kids) 🏆:

   • Führende Hashtags: Platzieren Sie die hochfrequente Hashtag-Cloud ganz oben in der Beschreibung (z. B. #Shorts #HindiKahaniya #MoralStories #Panchatantra #KidsAnimation #3DAnimation #HindiCartoon #BalKahani).
   • 3-stufige Tag-Cloud (25–28 Tags):
     • Stufe 1 (Geschichte/Charakter): Exakte Charakternamen, Geschichtentitel, Englisch + transliteriertes Hindi (z. B. sone ka anda, golden goose story, lalchi kisan).
     • Stufe 2 (Nischen-Dach mit hohem Traffic): jadui kahaniya, hindi animated tales, hindi stories for kids, hindi story cartoon, moral stories in hindi, panchatantra stories, stories for kids, bedtime stories in hindi.
     • Stufe 3 (Zweischriftlich Devanagari): हिंदी कहानियां, पंचतंत्र की कहानियां, नैतिक कहानियां, हिंदी कार्टून, बाल कहानियां.
   • Kategorie: Erzwingen Sie immer Kategorie 1 (Film & Animation).

---

2. Charakter-DNA & Weltkonsistenz-Framework 👥🌍

Um sicherzustellen, dass die Bilder jeder Szene aus dem gleichen Film zu stammen scheinen:

1. Charakter-DNA-Anker: Wenn eine Geschichte Charaktere beinhaltet, definieren Sie einen unveränderlichen Charakter-Anker mit 5 festen Merkmalen:

   • Name & Alter/Statur: z. B. „Maya, 26-jährige sportliche Frau“
   • Haare & Augen: z. B. „zerzaustes lockiges dunkles Rabenhaar zu einem losen Pferdeschwanz gebunden, scharfe haselnussbraune Augen“
   • Charakteristisches Gesichtsmerkmal: z. B. „leichte Sommersprossen auf der Nase, entschlossener Gesichtsausdruck“
   • Markenkleidung: z. B. „abgenutztes olivfarbenes Leinen-Safarihemd, Messingkompass-Halskette, brauner Ledergürtel“
   • Niemals bloße Pronomen verwenden: Schreiben Sie NIE „sie betrachtet das Artefakt“ oder „ein Mädchen rennt“. Schreiben Sie immer: „Maya (26-jährige Frau mit lockigem dunklem Pferdeschwanz in olivfarbenem Safarihemd) untersucht das goldene Artefakt…“

2. Welt- & Umgebungsanker: Definieren Sie einen unveränderlichen Welt-Anker mit Umgebung, Beleuchtung und Palette:

   • Beispiel: „Antike unterirdische Sandsteingrabkammer, flackerndes bernsteinfarbenes Fackellicht, tiefe kobaltblaue Schatten, schwebende atmosphärische Staubpartikel, 35-mm-Filmkörnung.“
   • Jeder Szenen-Prompt MUSS diesen Welt-Anker übernehmen, sodass Beleuchtung, Farbtemperatur und Architektur zu 100 % vereinheitlicht bleiben.

3. Kamerafahrt- & Anti-Duplikationsregel (Keine redundanten Bilder) 🚫🔄:

   • Wiederholen Sie niemals Prompts: Aufeinanderfolgende Szenen dürfen NIEMALS identische Bildausschnitte, Handlungen oder Kamerawinkel teilen.
   • Erzwingen Sie eine dynamische Kamerafahrt:
     • Szene 1: Einrichtende Totale / Epischer Maßstab (Fesselt den Zuschauer mit der grandiosen Umgebung)
     • Szene 2: Mittlere Aktion / Entdeckung (Fokus auf das Subjekt oder den Charakter, der eine Handlung ausführt)
     • Szene 3: Extreme Makro-Nahaufnahme (Enthüllt komplizierte Textur, leuchtende Details oder eine wissenschaftliche Mikroansicht)
     • Szene 4: Über-die-Schulter / Hochspannungswinkel (Höhepunkt, Reaktion oder Enthüllung)
     • Szene 5+: Helden-Untersicht / Kinematografischer Höhepunkt (Auflösung und Handlungsaufforderung)

---

3. Storyboard-Typen & -Formate

Format A: Charaktergetriebene Geschichte / Erzählung (Mit Ankern)

{
  "character_anchor": "Maya, eine 26-jährige Archäologin, zerzaustes lockiges dunkles Rabenhaar im Pferdeschwanz, olivfarbenes Leinen-Safarihemd, Messingkompass-Halskette",
  "world_anchor": "Antike ägyptische unterirdische Sandsteingrabkammer, flackerndes bernsteinfarbenes Fackellicht, tiefe kobaltblaue Schatten, schwebende goldene Staubpartikel",
  "scenes": [
    {
      "scene_number": 1,
      "narration": "Tief unter der ägyptischen Wüste entdeckte Maya ein Grab, das 3.000 Jahre lang versiegelt war! 🏛️",
      "visual": "Maya (26-jährige Archäologin, lockiger dunkler Pferdeschwanz, olivfarbenes Leinenhemd) hält eine flackernde Bronzefackel, starrt ehrfürchtig auf eine hoch aufragende Steintür, bedeckt mit glühenden Hieroglyphen, Untersicht-Kinokamera, warmes bernsteinfarbenes Fackellicht, dramatisches Randlicht, 9:16 vertikaler Bildausschnitt, 8k-Auflösung"
    },
    {
      "scene_number": 2,
      "narration": "Im Inneren glühten drei unberührte Alabastergefäße im Fackellicht. 🍯",
      "visual": "Maya (26-jährige Archäologin, lockiger dunkler Pferdeschwanz, olivfarbenes Leinenhemd) kniet neben einem antiken Stein altar, untersucht drei transluzente goldene Honiggefäße, extreme Makro-Nahaufnahme, warmes bernsteinfarbenes Leuchten erhellt ihr Gesicht, volumetrisches Licht, 9:16 vertikal"
    }
  ]
}

Format B: Virale Tatsache / Erzählung (Standard)

Standardgeschichtenerzählung oder verblüffender Kurz-Fakt.

[
  {
    "scene_number": 1,
    "narration": "Was wäre, wenn Ihr Gehirn die Zukunft vorhersagen könnte, bevor Sie blinzeln? ⚡",
    "visual": "Extreme Nahaufnahme eines leuchtenden menschlichen Auges, neuronale Synapsen pulsieren mit elektrischem Cyan und magentafarbenem Blitz in der Iris, kinematografische Makrofotografie, geringe Schärfentiefe, 9:16 vertikaler Bildausschnitt, fotorealistisch 8k, dramatisches Randlicht"
  },
  {
    "scene_number": 2,
    "narration": "Wissenschaftler fanden heraus, dass Ihr Unterbewusstsein Entscheidungen 7 Sekunden trifft, bevor Sie es merken! 🧠",
    "visual": "Ein futuristischer Labor-MRT-Scanner visualisiert ein leuchtendes holografisches menschliches Gehirn mit feurig orangefarbenen neuronalen Bahnen, düstere Stimmungsästhetik, volumetrisches Licht, 8k-Auflösung"
  }
]

Format B: 2-Charakter-Dialog-Shorts

Wechselndes Gespräch zwischen zwei Charakteren (ideal für Interviews, Debatten oder Comedy).

[
  {
    "scene_number": 1,
    "speaker": "Gastgeber",
    "narration": "Du hast 50.000 Dollar für virtuelle Immobilien ausgegeben?! 🤯",
    "visual": "Modernes Podcast-Studio, lebendige neonviolette Hintergrundbeleuchtung, ausdrucksstarker junger Gastgeber, schockiert in die Kamera schauend, geringe Schärfentiefe, kinematografische Beleuchtung"
  },
  {
    "scene_number": 2,
    "speaker": "Gast",
    "narration": "Und ich habe es gestern für eine halbe Million Dollar verkauft! 📈💰",
    "visual": "Selbstbewusster junger Unternehmer lächelt in einem modernen Penthouse-Büro mit Blick auf die Skyline bei Sonnenuntergang, warme kinematografische Beleuchtung"
  }
]

Format C: Schritt-für-Schritt-Bildungs-Tutorial

Wird für folienbasierte Tutorials mit Titeln und Aufzählungspunkten verwendet.

[
  {
    "scene_number": 1,
    "step_title": "Einführung",
    "slide_title": "Python-Listen meistern",
    "bullets": [
      "Geordnete Sammlung von Elementen",
      "Definiert mit eckigen Klammern []",
      "Vollständig veränderbar und dynamisch"
    ],
    "code_snippet": "fruits = ['apple', 'mango']",
    "narration": "Hier sind 3 wesentliche Tricks, um Python-Listen in unter 30 Sekunden zu meistern! 🐍",
    "visual": "Schlanker 3D-Moderner Entwicklerarbeitsplatz, leuchtender Python-Code auf dem Monitor, minimalistischer Dunkelmodus-Studioästhetik"
  }
]

---

3. Visuelle Prompt-Technik für den KI-Bildgenerator

Das Feld "visual" jeder Szene MUSS als eigenständiger, hochauflösender Prompt entwickelt werden:

1. Aufnahmeart & Winkel: Makro extreme Nahaufnahme, Helden-Untersicht-Totale, Augenhöhe-kinematografisches Porträt, Vogelperspektive-atmosphärische Ansicht.
2. Subjekt & Aktion: Präzise physische Objekte, Charaktergesten, Gesichtsausdrücke.
3. Beleuchtung & Atmosphäre: Volumetrische göttliche Strahlen, Dramatisches Hell-Dunkel, Düsteres Cyber-Neon-Randlicht, Warmer Goldene-Stunde-Glanz.
4. Komposition & Qualität: 9:16 vertikaler Bildausschnitt, Schärfentiefe / Bokeh, Fotorealistisch 8k, Farbkorrigiertes kinematografisches Film-Still.
5. Negative Regeln: Schreiben Sie niemals „cool“, „schön“, „Text auf Bildschirm“, „Wasserzeichen“ oder generische, nicht-visuelle Begriffe.

---

4. Pre-Flight-Validator-Prüfung (Null-Token-Verschwendung-Garantie) 🛡️

Um Token-Verschwendung, fehlgeschlagene Durchläufe oder Videorenderfehler zu vermeiden, MUSS jedes Storyboard vor der Übergabe an den Benutzer und der Bildgenerierung die Validierung bestehen.

Sie können den integrierten Validator direkt ausführen:

.\backend\venv\Scripts\python.exe backend\scripts\storyboard_validator.py --json "path/to/script.json"

Validator-Regelsatz:

1. Szenenanzahl: 4 bis 9 Szenen (Ideal: 5–8 Szenen). Das Überschreiten von 10 Szenen wird blockiert.
2. Erzähldauer & -grenzwert: Die Gesamtwörterzahl muss zwischen 45 und 130 Wörtern liegen (~20s bis 55s). Das Überschreiten von 130 Wörtern wird blockiert, da es die 60-Sekunden-Grenze von YouTube-Shorts überschreitet.
3. Tempo pro Szene: 8 bis 16 Wörter pro Szene. Vermeidet Zeilenumbrüche in Untertiteln und Abschneiden auf Mobilbildschirmen.
4. TTS-Formatierungsintegrität: Entfernt unaussprechbare Markdown-Artefakte (**fett**, _kursiv_, [SFX-Notizen], # Überschriften), damit TTS niemals wörtliche Code-Token vorliest.
5. Untertitel-Emojis: Stellt die Integration von mindestens 1–2 Emojis für dynamische TikTok/Karaoke-Untertitel sicher.
6. Visuelle Prompt-Sicherheit & -Präzision:
   • Verbotener Token-Filter: Markiert Wörter wie text, letters, subtitles, words, watermark, font, logo, die dazu führen, dass Imagen verzerrte Textartefakte rendert.
   • Kompositionssignale: Erfordert explizite Kamerawinkel (Makro-Nahaufnahme, Totale, kinematografisches Porträt usw.).
   • Beleuchtungssignale: Erfordert explizite Beleuchtungshinweise (volumetrische Strahlen, Hell-Dunkel, goldene Stunde, Fackellicht usw.).

---

5. Obligatorische menschliche Genehmigungspforte 🛑

KRITISCHE REGEL: Generieren Sie niemals automatisch Bilder ohne explizite Benutzerfreigabe.

1. Sobald das Storyboard den Pre-Flight-Validator mit 0 blockierenden Fehlern besteht, präsentieren Sie dem Benutzer das saubere Storyboard und den Validierungsbericht.
2. Bitten Sie den Benutzer um Zustimmung:

   „Das Storyboard hat alle Pre-Flight-Prüfungen bestanden (Dauer: ~Xs, Szenen: N, Token-Sicherheit: 100 %). Stimmen Sie diesen Szenen und visuellen Anweisungen zu, oder möchten Sie vor der Bildgenerierung noch Anpassungen vornehmen?“

3. Warten Sie auf die Bestätigung des Benutzers, bevor Sie Bildgenerierungstools aufrufen.

---

6. Metadaten & SEO-Architektur der Top-10-Wettbewerber 🏆

Jeder generierte Short muss wettbewerbsvergleichende Metadaten enthalten, die direkt von Koo Koo TV (4,88 Mio. Abos), Infobells Hindi (72,8 Mio. Abos) und PunToon Kids (3,94 Mio. Abos) stammen:

1. Titelformulierung (Streng $

le 95$ Zeichen) YouTube lehnt Titel $ ge 100$ Zeichen ab. Verwenden Sie die bewährte Hoch-CTR-Formel: [Emotionaler Hook / Intrigierende Frage auf Hindi + 1-2 Emojis] [Englischer Name] | 3D Hindi Kahaniya #Shorts

• Beispiel: कुल्हाड़ी नदी में गिरी, जलपरी ने क्या दिया? 🪓✨ Honest Woodcutter | 3D Hindi Kahaniya #Shorts (92 Zeichen)
• Beispiel: रोज एक सोने का अंडा! पर लालच ने क्या किया? 🪺✨ Goose of Gold | 3D Hindi Kahaniya #Shorts (90 Zeichen)

2. Infobells Lea

…

[abgeschnitten für Übersetzung]