Communitygithub.com

yazzang-homelab/motion-studio

Crea un video de lanzamiento, reel de producto o aplicación, anuncio explicativo o anuncio animado desde código, de principio a fin: activos de marca desde una URL, lista de tomas sincronizada con el ritmo, sonido sincronizado, bucle de crítica, todos los formatos.

¿Qué es motion-studio?

Motion Studio es una habilidad de agente de IA de código abierto que permite a los desarrolladores crear videos profesionales animados y sincronizados con el ritmo directamente desde el código, sin necesidad de un editor de video tradicional. Es ideal para demostraciones de productos, reels de aplicaciones, videos explicativos y loops de UI. La habilidad orquesta un flujo de trabajo completo de 8 etapas: configuración del proyecto, extracción de activos de marca desde una URL, análisis de referencias de estilo, síntesis de música y detección de ritmo, planificación de tomas, escritura del código de la película con muelles animados, un bucle de crítica automatizado que revisa cada fotograma y corrige problemas, y finalmente la renderización y entrega en múltiples formatos (9x16, 1x1, 16x9). Funciona en entornos como Claude Code, Cursor y Codex, utilizando Node.js y herramientas de línea de comandos. El bucle de crítica garantiza la calidad al puntuar la película en 7 ejes y rechazar la renderización final hasta que se apruebe una puerta de calidad. La habilidad impone reglas estrictas: el código de la película debe ser una función pura del tiempo (sin aleatoriedad), no se permiten redibujos imaginativos de la UI, y los activos de marca deben capturarse directamente de una URL.

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

Preguntar en tu IA favorita

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

Documentación

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 xhigh mientras 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 max para 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, una critique de una película larga) se ejecutan en segundo plano (el run_in_background de 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.

EntradaValor predeterminado si se omiteNotas
Tema: producto + URL, o un temarequeridoUna URL desencadena la etapa de activos de marca
Duración20 s película de producto, 15 s reel, 16 s loop UIDe 6 a 8 tomas caben en 15 s
Formatos9x16 principal, luego 1x1 y 16x94x5 también disponible
Marca: colores, fuentes, logotipocapturado de la URL, si no, valores predeterminados del estudiouna cara de visualización, una cara de UI, un acento
Referencia: fotograma, video o carpeta de imágenesningunasin una, el modelo se desvía hacia el aspecto que las reglas de la casa prohíben
Músicasintetizar, estilo pulse, 120 BPMuna pista suministrada se mide, nunca se altera
Voz o mascotaningunanecesita ELEVENLABS_API_KEY en .env
CTA y un número de pruebapreguntar; nunca inventes una métricasolo para películas de producto
Nivel L1 a L4inferido de lo que dieron (sección 2)establece expectativas de tiempo y puerta
Ruta A a DAB solo cuando el usuario menciona Remotion o HyperFrames
ModoPLAN FIRST: muestra la lista de tomas, espera el OKGO omite la espera, nunca la puerta de crítica

2. Elegir el nivel y la ruta

NivelTamaño de entrada (reportado por el creador)Tiempo de ejecución (reportado por el creador)Habilidad especializada
L1 una línea~150 caracteres15 a 50 min/motion-studio:showreel
L2 reel de marca~350 caracteres30 a 45 min/motion-studio:product-reel
L3 especificación de estado1.5k a 3k caracteres~1 a 2 h con correcciones/motion-studio:ui-morph-spec
L4 brief del director9.5k a 19k caracteres6 a 12 h autónomo/motion-studio:director-brief
RutaÚsala paraEsta habilidad hace
A dibujada con código (predeterminada)reels, UI en movimiento, películas de producto, loopsejecuta la canalización completa a continuación
B frameworkel usuario menciona Remotion o HyperFramestransfiere vía /motion-studio:seek-engine (puerta de licencia Remotion, Node 22+)
C canalización mixtapersonajes o física de modelos de imagen/videonecesita claves y un presupuesto; planifica con /motion-studio:director-brief
D edición de metrajelos propios clips grabados del usuariofuera 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.

#EtapaQuiénProducePuerta
0Proyecto + doctortústudio.json, deps, npm run doctor todo OKdoctor no tiene FAIL
1Activos de marca (solo URL)motion-studio:asset-scoutassets/brand/**, assets/manifest.jsonlistar activos al usuario
2Referencia (si la hay)motion-studio:style-analystrefs/analysis.json, docs/style_guide.mdgramática, nunca contenido
3Música + cuadrícula de ritmomotion-studio:sound-designer o túaudio/music.wav o pista medida, audio/beats.jsonbpm/duración en studio.json coinciden
4Lista de tomas en la cuadrícula de ritmomotion-studio:motion-directordocs/shotlist.mdOK del usuario a menos que sea autónomo
5Construir la películatúfilm/film.js (+ film/scenes/*)npm run lint limpio
6Bucle de críticamotion-studio:motion-critic + túout/review/<fmt>/*, docs/review_log.mdnpm run gate pasa
7Renderización final, SFX, mezclatú (con puerta de gancho)out/<fmt>/final.mp4, out/score.wav-14 LUFS +-0.5, <= -1 dBTP
8Entregar + informetúout/deliver/**, docs/production.jsonnpm run deliver sale 0

Etapa 0: proyecto

  1. Busca studio.json en 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 --install
    

    Añade --brand-url <URL> para películas de producto y --loop para loops. En una instalación solo de habilidades (sin raíz de plugin) ejecuta ${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjs en su lugar, o invoca la habilidad studio-init.

  2. npm run doctor. Corrige cada FAIL antes de la etapa 1 (navegador, ffmpeg, Node >= 20). En Windows, la corrección del navegador es npx 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-scout con 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) ejecuta node "${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ñade skills/product-reel/scripts/states.mjs, y para un producto de lienzo canvas-frames.mjs (mismas banderas para --root; las hojas de fotogramas aterrizan en assets/brand/frames/). Lee assets/manifest.json tú mismo, enumera lo que se encontró al usuario y escribe los colores y fuentes de la marca en studio.json brand. La captura también guarda las fuentes que la página carga en assets/fonts/ con la licencia marcada como UNVERIFIED a menos que se haya encontrado una: confírmalo con el usuario antes de que esa fuente entre en brand.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-analyst con la ruta de referencia. Ejecuta node tools/refs.mjs extract|analyze y escribe docs/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 apunta studio.json audio.music a ella. Sin pista: node tools/score.mjs --style <pulse|piano|minimal|cinematic> --bpm <N> --dur <S>. Haz que studio.json bpm y duration coincidan. 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-director con las entradas, docs/style_guide.md y audio/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ínea Status: de docs/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):

  1. npm run lint, npm run stills.
  2. 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>.
  3. Dos pases de evidencia que nunca se sobrescriben entre sí: node tools/critique.mjs --format <fmt> (película en vivo, en out/review/<fmt>/) y node tools/critique.mjs --format <fmt> --video out/<fmt>/final.mp4 (la renderización mezclada, en out/review/<fmt>/video/).
  4. Informa a motion-studio:motion-critic con el número de ronda, el formato, lo que cambió y Evidence: 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 archivos metrics.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 a docs/review_log.md. Un P0 font-fallback en el metrics.md en 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.
  5. Corriges los 3 peores problemas (P0 primero), revisas solo los segundos afectados (node tools/render.mjs --from <a> --to <b> --draft --out out/check, o stills --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

PuertaCondición de aprobaciónAplicado por
Lista de tomasOK del usuario, o modo autónomo registrado en docs/shotlist.mdtú
Lintnpm run lint sale 0enlace 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 P0npm run gate; un enlace del plugin niega render:final y build
Entregafotogramas, duración, sonoridad, intervalos silenciosos, tamaño, pósternpm 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.md tú mismo ni cambies studio.json gate para 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 gate antes 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, requestAnimationFrame o 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

AgenteEtapaInfórmalo conEscribe
motion-studio:asset-scout1URL, raíz del proyecto, comando de capturaassets/**
motion-studio:style-analyst2ruta de referencia, tema, duracióndocs/style_guide.md, docs/shotlist.md, refs/**
motion-studio:sound-designer3, 7pista o estilo, bpm, duración, guión de vozaudio/**, informe de mezcla
motion-studio:motion-director4entradas, guía de estilo, cuadrícula de ritmodocs/**
motion-studio:motion-critic6nú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íntomaCausa probableSolución
doctor falla en Windows con error de perfil de ChromePlaywright necesita chromium-headless-shellEjecuta npx playwright install chromium-headless-shell e intenta de nuevo
La captura de página no encuentra ningún activoEl sitio requiere autenticación o carga dinámica lentaAumenta el tiempo de espera con --wait 5000 o proporciona una URL de página renderizada
Font fallback P0 en críticaLa 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 lentaFotogramas de alta resolución o escenas complejasReduce --scale para vistas previas, usa --from/--to para apuntar a segundos específicos
npm run gate falla después de 3 rondasLa puntuación de un eje está por debajo de 8 o hay un P0 abiertoEjecuta rondas adicionales, corrigiendo los problemas de puntuación más baja primero

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

yazzang-homelab/motion-studio

Make Claude watch its own frames: critique.mjs evidence, harsh 7-axis scores, timestamped P0/P1/P2 problems in docs/review_log.md, fix the 3 worst, re-check, pass the gate. Use for 'critique it', 'review the frames', 'is it good'.

yazzang-homelab/motion-studio

Plan long-form or overnight films: director's brief (PLAN FIRST or GO, budget, definition of done), ANIMATION_GUIDE + STORYBOARD, chapter subagents, gates, chunked render. Use for 'overnight film', 'music video', '2-minute film'.

yazzang-homelab/motion-studio

Brand-asset stage of a product film (motion-reel runs the whole film): capture real screenshots, logo, colors and fonts from a URL, never redraw UI; brand story beats; voice + mascot. Use to grab or fix a brand's assets.

yazzang-homelab/motion-studio

Turn a reference (a frame, a video or an image library) into docs/style_guide.md and a beat-grid shot list: measure cuts, palette and pace, take grammar not content, wait for OK. Use when the user supplies or names a look.

yazzang-homelab/motion-studio

Build, debug or speed up the seek(t) render engine: render contract, canvas vs page capture, workers/subframes/chunks, determinism fixes, Remotion or HyperFrames handoff. Use for 'render is slow', 'frames differ', 'use Remotion'.

yazzang-homelab/motion-studio

Ship every format from one timeline, then package it: layout() reframing (never crop), render all formats, per-format checks, deliver.mjs, a brand skill, a service offer. Use for 'export 9:16 and 16:9', 'deliver', 'make a skill'.

yazzang-homelab/motion-studio

The viral one-line 'showreel for a résumé' prompt: why it works (anatomy), the credited quote, and seeded variants that avoid look-alike reels; runs it as an engine test. Use for that prompt, its variations, or a showreel.

yazzang-homelab/motion-studio

Score a film to its beat grid: measure a track (beats.mjs) or synthesize one (score.mjs), cue SFX from the film, add voice, mix to -14 LUFS / -1 dBTP at exact length. Use for 'add music', 'sync to the beat', 'SFX', 'loudness'.

yazzang-homelab/motion-studio

Make motion feel physical with closed-form springs from lib/motion.js: presets, springFromFeel, track() for multi-target values, loopTrack loops, indicators, text swaps. Use for 'feels linear', 'add bounce', 'easing to springs'.

yazzang-homelab/motion-studio

Scaffold a motion-studio film project (seek(t) renderer, springs, beat grid, synthesized sound, critique tools), install it, set up the browser, run doctor. Use for 'set up the motion studio', 'new film project', 'init studio'.

yazzang-homelab/motion-studio

Write a six-part XML state spec for a one-shape UI morph film (inputs, direction, structure, build, gotchas, start): states on downbeats, cursor-driven changes, seamless loop, approval gate. Use for 'UI morph', 'state list'.

Skills relacionados