Video promocional diorama
Produce un video vertical de ~30–50 s (1080×1920, 30 fps) al estilo del reel viral
"5 Claudes roast your LinkedIn": un pequeño escenario con personajes de bloques que actúan
lo que hace un producto, escena por escena, mientras los subtítulos aparecen palabra por palabra. Todo se
controla desde un único archivo, src/video.json, en un proyecto Remotion creado a partir de
assets/template/.
Lee references/style-guide.md para entender por qué el formato funciona (ritmo, tipografía,
arco narrativo) y references/scene-types.md para cada campo JSON.
Flujo de trabajo
1. Obtén el brief (pregunta solo lo que falte)
- Qué se promociona y las cosas concretas que hace (resultados, números, pasos).
- Palabra clave de CTA que la gente comenta (por defecto
LINK) y si es gratuito. - Idioma de la voz en off / subtítulos — coincide con el usuario (solicitud en indonesio → guion en indonesio a menos que diga lo contrario). Las pancartas pueden permanecer en inglés si el usuario prefiere ese "look de IG".
- Voz en off: ¿tienen una grabación? Si no, el video igual funciona solo con subtítulos; ofrécete a escribir un guion que puedan grabar y luego sincronizarlo más tarde (paso 5).
- El "accesorio" en el escritorio (perfil, sitio web, currículum, tienda…) — existen valores predeterminados sensatos.
- Paleta: la escala de grises monocromática es la opción por defecto (
"palette": "mono"). Usa"warm"solo si el usuario pide color; los tokens individuales se pueden sobrescribir entheme.
2. Escribe el guion primero, como tabla
Sigue el arco narrativo de la guía de estilo: gancho → mecanismo → dolor → resultados → transformación →
recompensa → prueba → gratuito → fácil → CTA. 9–12 escenas, una oración cada una, ~2.7 palabras/s para que una
escena dure 2.5–4.5 s. Para cada escena elige un tipo de escena que muestre la oración
(una oración sobre "cinco opiniones" → lineup con cinco letreros y un contador automático).
Muestra la tabla (pancarta | voz en off | tipo de escena) al usuario y ajusta antes de construir —
cambiar una tabla es barato, volver a renderizar no lo es.
3. Construye el proyecto
bash <skill-dir>/scripts/new_video.sh <project-dir> # copia la plantilla + npm install
Luego escribe <project-dir>/src/video.json a partir del guion aprobado. Comienza desde el
ejemplo que ya está en ese archivo (recrea el reel de referencia) — manten su estructura.
Límites prácticos para mantener los diseños limpios: pancarta ≤ 30 caracteres, letreros de 1–2 palabras,
líneas de card ≤ ~25 caracteres y ≤ 7 líneas, list ≤ 4 elementos, ≤ 5 caracteres en hero.
4. Verifícalo visualmente antes del render completo
node <skill-dir>/scripts/preview_sheet.mjs <project-dir> # → out/sheet.jpg, un fotograma por escena
Mira la hoja (Lee la imagen). Verifica: la pancarta no está recortada, los subtítulos no cubren el
accesorio clave, los contadores muestran los números correctos, nada se desborda de la tarjeta. Arregla video.json
y vuelve a ejecutar. Esto toma segundos; un render completo toma minutos.
5. Sincronización de voz en off (cuando hay audio)
Coloca el audio en <project-dir>/public/ y ejecuta:
pip install faster-whisper # una vez, si falta
python3 <skill-dir>/scripts/word_timings.py <project-dir> voiceover.mp3 --lang id
Esto escribe las temporizaciones de palabras en video.json (captions, voiceover); los cortes de escena entonces caen
exactamente donde comienza cada oración. Música de fondo: colócala en public/ y establece
"music": "file.mp3" (volumen 0.12 por defecto). Sin audio, las temporizaciones se estiman a partir del texto.
6. Renderiza y entrega
bash <skill-dir>/scripts/render.sh <project-dir> out/video.mp4
render.sh recurre a un Chrome/Chromium local cuando Remotion no puede descargar su propio
navegador (común en entornos aislados). Un video de 45 s tarda unos minutos. Entrega el MP4 y
también escribe el texto de publicación siguiendo el patrón de referencia:
Comenta "LINK" y te envío por DM el enlace a … Comenta "LINK" para el enlace. #…
Para ajustes en vivo, el usuario puede ejecutar npx remotion studio dentro del proyecto.
Reestilizar un video existente
Cuando el usuario entrega un video y pide "en este estilo", conserva su historia y voz y reemplaza solo los elementos visuales:
bash <skill-dir>/scripts/caption_strips.sh <video> <work-dir>— extrae el audio (voiceover.m4a) y divide la banda de subtítulos cada 0.5 s con marcas de tiempo, además de unoverview.jpg. Si whisper funciona,word_timings.pyes más rápido; cuando no funciona (sin descarga del modelo), lee las tiras: la palabra resaltada en cada tira es la que se está diciendo en ese momento, lo que da temporizaciones de palabras con ±0.25 s. Verifica la posición de la banda en un fotograma de prueba primero — un recorte incorrecto muestra solo fragmentos de texto.- Divide la transcripción en bloques donde el video original cambia de imagen o tema (la vista general lo muestra). Un bloque = una escena, 3–8 s.
- Elige un tipo de escena que muestre cada bloque. Los videos explicativos se apoyan en
board(símbolos, "A → B", tachar respuestas incorrectas),timeline(fechas, personas),card(definiciones, citas, términos destacados),antes-despuésconrewrite:false+stamp("MITOS", "FALSO"),spotlight(una persona/la revelación) yctapara la llamada a la acción final. - Escribe
video.jsoncon"voiceover"y un arreglo"captions"de{word,start,end}(segundos absolutos, en orden). Eltextde cada escena debe contener exactamente las palabras de esa escena en orden — las escenas se sincronizan desde donde comienza su primera palabra. Un pequeño script de Python que mantengastart word|start word|…por escena y emita ambos es la forma menos propensa a errores.assets/examples/restyle_asal_usul_x.pyes un ejemplo completo (un video explicativo en indonesio de 90 s sobre por qué el álgebra usa x, 16 escenas) — copia su estructura. - Hoja de previsualización → arreglar → renderizar como de costumbre. Las pancartas pueden estar en el idioma del video.
Personalizar más allá del JSON
- Colores/reparto:
palette,themeycharactersenvideo.json. Enmonotodo se fuerza a escala de grises, por lo que un color personalizado dethemesolo importa por su luminosidad. - Nuevo efecto visual: agrega un tipo de escena (pasos al final de
references/scene-types.md). - Anima solo con
useCurrentFrame()+interpolate/spring; las transiciones/animaciones CSS no se renderizan en Remotion. Mantén y 1440–1620 libre para subtítulos.
Originalidad
Las mascotas, el escenario y los accesorios de la plantilla son genéricos y originales. Mantenlo así: no copies personajes, logotipos ni material de otro creador en el video; los nombres de marcas reales pueden aparecer como texto (ej. "LinkedIn") al describir con qué funciona el producto.