mrvijaykr56/youtubeshorts

Pulidor de Guiones para YouTube Shorts y Director de Storyboard

Este skill guía al agente en la creación de guiones virales de YouTube Shorts con alta retención y su conversión en un storyboard JSON estructurado, compatible con el pipeline de renderizado YTShorts.

---

1. Principios Fundamentales de Retención en YouTube Shorts

1. La Regla del Gancho de 3 Segundos:

   • La primera escena DEBE interrumpir el desplazamiento con una brecha de curiosidad, pregunta paradójica, declaración contraintuitiva o revelación de alto riesgo.
   • Malo: "Hoy hablaremos sobre la miel y sus propiedades."
   • Viral: "¿Sabías que la miel nunca caduca? 🍯 ¡Científicos comieron miel de 3.000 años de antigüedad de tumbas egipcias!"

2. Ritmo, Conteo de Palabras y el Estándar de 2 Líneas por Escena 📜:

   • Número de Escenas: 5 a 6 escenas.
   • Obligación de 2 Líneas por Escena: Nunca escribas una escena con una sola línea. Cada escena DEBE tener 2 líneas descriptivas y atractivas (aprox. 18–22 palabras por escena).
   • Duración Objetivo: 95–110 palabras en total (~45–52 segundos). Las escenas de una sola frase terminan demasiado rápido (~25s) y se sienten incompletas; 2 líneas por escena permiten profundidad de personaje, detalles sensoriales y resolución emocional de la trama, manteniéndose dentro del límite de 60 segundos de Shorts.
   • 1 escena = 2 líneas de historia = 1 imagen visual cohesiva (mantenida durante 8–10 segundos con movimiento dinámico Ken Burns).

3. Inyección de Emojis en Subtítulos:

   • Inserta 1–2 emojis contextualmente relevantes en la narración de cada escena (ej. 🏛️, 👑, ⚡, 💀).
   • Estos emojis son captados por el motor de estilo de subtítulos (estilo TikTok/Karaoke) para darle un toque visual.

4. Pureza Estricta del Idioma (Solo Inglés Completo o Hindi Completo) 🎙️:

   • La narración hablada debe ser 100% inglés puro O 100% hindi puro. Nunca mezcles palabras en inglés o Hinglish en oraciones de narración en hindi.
   • Sin Emojis Hablados: Los emojis están reservados exclusivamente para la aparición visual de subtítulos. El motor TTS los elimina automáticamente del flujo de audio para que los modelos de voz nunca lean los nombres de los emojis (ej. "pleading face", "sparkles") en voz alta.

5. Estándares de Subtítulos por Defecto y Configuración Bilingüe 📺:

   • Posición: Siempre Centro-Inferior (Alineación 2, MarginV=240) para que los subtítulos se ubiquen de forma segura en el tercio inferior sin ocultar los rostros de los personajes.
   • Tamaño de Fuente: Tamaño de fuente reducido y compacto (50px base) para mantener el lienzo limpio y legible.
   • Shorts Bilingües (Voz en Hindi + Subtítulos en Inglés): Incluye siempre tanto "narration_hi" (hablada en hindi 100% puro) como "narration" (mostrada en subtítulos en inglés).

6. Fórmula de Título Viral de Alto CTR 💥:

   • Estructura cada título con un gancho hindi de alta curiosidad, un subtítulo en inglés contundente y etiquetas de clasificación: [Gancho Hindi Emocional + Emoji] | [Subtítulo Inglés Impactante] | [Etiquetas de Nicho #Shorts]
   • Ejemplo: लालिची बंदर को मिली जादुई सीख! 🐒✨ Nunca Seas Codicioso | Hindi Kahaniya #Shorts
   • Ejemplo: आसमान से गिरा एक जादुई तारा! 🐿️⭐ El Deseo Mágico de Cheeku | Hindi Kids Story #Shorts

7. Bucle Perfecto y Final Inspirador Completo (Apuntando a >100% APV) 🔄:

   • Construye finales que sean limpios, gramaticalmente completos e inspiradores.
   • 🚫 PROHIBICIÓN ESTRICTA DE "JUST LIKE..." / "ठीक जैसे...": NUNCA termines la narración con frases de comparación como "just like...", "just like", "जैसे..." o "ठीक जैसे...". Cada oración final DEBE estar completamente resuelta, ser contundente y autónoma.
   • Ejemplo de Apertura: "¿Sabías que un pato mágico puede cambiar todo un pueblo? 🪺✨"
   • Ejemplo de Final: "¡Recuerda siempre, la paciencia y la satisfacción son el tesoro más grande de la vida! 🌟" (Enseñanza completa e inspiradora).

8. Carga Útil de Metadatos de Audiencia y Crecimiento 📈:

   • Incluye siempre en el JSON del storyboard:
     • story_moral: Moraleja emocional en hindi (शिक्षा) para compartir entre padres.
     • pinned_comment_question: Pregunta en hindi que provoca reflexión para impulsar una alta velocidad de comentarios.
     • self_declared_made_for_kids: false (Público General / Familiar para desbloquear comentarios y campanas de notificación).

9. Arquitectura SEO de los 10 Principales Competidores (Comparado con Koo Koo TV, Infobells, PunToon Kids) 🏆:

   • Hashtags Principales: Coloca una nube de hashtags de alto rendimiento justo al principio de la descripción (ej. #Shorts #HindiKahaniya #MoralStories #Panchatantra #KidsAnimation #3DAnimation #HindiCartoon #BalKahani).
   • Nube de Etiquetas de 3 Niveles (25-28 Etiquetas):
     • Nivel 1 (Historia/Personaje): Nombres exactos de personajes, títulos de historias, inglés + hindi transliterado (ej. sone ka anda, golden goose story, lalchi kisan).
     • Nivel 2 (Paraguas de Nicho de Alto Tráfico): 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.
     • Nivel 3 (Devanagari de Doble Escritura): हिंदी कहानियां, पंचतंत्र की कहानियां, नैतिक कहानियां, हिंदी कार्टून, बाल कहानियां.
   • Categoría: Siempre aplica Categoría 1 (Cine y Animación).

---

2. Marco de Consistencia de ADN de Personajes y Mundo 👥🌍

Para asegurar que las imágenes de cada escena parezcan pertenecer a la misma película exacta:

1. Anclaje de ADN del Personaje: Cuando una historia involucra personajes, define un Anclaje de Personaje inmutable con 5 rasgos fijos:

   • Nombre y Edad/Complexión: ej., "Maya, mujer atlética de 26 años"
   • Cabello y Ojos: ej., "cabello oscuro y crespo de cuervo recogido en una cola de caballo suelta, ojos color avellana penetrantes"
   • Rostro Distintivo: ej., "leves pecas en la nariz, expresión decidida"
   • Vestimenta Característica: ej., "camisa de safari de lino oliva desgastada, collar de brújula de latón, cinturón de cuero marrón"
   • Nunca Uses Pronombres Simples: NUNCA escribas "ella mira el artefacto" o "una niña corre". Siempre escribe: "Maya (mujer de 26 años con cola de caballo crespa oscura en camisa safari oliva) examina el artefacto dorado..."

2. Anclaje de Mundo y Entorno: Define un Anclaje de Mundo inmutable con escenario, iluminación y paleta:

   • Ejemplo: "Tumba de arenisca subterránea antigua, luz de antorcha ámbar parpadeante, sombras cobalto profundas, motas de polvo atmosférico flotantes, grano de película de 35 mm."
   • Cada prompt de escena DEBE heredar este anclaje de mundo para que la iluminación, temperatura de color y arquitectura permanezcan 100% unificadas.

3. Progresión de Toma y Regla Anti-Duplicación (Sin Visuales Redundantes) 🚫🔄:

   • Nunca repitas prompts: Las escenas consecutivas NUNCA deben compartir el mismo encuadre, acción o ángulos de cámara.
   • Aplica Progresión Dinámica de Toma:
     • Escena 1: Plano General Establecedor / Escala Épica (Engancha al espectador con el gran entorno)
     • Escena 2: Acción Media / Descubrimiento (Enfoque en el sujeto o personaje realizando una acción)
     • Escena 3: Primer Plano Macro Extremo (Revela texturas intrincadas, detalles brillantes o microvista científica)
     • Escena 4: Plano Sobre el Hombro / Ángulo de Alta Tensión (Clímax, reacción o revelación)
     • Escena 5+: Plano Heroico a Nivel de Suelo / Clímax Cinematográfico (Resolución y CTA)

---

3. Tipos y Formatos de Storyboard

Formato A: Historia Impulsada por Personajes / Narrativa (Con Anclajes)

{
  "character_anchor": "Maya, una arqueóloga de 26 años, cabello oscuro y crespo de cuervo recogido en una cola de caballo, camisa safari de lino oliva, collar de brújula de latón",
  "world_anchor": "Tumba subterránea de arenisca del Antiguo Egipto, luz de antorcha ámbar parpadeante, sombras cobalto profundas, motas de polvo dorado flotantes",
  "scenes": [
    {
      "scene_number": 1,
      "narration": "¡En las profundidades del desierto egipcio, Maya descubrió una tumba sellada durante 3.000 años! 🏛️",
      "visual": "Maya (arqueóloga de 26 años, cola de caballo crespa oscura, camisa de lino oliva) sosteniendo una antorcha de bronce parpadeante, mirando con asombro una puerta de piedra imponente cubierta de jeroglíficos brillantes, toma cinematográfica a nivel de suelo, cálida luz de antorcha ámbar, iluminación dramática de borde, encuadre vertical 9:16, resolución 8k"
    },
    {
      "scene_number": 2,
      "narration": "Dentro, tres vasijas de alabastro intactas brillaban bajo la luz de la antorcha. 🍯",
      "visual": "Maya (arqueóloga de 26 años, cola de caballo crespa oscura, camisa de lino oliva) arrodillada junto a un antiguo altar de piedra, inspeccionando tres frascos de miel dorada translúcida, macro primer plano extremo, cálido resplandor ámbar iluminando su rostro, iluminación volumétrica, vertical 9:16"
    }
  ]
}

Formato B: Dato Viral / Narrativa (Por Defecto)

Narración estándar o short de datos alucinantes.

[
  {
    "scene_number": 1,
    "narration": "¿Qué pasaría si tu cerebro pudiera predecir el futuro antes de que parpadees? ⚡",
    "visual": "Primer plano extremo de un ojo humano brillante, sinapsis neuronales pulsando con relámpagos eléctricos cian y magenta en el iris, macrofotografía cinematográfica, poca profundidad de campo, encuadre vertical 9:16, fotorrealista 8k, iluminación dramática de borde"
  },
  {
    "scene_number": 2,
    "narration": "¡Los científicos descubrieron que tu subconsciente toma decisiones 7 segundos antes de que te des cuenta! 🧠",
    "visual": "Escáner de resonancia magnética de laboratorio futurista visualizando un cerebro humano holográfico brillante con vías neuronales de color naranja ardiente, estética oscura y atmosférica, iluminación volumétrica, resolución 8k"
  }
]

Formato B: Short de Diálogo entre 2 Personajes

Conversación alternada entre dos personajes (ideal para entrevistas, debates o comedia).

[
  {
    "scene_number": 1,
    "speaker": "Anfitrión",
    "narration": "¿¡Gastaste $50,000 en bienes raíces virtuales!? 🤯",
    "visual": "Estudio de podcast moderno, luz de fondo neón púrpura vibrante, joven anfitrión expresivo mirando conmocionado a la cámara, poca profundidad de campo, iluminación cinematográfica"
  },
  {
    "scene_number": 2,
    "speaker": "Invitado",
    "narration": "Y lo vendí ayer por medio millón de dólares! 📈💰",
    "visual": "Joven emprendedor seguro sonriendo en una moderna oficina tipo ático con vista al horizonte al atardecer, cálida iluminación cinematográfica"
  }
]

Formato C: Tutorial Educativo Paso a Paso

Se usa para tutoriales basados en diapositivas con títulos y viñetas.

[
  {
    "scene_number": 1,
    "step_title": "Introducción",
    "slide_title": "Domina las Listas en Python",
    "bullets": [
      "Colección ordenada de elementos",
      "Definida con corchetes []",
      "Completamente mutable y dinámica"
    ],
    "code_snippet": "fruits = ['manzana', 'mango']",
    "narration": "¡Aquí tienes 3 trucos esenciales para dominar las listas de Python en menos de 30 segundos! 🐍",
    "visual": "Estación de trabajo de desarrollador 3D moderna y elegante, código Python brillando en el monitor, estética de estudio minimalista en modo oscuro"
  }
]

---

3. Ingeniería de Prompts Visuales para el Generador de Imágenes AI

El campo "visual" de cada escena DEBE diseñarse como un prompt independiente de alta fidelidad:

1. Tipo de Toma y Ángulo: Macro primer plano extremo, Plano general heroico a nivel de suelo, Retrato cinematográfico a la altura de los ojos, Vista aérea atmosférica.
2. Sujeto y Acción: Objetos físicos precisos, gestos de personajes, expresiones faciales.
3. Iluminación y Atmósfera: Rayos divinos volumétricos, Claroscuro dramático, Iluminación de borde cibernética neón atmosférica, Cálido resplandor de la hora dorada.
4. Composición y Calidad: Encuadre vertical 9:16, Profundidad de campo / bokeh, Fotorrealista 8k, Fotograma cinematográfico con gradación de color.
5. Reglas Negativas: Nunca escribas "cool", "bonito", "texto en pantalla", "marca de agua" o términos genéricos no visuales.

---

4. Verificación del Validador Prevuelo (Garantía de Cero Desperdicio de Tokens) 🛡️

Para evitar desperdicio de tokens, ejecuciones rotas o errores de renderizado de video, cada storyboard DEBE pasar la validación antes de la entrega al usuario y la generación de imágenes.

Puedes ejecutar el validador incorporado directamente:

.\backend\venv\Scripts\python.exe backend\scripts\storyboard_validator.py --json "ruta/al/script.json"

Conjunto de Reglas del Validador:

1. Número de Escenas: 4 a 9 escenas (Ideal: 5–8 escenas). Se bloquea si supera las 10 escenas.
2. Duración y Límite de Narración: El total de palabras debe estar entre 45 y 130 palabras (~20s a 55s). Se bloquea si supera las 130 palabras, ya que supera el límite de 60 segundos de YouTube Shorts.
3. Ritmo por Escena: 8 a 16 palabras por escena. Evita el ajuste de línea de subtítulos y el corte en pantallas móviles.
4. Integridad del Formato TTS: Elimina artefactos de markdown impronunciables (**negrita**, _cursiva_, [notas de SFX], # encabezados) para que el TTS nunca lea tokens de código literales.
5. Emojis de Subtítulos: Verifica que se hayan inyectado al menos 1–2 emojis para subtítulos dinámicos estilo TikTok/Karaoke.
6. Seguridad y Precisión del Prompt Visual:
   • Filtro de Token Prohibido: Señala palabras como text, letters, subtitles, words, watermark, font, logo que hacen que Imagen renderice artefactos de texto distorsionados.
   • Señales de Composición: Requiere ángulos de cámara explícitos (macro close-up, wide shot, cinematic portrait, etc.).
   • Señales de Iluminación: Requiere señales de iluminación explícitas (volumetric rays, chiaroscuro, golden hour, torchlight, etc.).

---

5. Puerta de Aprobación Humana Obligatoria 🛑

REGLAS CRÍTICAS: Nunca generes imágenes automáticamente sin la aprobación explícita del usuario.

1. Una vez que el storyboard pase el Validador Prevuelo con 0 errores bloqueantes, presenta el storyboard limpio y el informe de validación al usuario.
2. Pide la aprobación del usuario:

   "El storyboard ha pasado todas las comprobaciones previas al vuelo (duración: ~Xs, escenas: N, seguridad de tokens: 100%). ¿Apruebas estas escenas y direcciones visuales, o te gustaría hacer algún ajuste antes de que genere las imágenes?"

3. Espera la confirmación del usuario antes de llamar a cualquier herramienta de generación de imágenes.

---

6. Metadatos de los 10 Principales Competidores y Arquitectura SEO 🏆

Cada Short generado debe incluir metadatos comparados con la competencia aprendidos directamente de Koo Koo TV (4.88M suscriptores), Infobells Hindi (72.8M suscriptores) y PunToon Kids (3.94M suscriptores):

1. Formulación del Título (Estrictamente $\le 95$ Caracteres)

YouTube rechaza títulos $\ge 100$ caracteres. Usa la fórmula probada de alto CTR: [Gancho Emocional / Pregunta Intrigante en Hindi + 1-2 Emojis] [Nombre en Inglés] | 3D Hindi Kahaniya #Shorts

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

2. Infobells Lea*