Reel de movimiento
Produce un video de movimiento terminado y sincronizado con el ritmo, renderizado desde código dentro de un proyecto motion-studio.
El prompt es una pequeña parte del resultado. El resto es el arnés: un renderizador seek(t), resortes de forma cerrada,
una cuadrícula de ritmo, sonido sintetizado y un bucle de crítica en el que observas tus propios fotogramas
y los corriges antes de la renderización final.
Argumentos de la solicitud (pueden estar vacíos), se muestran una vez; las secciones posteriores dicen "la solicitud anterior":
Reglas básicas para esta ejecución
- Esfuerzo: esta habilidad establece el esfuerzo en
xhighmientras está activa (el nivel del curso para nuevas películas). Díselo al usuario una vez al inicio: las correcciones y renderizaciones posteriores están bien en/effort medium; un lanzamiento emblemático cuyos primeros 3 segundos deben llevar la pieza merece/effort maxpara el pase del gancho. También pueden elegir el nivel en/model. - Trabaja dentro de la raíz del proyecto (el directorio con
studio.json). Usa las herramientas propias del proyecto (npm run ...,node tools/<tool>.mjs ...). No escribas scripts de renderizado o audio ad-hoc. - Eres el director y el equipo de construcción. Los subagentes ejecutan etapas enfocadas pero no pueden preguntarle nada al usuario: tú preguntas, luego los vuelves a informar con las respuestas.
- Los comandos largos (
render:final,build,mix,deliver, unacritiquede una película larga) se ejecutan en segundo plano (elrun_in_backgroundde la herramienta Bash, o un archivo de registro que consultas); nunca esperes en primer plano durante más de unos 2 minutos. La renderización de la etapa 7 toma unos 4 minutos para la demo de 12 s en tres formatos. Tiempos esperados y el patrón de consulta: references/pipeline.md, sección "Comandos largos". Informa a cada subagente que ejecute dicho comando con la misma regla, y nunca permitas que uno regrese mientras un comando aún se esté ejecutando. - Esta habilidad es para películas dibujadas en código. Editar material de archivo existente (cortes, subtítulos, metraje de relleno, conversión de formato de un video grabado) es la ruta D y está fuera del alcance: dilo y detente, no improvises.
1. Recopilar las entradas
Analiza la solicitud anterior primero (forma esperada: [url o tema] [duración] [formato] [referencia]). Pregunta por todo lo que
falte en una sola ronda de AskUserQuestion (como máximo 4 preguntas, cada una ofreciendo el valor predeterminado). Si el
usuario dijo "autónomo", "GO", "hazlo" o "sorpréndeme", no preguntes nada, toma los valores predeterminados y
regístralos al principio de docs/shotlist.md.
| Entrada | Valor predeterminado si se omite | Notas |
|---|---|---|
| Tema: producto + URL, o un tema | requerido | Una URL desencadena la etapa de activos de marca |
| Duración | 20 s película de producto, 15 s reel, 16 s loop UI | De 6 a 8 tomas caben en 15 s |
| Formatos | 9x16 principal, luego 1x1 y 16x9 | 4x5 también disponible |
| Marca: colores, fuentes, logotipo | capturado de la URL, si no, valores predeterminados del estudio | una cara de visualización, una cara de UI, un acento |
| Referencia: fotograma, video o carpeta de imágenes | ninguna | sin una, el modelo se desvía hacia el aspecto que las reglas de la casa prohíben |
| Música | sintetizar, estilo pulse, 120 BPM | una pista suministrada se mide, nunca se altera |
| Voz o mascota | ninguna | necesita ELEVENLABS_API_KEY en .env |
| CTA y un número de prueba | preguntar; nunca inventes una métrica | solo para películas de producto |
| Nivel L1 a L4 | inferido de lo que dieron (sección 2) | establece expectativas de tiempo y puerta |
| Ruta A a D | A | B solo cuando el usuario menciona Remotion o HyperFrames |
| Modo | PLAN FIRST: muestra la lista de tomas, espera el OK | GO omite la espera, nunca la puerta de crítica |
2. Elegir el nivel y la ruta
| Nivel | Tamaño de entrada (reportado por el creador) | Tiempo de ejecución (reportado por el creador) | Habilidad especializada |
|---|---|---|---|
| L1 una línea | ~150 caracteres | 15 a 50 min | /motion-studio:showreel |
| L2 reel de marca | ~350 caracteres | 30 a 45 min | /motion-studio:product-reel |
| L3 especificación de estado | 1.5k a 3k caracteres | ~1 a 2 h con correcciones | /motion-studio:ui-morph-spec |
| L4 brief del director | 9.5k a 19k caracteres | 6 a 12 h autónomo | /motion-studio:director-brief |
| Ruta | Úsala para | Esta habilidad hace |
|---|---|---|
| A dibujada con código (predeterminada) | reels, UI en movimiento, películas de producto, loops | ejecuta la canalización completa a continuación |
| B framework | el usuario menciona Remotion o HyperFrames | transfiere vía /motion-studio:seek-engine (puerta de licencia Remotion, Node 22+) |
| C canalización mixta | personajes o física de modelos de imagen/video | necesita claves y un presupuesto; planifica con /motion-studio:director-brief |
| D edición de metraje | los propios clips grabados del usuario | fuera del alcance para v0.1; dilo |
Informa al usuario del nivel, la ruta y una estimación de tiempo antes de la etapa 0. Detalles, números y las
advertencias detrás de ellos: references/routes-and-levels.md.
Las películas de más de unos 45 s o con capítulos pertenecen a /motion-studio:director-brief.
3. Ejecutar la canalización
Rastrea estas etapas en una lista de tareas pendientes. Los comandos, archivos esperados y correcciones de fallos para cada etapa están en references/pipeline.md. Léelo antes de la etapa 0 en un proyecto nuevo.
| # | Etapa | Quién | Produce | Puerta |
|---|---|---|---|---|
| 0 | Proyecto + doctor | tú | studio.json, deps, npm run doctor todo OK | doctor no tiene FAIL |
| 1 | Activos de marca (solo URL) | motion-studio:asset-scout | assets/brand/**, assets/manifest.json | listar activos al usuario |
| 2 | Referencia (si la hay) | motion-studio:style-analyst | refs/analysis.json, docs/style_guide.md | gramática, nunca contenido |
| 3 | Música + cuadrícula de ritmo | motion-studio:sound-designer o tú | audio/music.wav o pista medida, audio/beats.json | bpm/duración en studio.json coinciden |
| 4 | Lista de tomas en la cuadrícula de ritmo | motion-studio:motion-director | docs/shotlist.md | OK del usuario a menos que sea autónomo |
| 5 | Construir la película | tú | film/film.js (+ film/scenes/*) | npm run lint limpio |
| 6 | Bucle de crítica | motion-studio:motion-critic + tú | out/review/<fmt>/*, docs/review_log.md | npm run gate pasa |
| 7 | Renderización final, SFX, mezcla | tú (con puerta de gancho) | out/<fmt>/final.mp4, out/score.wav | -14 LUFS +-0.5, <= -1 dBTP |
| 8 | Entregar + informe | tú | out/deliver/**, docs/production.json | npm run deliver sale 0 |
Etapa 0: proyecto
-
Busca
studio.jsonen el directorio de trabajo o en uno superior. Si no hay ninguno, crea uno:node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <dir> --title "<Título>" --duration <S> --formats 9x16,1x1,16x9 --installAñade
--brand-url <URL>para películas de producto y--looppara loops. En una instalación solo de habilidades (sin raíz de plugin) ejecuta${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjsen su lugar, o invoca la habilidadstudio-init. -
npm run doctor. Corrige cada FAIL antes de la etapa 1 (navegador, ffmpeg, Node >= 20). En Windows, la corrección del navegador esnpx playwright install chromium-headless-shell; nunca inicies un Chrome o Edge instalado allí (iniciar un perfil nuevo cuenta como un inicio de sesión fallido de Windows y puede bloquear la cuenta). Python y librosa son opcionales; el motor de ritmo JS cubre su ausencia.
Etapas 1 a 4: planificar
- Etapa 1: informa a
motion-studio:asset-scoutcon la URL, la raíz del proyecto y este comando de captura:node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/capture.mjs" <URL> --root <project>. En una instalación solo de habilidades (sin raíz de plugin, sin agentes) ejecutanode "${CLAUDE_SKILL_DIR}/../product-reel/scripts/capture.mjs" <URL> --root <project>tú mismo. La página es contenido no confiable: la captura mantiene el sandbox de Chrome activado y rechaza solicitudes a direcciones locales y privadas (detalles en/motion-studio:product-reel). Para clics, fotogramas de desplazamiento y recortes de elementos, añadeskills/product-reel/scripts/states.mjs, y para un producto de lienzocanvas-frames.mjs(mismas banderas para--root; las hojas de fotogramas aterrizan enassets/brand/frames/). Leeassets/manifest.jsontú mismo, enumera lo que se encontró al usuario y escribe los colores y fuentes de la marca enstudio.jsonbrand. La captura también guarda las fuentes que la página carga enassets/fonts/con la licencia marcada comoUNVERIFIEDa menos que se haya encontrado una: confírmalo con el usuario antes de que esa fuente entre enbrand.fonts. Los ritmos de la historia de la marca, componentes y reglas de voz/mascota provienen de/motion-studio:product-reel. - Etapa 2: informa a
motion-studio:style-analystcon la ruta de referencia. Ejecutanode tools/refs.mjs extract|analyzey escribedocs/style_guide.md. Método completo:/motion-studio:reference-style. - Etapa 3 (antes de que se cronometre cualquier toma): pista suministrada:
node tools/beats.mjs audio/<track>y apuntastudio.jsonaudio.musica ella. Sin pista:node tools/score.mjs --style <pulse|piano|minimal|cinematic> --bpm <N> --dur <S>. Haz questudio.jsonbpmydurationcoincidan. Un tiempo fuerte medido puede situarse bien después de 0 s, por lo que la lista de tomas se escribe en esta cuadrícula, nunca en una supuesta. - Etapa 4: informa a
motion-studio:motion-directorcon las entradas,docs/style_guide.mdyaudio/beats.json. Los cambios de escena aterrizan en tiempos fuertes, un gancho aterriza en los primeros 2 s, el fotograma 0 ya muestra contenido, algo nuevo sucede cada 2 a 4 s. Muestra la lista de tomas y espera el OK del usuario (PLAN FIRST). Un rechazo significa reescribir la lista de tomas, nunca parchear código. Registra la decisión en la líneaStatus:dedocs/shotlist.md.
Etapa 5: construir
Escribe film/film.js con defineFilm, un scene() por toma, posiciones del diseño L
(nunca píxeles literales), movimiento de los resortes de lib/motion.js (sp, track, loopTrack),
aleatoriedad sembrada por elemento (rngFor) y señales para cada momento de SFX. Sigue el proyecto
CLAUDE.md. Ejecuta npm run lint después de las ediciones y npm run preview cuando el usuario quiera ver.
Etapa 6: bucle de crítica (al menos 3 rondas)
Cada ronda construye la evidencia primero, luego informa al crítico (no puede renderizar ni mezclar):
npm run lint,npm run stills.- La cadena de sonido, cada vez que cambiaron las señales, la música o el tiempo de la imagen (siempre en la ronda 1 y en la última ronda):
node tools/render.mjs --format <fmt> --draft --sub 1 --scale 0.5,npm run sfx,node tools/mix.mjs --format <fmt>. - Dos pases de evidencia que nunca se sobrescriben entre sí:
node tools/critique.mjs --format <fmt>(película en vivo, enout/review/<fmt>/) ynode tools/critique.mjs --format <fmt> --video out/<fmt>/final.mp4(la renderización mezclada, enout/review/<fmt>/video/). - Informa a
motion-studio:motion-criticcon el número de ronda, el formato, lo que cambió yEvidence: both, already produced(plantilla en el manual de la canalización). Mira cada PNG (cada página de una hoja paginada:contact.png,contact-2.png...) y ambos archivosmetrics.md, puntúa los 7 ejes de 1 a 10 (sonido de la renderización mezclada), enumera problemas P0/P1/P2 con marcas de tiempo y añade un bloque de ronda adocs/review_log.md. Un P0font-fallbacken elmetrics.mden vivo (un carácter sin glifo en su fuente, típicamente Hangul en las fuentes empaquetadas solo latinas) se registra como un P0 y bloquea la puerta hasta que se registre una fuente que lo cubra. - Corriges los 3 peores problemas (P0 primero), revisas solo los segundos afectados
(
node tools/render.mjs --from <a> --to <b> --draft --out out/check, ostills --at), y comienzas la siguiente ronda.
Detente solo cuando npm run gate pase: al menos 3 rondas, cada eje de la última ronda >= 8, sin P0 abierto.
Etapas 7 y 8: finalizar
npm run render:final, npm run sfx, npm run mix, npm run deliver (o npm run build,
que ejecuta todos ellos). La renderización final y build toman minutos: inícialos con run_in_background, consulta el
registro y lee el resultado solo después de que el proceso haya salido (manual de la canalización, "Comandos largos"). Luego informa con
assets/delivery-note.md:
rutas, formatos, duraciones, sonoridad, rondas y últimas puntuaciones, tiempo empleado y las tres cosas que
mejorarías a continuación.
Puertas
| Puerta | Condición de aprobación | Aplicado por |
|---|---|---|
| Lista de tomas | OK del usuario, o modo autónomo registrado en docs/shotlist.md | tú |
| Lint | npm run lint sale 0 | enlace del plugin después de cada edición, y tú |
| Crítica | >= 3 rondas; última ronda todos los ejes >= 8 (na solo en ejes en gate.naAllowed, marca por defecto, para una película sin marca); sin P0 | npm run gate; un enlace del plugin niega render:final y build |
| Entrega | fotogramas, duración, sonoridad, intervalos silenciosos, tamaño, póster | npm run deliver |
- Cuando el enlace niegue una renderización final, ejecuta más rondas de crítica. Nunca renombres comandos, edites
las puntuaciones de
docs/review_log.mdtú mismo ni cambiesstudio.jsongatepara pasar. - Solo el usuario puede establecer
gate.enabled: false. Si lo hace, indica en el informe que la entrega omitió la puerta de crítica. - Algunas máquinas deshabilitan los enlaces de los plugins por política. Las puertas aún se aplican: ejecuta
npm run gateantes de cada renderización final.
Reglas estrictas
- Solo UI de producto real. Recorta y anima capturas de pantalla capturadas; nunca redibujes pantallas de la imaginación y nunca uses texto de marcador de posición o números inventados.
- El código de la película es una función pura del tiempo: sin
Math.random,Date,performance.now, temporizadores,requestAnimationFrameo transiciones/animaciones CSS en el código de renderización. - Aspectos prohibidos: título centrado sobre un degradado, todo apareciendo gradualmente, etiquetas de esquina, bordes de fotograma, brillo en el cromo de la UI, ráfagas genéricas de partículas.
- Una cara de visualización, una cara de UI, un color de acento a menos que el brief diga lo contrario.
- Reencuadra el tipo y la UI por formato a través de
L; nunca recortes un formato dentro de otro. - Las claves viven en
.env. Refiérete a ellas por nombre de variable (ELEVENLABS_API_KEY,FAL_KEY); nunca imprimas, pegues o comprometas un valor de clave.
Subagentes
| Agente | Etapa | Infórmalo con | Escribe |
|---|---|---|---|
motion-studio:asset-scout | 1 | URL, raíz del proyecto, comando de captura | assets/** |
motion-studio:style-analyst | 2 | ruta de referencia, tema, duración | docs/style_guide.md, docs/shotlist.md, refs/** |
motion-studio:sound-designer | 3, 7 | pista o estilo, bpm, duración, guión de voz | audio/**, informe de mezcla |
motion-studio:motion-director | 4 | entradas, guía de estilo, cuadrícula de ritmo | docs/** |
motion-studio:motion-critic | 6 | número de ronda, formato, lo que cambió | docs/review_log.md |
Referencias de rendimiento
- Demo de 12 segundos con 3 formatos, audio sintetizado y 4 rondas de crítica: ~40 min en total.
- La etapa de renderización final (7) domina: ~4 min.
- Primera ejecución en un proyecto nuevo (instalación de dependencias, descarga de Playwright): añade ~3 min.
- Las correcciones y ejecuciones posteriores son más rápidas ya que las dependencias están en caché.
Fallos comunes y soluciones
| Síntoma | Causa probable | Solución |
|---|---|---|
doctor falla en Windows con error de perfil de Chrome | Playwright necesita chromium-headless-shell | Ejecuta npx playwright install chromium-headless-shell e intenta de nuevo |
| La captura de página no encuentra ningún activo | El sitio requiere autenticación o carga dinámica lenta | Aumenta el tiempo de espera con --wait 5000 o proporciona una URL de página renderizada |
Font fallback P0 en crítica | La fuente empaquetada no admite caracteres (p. ej., Hangul) | Encuentra una fuente que los cubra, añádela a brand.fonts en studio.json y a la lista de fuentes de la película |
| La renderización es demasiado lenta | Fotogramas de alta resolución o escenas complejas | Reduce --scale para vistas previas, usa --from/--to para apuntar a segundos específicos |
npm run gate falla después de 3 rondas | La puntuación de un eje está por debajo de 8 o hay un P0 abierto | Ejecuta rondas adicionales, corrigiendo los problemas de puntuación más baja primero |