Communitygithub.com

video-promocional-diorama

Crea videos promocionales verticales 9:16 (Instagram Reels, TikTok, YouTube Shorts) al estilo 'miniature diorama' — mascotas de bloques de arcilla, pancarta de papel, marcador, subtítulos palabra por palabra, grano de cine y llamado a la acción — renderizados con Remotion desde un simple JSON.

¿Qué es video-promocional-diorama?

Esta habilidad genera videos promocionales cortos en formato vertical (1080×1920, 30 fps) con una estética viral de 'diorama en miniatura': un pequeño escenario con personajes de bloques que actúan escena por escena, mientras los subtítulos aparecen palabra por palabra. Todo se controla desde un único archivo `src/video.json` dentro de un proyecto Remotion. Es ideal para promocionar herramientas de IA, skills de Claude, prompts, aplicaciones, servicios o productos digitales. El flujo de trabajo incluye: obtener un brief (qué se promociona, CTA, idioma), escribir un guion estructurado en tabla de 9 a 12 escenas siguiendo un arco narrativo específico, construir el proyecto con un script automatizado, verificar una previsualización visual antes del render completo y sincronizar voz en off si está disponible. También permite 'reestilizar' videos existentes manteniendo la historia original pero reemplazando los elementos visuales. Soporta personalización de paletas de color (monocromático por defecto o cálido), tipos de escena y elementos como pancartas, cartas, listas y contadores. El resultado final es un archivo MP4 listo para subir a redes sociales, acompañado de un texto de publicación optimizado.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/uhandani/Skill-video-nocodealex/tree/HEAD/diorama-promo-video

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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 en theme.

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:

  1. 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 un overview.jpg. Si whisper funciona, word_timings.py es 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.
  2. 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.
  3. 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és con rewrite:false + stamp ("MITOS", "FALSO"), spotlight (una persona/la revelación) y cta para la llamada a la acción final.
  4. Escribe video.json con "voiceover" y un arreglo "captions" de {word,start,end} (segundos absolutos, en orden). El text de 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 mantenga start word|start word|… por escena y emita ambos es la forma menos propensa a errores. assets/examples/restyle_asal_usul_x.py es un ejemplo completo (un video explicativo en indonesio de 90 s sobre por qué el álgebra usa x, 16 escenas) — copia su estructura.
  5. 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, theme y characters en video.json. En mono todo se fuerza a escala de grises, por lo que un color personalizado de theme solo 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.

Skills relacionados