Communitygithub.com

yazzang-homelab/motion-studio

Planifica películas largas o nocturnas: brief del director (PLAN FIRST o GO, presupuesto, definición de terminado), GUÍA DE ANIMACIÓN + STORYBOARD, subagentes por capítulo, compuertas, renderizado en fragmentos. Útil para 'película nocturna', 'videoclip', 'película de 2 minutos'.

¿Qué es motion-studio?

Este skill está diseñado para la producción de películas de larga duración (por ejemplo, videoclips nocturnos o cortometrajes de 2 minutos) con un proceso estructurado de principio a fin. A diferencia del formato más corto (`motion-reel`), este skill transforma una idea del usuario en un brief de director completo que incluye logline, referencias, herramientas, presupuesto, una guía de animación y un storyboard detallado. La producción se divide en capítulos de 8 a 30 segundos, cada uno gestionado por un subagente especializado (`chapter-animator`) que escribe su propio código de animación. El flujo está controlado por ocho compuertas (gates) que van desde la creación de los documentos de planificación hasta el renderizado final, pasando por la revisión de animáticas, la crítica con el bucle de retroalimentación y la sincronización de audio. Está diseñado para plataformas que soportan el ecosistema de `motion-studio` (como Remotion/HyperFrames) y permite modos de trabajo PLAN FIRST (detenerse tras el plan para aprobación) o GO (continuar directamente). El skill maximiza el uso de tokens y razonamiento profundo (esfuerzo `max`) para minimizar errores de planificación que podrían ser costosos en horas de trabajo autónomo.

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

Preguntar en tu IA favorita

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

Documentación

Brief del director (paso 10 del curso)

Las películas largas son producciones. Los briefs detrás de las películas nocturnas del curso no describen un video; contratan un equipo: una logline contra la que verificar cada decisión, referencias, herramientas y presupuesto, una biblia de personajes, una hoja de ritmo, reglas de texto en pantalla, compuertas, un bucle de crítica y los entregables. Este skill convierte la idea del usuario en ese brief y ejecuta la producción a través de sus compuertas. Para clips de hasta unos 45 segundos sin capítulos, usa /motion-studio:motion-reel (el mismo umbral que ese skill usa para pasar una película más larga a este).

Argumentos, mostrados una vez:

Los archivos de este skill residen en ${CLAUDE_SKILL_DIR} (la plantilla del brief es ${CLAUDE_SKILL_DIR}/assets/brief-template.md, assets/brief-template.md).

Costo de este skill

Se ejecuta con esfuerzo max: el razonamiento más profundo y el mayor uso de tokens de cualquier skill de motion-studio. Los errores de planificación se acumulan durante horas de trabajo autónomo, por lo que el plan es donde ese gasto vale la pena. Establece expectativas con el usuario antes de comenzar. Puntos de datos reportados del curso: un videoclip nocturno duró unas 12 horas y usó alrededor del 80% del uso de un plan Max más $75 de crédito de API de imagen/video; un corto pintado a mano de 45 segundos usó 163 llamadas de modelo, 62.7M de tokens (96% de lecturas de caché), alrededor de $34 a precios de lista de API y unas 6.75 horas. Mantén el resto más barato: los animadores de capítulo se ejecutan con su propio esfuerzo (alto), y las correcciones y re-renderizados son trabajo de esfuerzo medio. Dile al usuario que baje el esfuerzo de la sesión con /model una vez que el plan esté aprobado si el presupuesto importa.

1. Recopilar las entradas

Solo la sesión principal puede hacer preguntas al usuario (los subagentes no). Si el usuario dictó un brief largo, analízalo en lugar de volver a preguntar. De lo contrario, pregunta una vez, en un solo mensaje, por lo que falta:

EntradaPor qué
logline, y lo que el espectador debería sentir al finalcada decisión se verifica contra ella
duración, formatos, dónde se publicaránúmero de capítulos, tiempo de renderizado, áreas seguras
referencias (video, fotogramas, biblioteca de imágenes, repositorio previo)gramática a adoptar, contenido a evitar
música: una pista (y su licencia) o "sintetizar"la cuadrícula de ritmo a la que todo se sincroniza
ruta (A por defecto; B solo si mencionan Remotion/HyperFrames; C generar-trazar) y claves de API por nombre de variableherramientas y gasto
presupuesto: uso de modelo, APIs de pago, tiempo realcuándo dejar de generar
modo: PLAN FIRST o GOsi detenerse después del plan

2. Escribir docs/brief.md

  1. Si no hay studio.json, ejecuta /motion-studio:studio-init primero (establece --duration, --bpm, --formats).
  2. Copia ${CLAUDE_SKILL_DIR}/assets/brief-template.md a docs/brief.md. Llena la parte A con las respuestas del usuario; mantén la parte B como está.
  3. Actualiza studio.json para que coincida (título, duración, fps, bpm, formatos, marca, loop).
  4. PLAN FIRST: muestra el brief completo y detente hasta que el usuario lo apruebe. GO: registra cada decisión que tomaste para el usuario en docs/decisions.md y continúa.

3. Compuerta 1: documentos del plan

ArchivoContenidoQuién lo escribe
docs/style_guide.mdpaleta, tipografía, ritmo, transiciones, textura, looks prohibidossubagente style-analyst desde referencias (/motion-studio:reference-style), o tú
docs/STORYBOARD.mdla idea, el reparto, qué lo une, capítulos con tomas y transiciones temporizadassubagente motion-director, o tú
docs/shotlist.mdcada toma en la cuadrícula de ritmo (compases), cámara, texto, SFXmotion-director
plan de capítulos (en STORYBOARD)límites de capítulos en tiempos fuertes, propietario por capítulotú

Mide o sintetiza la música antes de temporizar cualquier cosa (/motion-studio:sound-design): los tiempos de capítulo y toma son valores de grid.bar(n), no suposiciones. Mantén los capítulos de 8 a 30 segundos para que un subagente pueda terminar y revisar uno en una sesión. El motion-director escribe solo docs/** (el hook de guardia de rol lo impone).

4. Compuerta 2: rig y guía

  1. Escribe docs/ANIMATION_GUIDE.md desde la plantilla en docs/ del proyecto antes de que cualquier animador de capítulo comience, para que todos los capítulos codifiquen con el mismo estilo: cómo funciona un capítulo, propiedad, diseño y bandas reservadas, la API compartida, elementos compartidos, reglas de estilo con un presupuesto de tiempo de pintura, y los comandos de verificación exactos.
  2. Construye los elementos compartidos (personaje principal, kit de interfaz de usuario, ayudantes de paleta) tú mismo en film/scenes/shared_<nombre>.js. Los animadores de capítulo los importan y nunca los editan. Renderiza fotogramas de cada elemento en todos los estados.
  3. Crea un stub para cada capítulo para que la película se renderice de principio a fin mientras los capítulos están en progreso:
// film/scenes/ch03_build.js (stub escrito por la sesión principal; el animador del capítulo reemplaza las tomas)
import { chapter } from '../../lib/timeline.js';
export const BARS = [12, 20];                          // rango en compases de docs/STORYBOARD.md (null = hasta el final)
export default function ch03(ctx) {
  const FROM = BARS[0] === 0 ? 0 : ctx.grid.bar(BARS[0]);
  const TO = BARS[1] == null ? ctx.dur : ctx.grid.bar(BARS[1]);
  return chapter({ name: 'ch03_build', from: FROM, to: TO, shots: [], cues: [] });   // sin tomas = tarjeta de marcador
}
  1. Conecta film/film.js una vez. buildFilm acepta resultados de chapter() dentro de scenes, aplana sus escenas y fusiona sus cues. Las capas de toda la película (subtítulos, transiciones de unión) van en overlays: Scene[] de la fábrica: se pintan después de cada escena, en orden de array, con la misma regla from <= t < to (inclusivo al final en el último fotograma de la película), y nunca cuentan como tomas, por lo que las etiquetas de fotogramas, los límites de tomas de crítica y la lista de avance de la vista previa solo muestran tomas de capítulo. El código del capítulo permanece intacto; no envuelvas ni parchees funciones draw de capítulos. Arrays anidados, null y resultados de chapter() también se aceptan en overlays, por lo que un capítulo puede enviar sus propias escenas de superposición. Para apilar escenas ordinarias, asigna a una escena un número de layer (por defecto 0): las escenas se pintan por (layer, from).
import { defineFilm, scene } from '../lib/timeline.js';
import ch01 from './scenes/ch01_hook.js';
import ch02 from './scenes/ch02_problem.js';
import ch03 from './scenes/ch03_build.js';

const CHAPTERS = [ch01, ch02, ch03];

export default defineFilm((ctx) => ({
  scenes: CHAPTERS.map((make) => make(ctx)),
  overlays: [
    scene(0, ctx.dur, 'captions', (g, lt, c) => { /* subtítulos de toda la película: dibujar desde el tiempo de película c.t */ }),
    // una escena corta por unión de capítulo que necesita una transición, temporizada desde la cuadrícula
    scene(ctx.grid.bar(12) - 0.2, ctx.grid.bar(12) + 0.2, 'seam-ch02-ch03', (g, lt, c) => { /* barrido o destello */ }),
  ],
  cues: (grid) => [{ t: grid.bar(0), type: 'hit' }],   // cues a nivel de película; los cues de capítulo se fusionan automáticamente
}));

5. Desplegar los capítulos

Despliega un subagente chapter-animator (motion-studio:chapter-animator) por capítulo, varios en paralelo. Dale a cada uno un brief con: su archivo (film/scenes/chNN_<nombre>.js), su rango (la exportación BARS en su stub, más el mismo rango en segundos para los comandos de verificación), su sección de STORYBOARD, y "sigue docs/ANIMATION_GUIDE.md". El hook de guardia de rol permite que un animador de capítulo escriba solo film/scenes/** (excepto film/scenes/shared_*, que permanecen de solo lectura para los animadores de capítulo, quienes reportan errores de archivos compartidos) y out/check/**. Cada uno devuelve un informe: qué construyó, verificar fotogramas, problemas conocidos y errores que encontró en los archivos compartidos. Tú arreglas los archivos compartidos, vuelves a ejecutar las comprobaciones de toda la película, y re-briefas a un capítulo cuando su informe muestra un problema.

Los rangos de capítulo son compases, calculados con ctx.grid dentro de la fábrica del capítulo, por lo que los capítulos consecutivos siempre se encuentran y siguen una pista medida. Los tiempos de toma son segundos absolutos de película tomados de la cuadrícula (shots: [{ at: grid.bar(13), name: 'assemble', draw }, ...]); cada toma se ejecuta hasta el siguiente at, y su draw(g, lt, c) recibe lt desde el inicio de la toma. Una toma fuera de su rango de capítulo hace que chapter() lance un error y la película deje de cargar (por ejemplo, un TO = 4 literal rechaza una toma en grid.bar(1) = 4.003 s una vez que una pista medida coloca el primer tiempo fuerte en 2.0 s).

6. Compuertas 3 a 8

CompuertaHazVerifica
3 fotogramasnode tools/stills.mjs --shots (un fotograma por toma)ronda de crítica (/motion-studio:critique-loop)
4 animáticanpm run animatic (media escala, 30 fps, sin desenfoque) con la pista real o de marcadorritmo: cada lectura cae antes del siguiente tiempo fuerte
5 muestra más difícilnode tools/render.mjs --from A --to B --out out/check en los 2 a 4 s más difícilesnode tools/critique.mjs --strip-at <t>; determinismo; sincronía
6 pase completosin marcadores restantes (ninguna etiqueta de toma en node tools/stills.mjs --shots termina en /placeholder)ronda de crítica sobre toda la película
7 pulido y sonido/motion-studio:sound-design: partitura o ritmos, cues, SFX, vozmétrica de sincronía, eje de sonido
8 finalnpm run buildla definición de terminado en brief B6

Las películas largas se renderizan en segmentos reanudables: node tools/render.mjs --format all --final --chunk 10 escribe out/<fmt>/.parts/seg_<a>_<b>.mp4 y salta los segmentos terminados cuando se vuelve a ejecutar tras una interrupción. Ejecuta los renderizados largos en segundo plano (la herramienta Bash run_in_background, o un archivo de log que sondees) en lugar de bloquear la sesión, y nunca esperes en primer plano más de unos 2 minutos. Presupuesta unos 20 s de tiempo real por segundo de película para tres formatos a 60 fps y 4 sub-fotogramas (una película de 2 minutos son unos 40 minutos de renderizado); el manual de ejecución de /motion-studio:motion-reel tiene el patrón y el tiempo esperado de todos los demás comandos. Un chapter-animator o cualquier otro subagente no debe regresar mientras un comando que inició todavía se esté ejecutando.

7. Ruta C: generar-trazar (opcional)

Solo cuando el brief selecciona la ruta C y lista las claves (por nombre de variable: FAL_KEY, ELEVENLABS_API_KEY en .env) y un presupuesto. Los modelos de video dan física, temporización y rostros que son difíciles de codificar a mano; la capa de código da un aspecto consistente que el usuario posee. Los espectadores ven la capa de código.

  1. Genera hojas de personajes y tomas base con el servicio elegido por el usuario, siguiendo sus propios docs. Guarda cada resultado bajo refs/base/ con una fila de manifiesto (servicio, modelo, prompt, semilla, costo, licencia). Detente en el presupuesto.
  2. Extrae fotogramas para estudiar: node tools/refs.mjs extract refs/base/shot01.mp4 --every 0.1 --out refs/base/shot01.
  3. Redibuja cada toma en código sobre esa temporización (mira los fotogramas, reconstruye el movimiento con resortes y pistas). El metraje base nunca se carga en tiempo de renderizado desde la red; si una toma compone un fotograma base, cárgalo desde un archivo local en setup().
  4. Verifica la sincronía: fotogramas de la capa de código junto a los fotogramas base en los mismos tiempos, y los cues de audio en la cuadrícula. Vuelve a ejecutar el paso para cualquier toma que se desvíe.

Claves: nunca imprimas, hagas eco, registres o pegues. Las herramientas leen .env por sí mismas; nombra la variable en las indicaciones y documentos.

8. Definición de terminado e informe

El B6 del brief es el contrato: sonoridad -14 LUFS +-0.5 y <= -1 dBTP en el MP4 entregado, al menos 3 rondas de crítica con cada eje >= 8 y sin P0 (npm run gate), un re-renderizado da fotogramas idénticos (verificación de determinismo de crítica más valores iguales de framesDigest de dos renderizados --hash), duración exacta y fotogramas en cada formato, y todos los entregables presentes (npm run deliver verifica la mayor parte de esto y escribe docs/production.json). Termina con el informe B7: entregables, puntuaciones por ronda, gasto real, defectos conocidos, qué mejorarías a continuación.

Créditos: el esqueleto del brief sigue el paso 10 del curso; la división rellenar/mantener, PLAN FIRST vs GO y una definición de terminado siguen un patrón de plantilla pública de @pradeepXkapoor (reformulado); las compuertas de aceptación están adaptadas de athemeroy/awesome-opus-5-5-videos docs/production-brief.md (CC BY 4.0); el patrón de subagente guía-más-storyboard fue estudiado en JohnHeibel/PDoomVideo (solo ideas, sin texto reutilizado).

Siguiente: /motion-studio:critique-loop después de cada compuerta desde la 3 en adelante, luego /motion-studio:ship-formats para entregar.

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

Make a launch video, app or product reel, explainer or motion ad from code, end to end: brand assets from a URL, beat-grid shot list, synced sound, critique loop, all formats. Default for new video requests; not footage edits.

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