Communitygithub.com

motion-reel

Muestra a un agente cómo planificar, construir o editar un 'motion reel' para que el resultado concreto sea un video terminado. El procedimiento abarca Motion Reel (Demon Clips Studio), lo que el usuario espera cada vez (no hacer que pregunten) y el flujo de trabajo. Úsalo cuando una nueva tarea requiera esta habilidad.

¿Qué es motion-reel?

Esta habilidad especializa a un agente de IA (como Claude Code, Cursor o Codex) en la producción completa de un 'motion reel' (video promocional animado) para Demon Clips Studio. El proceso es 100% generado por código: usa Remotion para la parte visual, un pipeline de Python para el sonido y Edge TTS para locuciones en hindi. El agente aprende a seguir un flujo de trabajo estructurado: desde la ideación del formato y la creación de archivos de copia (con texto en roman hinglish y devanagari), hasta la composición de escenas con una biblioteca de movimientos predefinidos (péndulo, salto, deslizamiento, etc.), la sincronización de audio y video mediante archivos JSON de beats, y el renderizado final con un 'outro' específico para YouTube e Instagram. La habilidad enfatiza la entrega de un producto completo desde la primera iteración, evitando preguntas redundantes al usuario, y aplica un riguroso control de calidad (formato, sonoridad, presencia de audio, verificación de fotogramas clave) antes de reportar los archivos finales. Es útil para cualquier agente que necesite producir contenido de video promocional de alta calidad, consistente y con un estilo visual y sonoro único.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wearethedemon/motion-reel-skill/tree/HEAD

Preguntar en tu IA favorita

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

Documentación

Motion reel (Demon Clips Studio)

Cada píxel y cada sonido de estos reels está hecho en código: Remotion para la imagen, pipeline/synth.py para el sonido, Edge TTS o la grabación del usuario para la voz. La construcción de referencia es "Hecho en código": remotion/src/promo/MadeInCode.tsx, pipeline/promo.py, reels/261120-made-in-code/. Léelos antes de escribir un nuevo reel. Copia sus patrones, no su copia.

Trabaja dentro de D:\Claude-Chrome\wearethedemon\studio y sigue studio/CLAUDE.md (entorno, ruta de renderizado, unidad A: para archivos temporales, pregunta antes de descargar, confirma solo cuando se te pida, sin atribución a Claude).

Lo que el usuario espera cada vez (no hacer que pregunten)

El usuario es directo y se frustra cuando algo tiene que pedirse dos veces. Entrega todo a la primera:

  • Voz en off. Narración en hindi, sincronizada línea por línea con los beats. Usa la voz de IA (Edge TTS hi-IN-MadhurNeural) a menos que el usuario haya grabado la suya en el Grabador de Voz en off. Un reel con solo música fue devuelto con "¿sin voz en off?".
  • El outro añadido. Los archivos publicables son -ig.mp4 (Seguir) y -yt.mp4 (Suscribirse), con los propios efectos de sonido del outro y una sola banda sonora masterizada para el reel y el outro.
  • Ambos guiones. Roman Hinglish y Devanagari, así que 4 archivos: {roman,deva}-{ig,yt}.
  • Movimiento animado pero suave. Las cosas aparecen, vibran, pulsan y sobrepasan. Nada entrecortado o apresurado: da tiempo a los movimientos grandes (un pase de péndulo es de 1.5 s; 1 s fue "demasiado rápido y no suave"), y dale a cualquier movimiento rápido un rastro de desenfoque de movimiento.
  • Estilo de la casa: Paper Glass Lab. Cuadrícula pálida, vidrio blanco, rojo de canal #E5162D / #B80F22, tinta y blanco. Los interludios nocturnos (#0E0E12 más un brillo rojo) están permitidos para el ritmo, pero el usuario no los ha aprobado formalmente, así que mantenlos opcionales. Sin amarillo, sin emoji en el video, sin números falsos, sin insignias verificadas.
  • Afirmaciones honestas. Si el reel dice "cada sonido es código", lo es. El código en pantalla es la fuente real de este reel, y una prueba lo verifica.
  • Construye lo que te pidieron. Si piden X, no ofrezcas una versión más ligera y preguntes de nuevo.

Flujo de trabajo

1. Formato e idea

Si hay un reel de referencia, toma solo su formato: estructura, ritmo y tipos de movimientos. Nunca su guion, subtítulos o diseños. Escribe 5-8 beats, una línea cada uno: qué se mueve, qué texto aparece, qué sonido suena. Verifica cualquier hecho antes de que aparezca en el texto. Usa una tarjeta "Comentar PALABRACLAVE" solo con una entrega real en reward.md. Redacta ese archivo y márcalo como que necesita la aprobación del usuario; ellos envían los mensajes directos manualmente.

2. Carpeta y copia

Crea reels/<YYMMDD>-<slug>/ con:

  • copy.yaml:
    • handle, keyword, brand.
    • Un bloque roman: y un bloque deva: para el texto en pantalla.
    • Un bloque voice:: id, rate, lines: [{at, text, roman}]. text es Devanagari para el TTS, con palabras en inglés escritas como las dice una voz hi-IN (कोड, क्लॉड, एडिटर, डी एम). roman es lo que el usuario lee en el grabador.
  • reward.md: BORRADOR hasta que el usuario lo apruebe.
  • notes.md:
    • el comando de construcción y los archivos a publicar;
    • una lista de verificación antes de publicar y una sugerencia de marco de portada;
    • texto de publicación: un título de IG con un máximo de 5 hashtags, un título de YT de un máximo de 100 caracteres y una descripción con 3-5 hashtags.

3. Hoja de beats primero

Pon los tiempos de los beats en un archivo JSON, remotion/src/promo/<slug>.beats.json, en segundos.

  • Compartido: la composición y la mezcla de Python lo leen, lo que mantiene cada sonido en su fotograma.
  • Nombres: nombra los beats según lo que sucede (cut, wall, land[], reveal, stretch, toCard, keyword, brand, fadeOut).
  • Final: los últimos 0.4 s permanecen tranquilos y silenciosos, para que el bucle de vuelta al fotograma 0 sea limpio.
  • Duración: 25-30 s de reel, más el outro de 3.5 s.

4. Composición

Escribe remotion/src/promo/<Name>.tsx y regístralo en Root.tsx, con calculateMetadata tomando la duración de los beats.

  • Esquema: un esquema zod para cada pieza de copia (script: "roman" | "deva", líneas, tarjeta, marca, audio, fps). La copia roman es la predeterminada.
  • Tiempo: en segundos, a través de ../motion (seconds, springAt, ramp, wiggle, pulse, loop, stagger) y los springs en brand/tokens.ts (SPRING.ui 18/160/0.8, SPRING.stamp 11/220/0.7). Nunca conteos de fotogramas, para que cualquier fps funcione.
  • Kit: Backdrop, NightBackdrop, FitLine (ajusta una línea a un ancho), Card, Chip, Stamp, Rich, Phone, CaptionBar, SafeOverlay.
  • Texto:
    • Mantenlo dentro de la zona segura: x 60-950, y 250-1560. Nada que deba leerse mide menos de 34 px.
    • Los subtítulos en roman son Rajdhani en MAYÚSCULAS; las segundas líneas son Poppins 600 itálica en rojo.
    • El devanagari no va en mayúsculas. Necesita tamaños máximos más grandes (aproximadamente 148/120 contra 150/128 en roman, el pill 72 contra 64), lineHeight ≥ 1.25 y lang="hi".
  • Variedad: mezcla 4-6 movimientos del vocabulario a continuación, en un orden diferente cada reel. YouTube trata las plantillas repetidas como contenido no auténtico.

5. Sonido y voz

Ver "Sonido" más abajo. La música y los efectos de sonido van en un Bus en los tiempos de los beats. La música baja −9 dB y los efectos −5 dB bajo la voz. Luego viene el limitador, luego loudnorm a −14 LUFS. Cada línea de voz termina antes de que comience la siguiente.

6. Módulo de pipeline

pipeline/promo.py está conectado al reel Hecho-en-código (SLUG, COMPOSITION, BEATS_JSON, su music/sfx).

La primera vez que construyas un segundo reel, generalízalo en lugar de copiar el archivo:

  • Mueve las partes compartidas (load_copy, voiceover, soundtrack, _master, render, filmstrip, final) a un módulo que tome una configuración de reel: slug, id de composición, ruta de beats y las music(b) y sfx(b) de ese reel.
  • Mantén promo.py como una configuración delgada para Hecho en código, y dale a la CLI un --reel <slug>.
  • Haz lo mismo para el grabador: pipeline/recorder.py Project toma el slug, y pipeline record --reel <slug> funciona, para que la aplicación Grabador de Voz en off pueda grabar cualquier reel.

Mantén las pruebas pasando, y di en tu informe que hiciste este cambio.

7. Revisión de tira de fotogramas antes del renderizado completo

Renderiza fotogramas fijos de beats clave (6 por fila, --filmstrip) en A:\claude-workspace\screenshots\demon-studio\<slug>\ y revísalos tú mismo. Comprueba:

  • que el texto sea legible y esté dentro de la zona segura, y que el devanagari no sea demasiado pequeño;
  • que no haya momentos vacíos (una tarjeta en blanco durante 0.6 s se ve rota, así que comienza su texto dentro de aproximadamente 0.4 s);
  • que las últimas líneas largas no toquen los bordes, y que los efectos superpuestos estén alineados.

Corrige, vuelve a renderizar los fotogramas fijos, luego renderiza el video.

8. Renderizado, outro, archivos finales

Construye la mezcla, luego renderiza cada guion. final() entonces:

  • añade el outro de la plataforma: O.render_outro(platform, script, keyword=..., reward=...), con su tercer punto "Comentar PALABRACLAVE: reward";
  • une los dos videos y masteriza una banda sonora en ambos;
  • codifica H.264 CRF 18, BT.709 rango limitado, AAC 320k 48 kHz, +faststart.

9. Verifica, luego informa

  • Formato (ffprobe): 1080×1920, 30 fps, yuv420p, BT.709, AAC 48 kHz estéreo, duración = reel + outro.
  • Sonoridad: −14 ±1 LUFS y pico verdadero ≤ −1 dBTP en cada archivo final.
  • Audio presente: comprueba RMS por segundo con ffmpeg.
  • Fotogramas del outro: título, tarjeta, toque, Siguiendo/Suscrito, viñeta de palabra clave.
  • Pruebas: uv run python -m pytest -q pasa. Añade pruebas para el nuevo reel:
    • el código en pantalla es real;
    • los beats están en orden;
    • los props son válidos para ambos guiones;
    • cada línea de voz termina 0.05 s antes de la siguiente;
    • la banda sonora se reproduce con la duración completa con un silencio de los últimos 0.4 s;
    • la palabra clave tiene una recompensa.

Informa en lenguaje sencillo:

  • los 4 archivos a publicar, como enlaces;
  • el reel beat por beat, como una lista corta;
  • lo que comprobaste, y lo que no pudiste (no puedes escuchar, así que deberían reproducirlo);
  • decisiones abiertas: aprobación de recompensa, marco de portada.

Recuérdales que la vista previa de VS Code puede reproducir estos archivos en silencio ("¿por qué no hay audio?"). VLC, Windows Media Player o Chrome los reproducen correctamente.

Vocabulario de movimiento (código en MadeInCode.tsx)

Un objeto héroe impulsa el reel (la bola roja). Todo lo demás reacciona a dónde está, lo que da causa y efecto: la bola pasa, el texto aparece.

Trayectorias

  • Péndulo. ballAt: x = 540 − SWING·cos(t·TURN), y en el círculo de la cuerda (stringY), con TURN = π / pass y un pase de 1.5 s. PendulumString tiene una sombra suave y se ajusta al pivote después del corte.
  • Salto. hop(a, b, u, h) es una línea recta menos 4·h·u·(1−u): una parábola real con altura de vértice h. Encadena saltos por una escalera de puntos de aterrizaje. Suaviza el asentamiento final con Easing.out(Easing.back(1.5)).
  • Vuelo hacia una pared. Aceleración cuadrática, más un pequeño arco sin(u·π).
  • Deslizamiento. lensAt: Catmull-Rom a través de fotogramas clave, acelerando en el primer segmento y desacelerando en el último.
  • Rastro de desenfoque de movimiento. Trail: muestrea los últimos 0.09 s de la trayectoria y dibuja ceil(length / 5 px) círculos (como máximo 48) bajo un SVG feGaussianBlur, encogiéndolos y desvaneciéndolos hacia la cola (0.16·(1−k)^1.4). Las copias se superponen, por lo que se lee como un cometa, nunca como cuentas.

Texto

  • Barrido que sigue al objeto. SceneSwing/SwingText: cada subtítulo es una capa de fotograma completo recortada con clip-path: inset() en la x de la bola. El nuevo subtítulo se muestra detrás de la bola, el viejo delante de ella, y la dirección se alterna cada pase.
  • Sello al aterrizar. StackLine: la línea aparece con springAt(c, at, SPRING.stamp) exactamente en el beat de aterrizaje.

Impactos y vida

  • Aplastamiento y estiramiento. squashAt: durante 0.14 s después de un aterrizaje, sx += 0.3·sin y sy −= 0.26·sin, con transform-origin: 50% 100%. Un golpe de pared estira en la otra dirección.
  • Onda. Un anillo elíptico plano que crece desde el punto de contacto durante 0.45 s.
  • Explosión. 14 chispas y puntos, sembrados con random() para que los renders se repitan exactamente. Úsalo solo en el único momento grande (la palabra clave).
  • Vibración y pulso. wiggle(c, at, dur, hz, amp) sacude la rotación; pulse(c, at, dur, amount) aumenta la escala. Multiplica los pulsos juntos, y añade un pulso suave cada segundo al final para que la tarjeta siga respirando.
  • Brillo. Una barra de degradado blanco sesgada cruza el pill una vez.

Escenas

  • De claro a noche. La bola arrastra un panel NightBackdrop a través del papel. Su borde delantero es una línea inclinada (panelEdge/edgeX, inclinación suavizada 0 → 14° → −6°) usada para recortar la capa nocturna como un polígono.
  • De vuelta al papel. Corta de nuevo en un beat fuerte.
  • Zoom de cámara. 3-6 % por escena está bien, pero nunca en una escena con una lupa.

Enfoque y revelación

  • Bola a lupa. lensRadius/Lens: la bola se infla en un anillo rojo (spring), se llena de vidrio, crece un mango y se desliza sobre una capa de código gris mientras el resto se oscurece. Las palabras de revelación luego aparecen dentro del vidrio, y se cierra de nuevo en la bola (Easing.in(Easing.back(1.4))).
  • Aumento. Dentro del vidrio, dibuja la misma capa escalada por ZOOM (2.1) con transform-origin en el centro de la lupa. Si la capa base se mueve (un zoom de cámara), la copia ampliada se desvía de la alineación.
  • Código en pantalla. Proviene de code-lines.ts: líneas textuales del código fuente de este mismo reel, mantenidas sincronizadas por una prueba, resaltadas en color solo dentro de la lupa.

Morfismo de CTA

  • La forma. Morph construye un rectángulo redondeado a partir de tres springs: ancho sW, alto sH (más suelto, para que se tambalee) y tarjeta sC. w = 60 + 840·sW + 20·sC, h = hPill + 430·sC, y el radio pasa de pill a 52.
  • La secuencia. Bola → pill con el texto CTA deslizándose hacia arriba → vibración y brillo → tarjeta. La tarjeta contiene MessageCircle + "comenta karo", luego una palabra clave en itálica de 190 px estampada desde escala 1.7 a 1 con una explosión, luego la línea de publicación.
  • El final. Bloqueo de Brand (emblema, marca de palabra Anton, etiqueta mono), un fundido a noche, y un último 0.4 s fijo. Una marca de agua @handle permanece en la esquina superior izquierda durante todo el video.

Sonido (pipeline/synth.py, pipeline/audio.py)

S.Bus(seconds) es una línea de tiempo estéreo:

  • add(clip, at, gain_db, pan) coloca un clip.
  • mix(other, db) suma dos buses.
  • duck_under(key, depth_db) con sidechain atenuación bajo otro bus.
  • fade_out(start, end) y peak().

Lee cada vez del JSON de beats. La regla: cada beat visual tiene un sonido, y el movimiento rápido obtiene aire. Dale a cada whoosh su propio seed, y panea los sonidos pequeños ±0.15-0.7.

VisualSonidoGanancia dB
Paso rápido o vuelowhoosh(dur, lo, hi, peak, seed); con pico donde se mueve más rápido, paneado con la dirección−11 a −16
Extremos de paso, ticks de UItick(freq, dur)−24
Corte, chasquido de cuerdasnap() + riser(dur) hacia el próximo golpe−13 / −17
Gran golpe (pared, palabra clave)impact()−9 / −10
Aterrizajethud(150, 50, 0.4) + pop(900+80·i, 300), aumentando con cada aterrizaje−8 / −13
Se ilumina, completating(Hz): 1318.5, 1568, 1760, 2093, 2637−13 a −15
Inflar, estirar, transformarboing(f0, f1, dur)−10 a −14
Revelar, destello, brilloshimmer(base, gap)−13 a −22
Encoger, cerrarzip_down()−14
Vibraciónrattle()−13

Música a 120 BPM, La menor Am F C G, compases de 2 s (un pase de 1.5 s = 3 tiempos, por lo que el movimiento y la música se sincronizan).

  • pad por compás, más silencioso y oscuro donde el espectador lee o mira.
  • Un arpegio pluck Karplus-Strong en corcheas, dos octavas arriba.
  • kick en los acentos del movimiento y cuatro en el piso en la construcción.
  • hat y sub solo en las escenas nocturnas.
  • Un pad final bajo la marca de palabra.

Voz

  • Voz de IA: Edge TTS 7.3.1, hi-IN-MadhurNeural a +8 % (hi-IN-SwaraNeural es la opción femenina). Se almacena en caché en build/voice/, y solo se envía el texto del guion.
  • Voz propia: voiceover(mode="auto") prefiere la toma del grabador (audio/voice-take.json), luego audio/my-voice.* (una toma cortada en las pausas por pipeline/ownvoice.py), luego la voz de IA. --voice ai|own fuerza una.
  • Líneas: cada línea tiene 2-6 palabras y comienza en su beat. Mide cada clip: debe terminar ≥ 0.05 s antes de la siguiente línea, y la última antes de fadeOut. Acorta las palabras si no. Filtro pasa altos 80 Hz.

Skills relacionados