Communitygithub.com

Jayfirke / Motion-Studio

Planifica un largometraje como su director y muéstraselo al propietario como una página de previsión interactiva (animática con voz real, música y foley, línea de tiempo, tres opciones intercambiables en cada decisión, notas ancladas en el tiempo, versiones y un botón de Aprobación) antes de renderizar nada. Úsalo para toda nueva película de más de 10 s, cuando el propietario pida 'verlo primero', 'previs', 'storyboard', 'animática' o 'visualizar antes de renderizar', y cuando deje notas en una página de previsión. Produce un `approved-video-spec.json` para los skills de motor; nunca renderiza el final por sí mismo.

¿Qué es Motion-Studio?

Este skill de agente de IA (video-director-previs) está diseñado para que un único director de IA (sin comités ni subagentes) gestione toda la preproducción de una película —dirección, historia, guion, storyboard, estilogramas, animática, música, efectos de sonido, voz, elección del motor, control de calidad, revisión, versiones y aprobación—, todo ello antes de que ningún motor de renderizado toque el material. El propietario recibe una página web interactiva y completamente funcional (Previs Studio) que funciona como un reproductor de vídeo con pantalla completa real, conmutación instantánea entre tres opciones por decisión (dirección visual, música, sensación de movimiento, ritmo, transiciones, etc.), notas ancladas en el tiempo, comparación lado a lado, una guía de revisión, una pestaña "Preguntar al director", búsqueda ⌘K, deshacer/rehacer y temas claro/oscuro. Todo está construido sobre una única aplicación React + TypeScript fija (`_shared/previs/app/`), de modo que el propietario nunca modifica la aplicación; simplemente recibe "paquetes de datos" (un `previs.json`, archivos de audio y una configuración de `films.json`) para cada película. El skill se integra con Claude Code a través de notas en vivo: el propietario puede enviar "Enviar a Claude Code" desde la página, y Claude responde actualizando el plan, las opciones, el estado de aprobación y un registro de actividad, todo ello sincronizado mediante una base de datos en página (o una base de datos integrada en Artifact de claude.ai). Una vez que el propietario aprueba (botón "Aprobar"), el skill congela una especificación (`approved-video-spec.json`) y la entrega al motor de renderizado adecuado (HyperFrames, Remotion, Diffusion Studio, etc.) para que construya el vídeo final. El skill impone reglas estrictas: un solo director, inferir agresivamente sin largos cuestionarios, ofrecer siempre tres opciones genuinamente diferentes por decisión, anotar la verdad del producto (etiquetar si es UI real, conceptual o metraje externo), escalar el esfuerzo según la duración (un clip de 6 s recibe un tratamiento mínimo; uno de 40 s recibe el conjunto completo) y, una vez aprobado, bloquear historia, copia, orden, sincronización y selecciones. También incluye un checklist de especialista que el director cubre brevemente: historia, guion, ritmo editorial, dirección artística, tipografía, referencias, cámara, movimiento, transiciones, activos, música, SFX, mezcla, motor y QA. Todo el trabajo es en solitario, sin renders, y cuesta aproximadamente entre 30 y 60 USD en equivalente de API por una previsión de 20 segundos usando el modelo gratuito de Fish para voz.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jayfirke/motion-studio/tree/HEAD/.agents/skills/video-director-previs

Preguntar en tu IA favorita

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

Documentación

video-director-previs

Toma decisiones creativas costosas en la etapa más barata. Este skill es dueño de la preproducción: dirección, historia, guion, storyboard, estilogramas, animática, música, SFX, voz, elección del motor, control de calidad, revisión, versiones y aprobación. Los motores (HyperFrames, video-shotcraft, Remotion, motion-reel, bang-motion, Diffusion Studio) solo construyen lo que el propietario aprobó.

Ejemplo práctico: examples/crumb-previs/ (una app ficticia para dividir cuentas). Su paquete de datos es la película demo en Previs Studio (_shared/previs/studio/films/011-crumb/).

La app nunca cambia por película. Previs Studio es una única aplicación React + TypeScript fija (fuente _shared/previs/app/, ver su README). npm run build allí verifica tipos, empaqueta e incrusta todo en _shared/previs/studio/index.html y _shared/previs/page/index.html (plantilla); añade un destino en scripts/inline.mjs para cada página por película. npm run smoke ejecuta la página construida en Chrome real en escritorio, tableta, teléfono y pantalla completa (capturas de pantalla con --out). Nunca edites a mano el index.html generado.

Lo que obtiene el propietario: Reproducir (reproductor estilo vídeo con pantalla completa real, vista previa al pasar el ratón, tarjeta final; modo de comentarios que nombra la parte más pequeña bajo el puntero, desplazamiento para más grande o más pequeño, arrastrar un cuadro alrededor de varias partes, lápiz y flecha, arrastrar a lo largo de la fila de tomas para un rango de tiempo; carriles de sonido con formas de onda, pulsos, la curva de duck, solo/mute/volumen y SFX arrastrables que se ajustan al pulso), opciones que reproducen su momento en su lugar con sonido, comparación lado a lado, mantener para escuchar el original, Storyboard (tarjetas que reproducen su toma en su lugar, Reproducir todo, opciones por toma, una hoja de tomas), Plan (director jefe, historia, equipo de dirección, aspecto, sonido, activos, producción, comprobaciones, versiones con "pedir deshacer", exportación de especificaciones), una revisión guiada, Preguntar al director, búsqueda ⌘K, deshacer/rehacer, temas claro y oscuro, descripciones emergentes en todos los controles. Las películas llegan solo como paquetes de datos.

Dos hogares, misma app

  • Previs Studio (todas las películas): _shared/previs/studio/. Añadir una película = añadir films/<id>/previs.json + films/<id>/audio/... y una fila en films.json. Localmente: python3 -m http.server --directory _shared/previs/studio (o la entrada previs-studio en .claude/launch.json).
  • Página por película: projects/NNN/previs/page/ contiene una copia del mismo index.html (título <Producto> Previs), films.json con una fila cuyo path es "", previs.json y audio/.
  • Como un Artifact de claude.ai (solo Claude): publica la página con capabilities: {"db": {}, "user": {}, "sample": {}, "comments": {}, "downloads": true}. db almacena notas y selecciones, sample alimenta Preguntar al director, comments lleva "Enviar a Claude Code", downloads la exportación de la especificación. Sin ellos la página sigue funcionando y guarda en el navegador.
  • Rutas de base de datos: comentarios (solicitudes de cambio ancladas a la película; la colección mantiene el nombre antiguo) films/<id>/notes (kind frame, region, range, sound, shot, revert o request; target, targets, box, strokes, chips quick, t/t2, picks y version en ese momento); selecciones y ajustes de sonido films/<id>/state/picks (tweaks: <scene>.<sfx> {dt, db}, lane.vo|music|sfx {db}, mix.duck {on}); opciones añadidas films/<id>/state/custom; aprobación films/<id>/state/approval; estado de Claude films/<id>/state/claude; actividad films/<id>/activity; notas (pensamientos libres sobre toda la película: léelos como contexto, nunca como tareas) films/<id>/pad.

Bibliotecas: más de tres opciones bajo demanda

Cada decisión incluye tres opciones de director; D['libraries'] añade más que el revisor (o la pestaña Preguntar) puede incorporar: direction (aspectos: conjuntos de tokens + fonts_url), music (pistas CC0 con bpm, phase, tags, level), motion (ease, spring {f,d} o bezier), pacing, camera, transition, sfx (cada sonido en la película) y voice (voces Fish: dir, durs, texts para otros idiomas, intro, sample). La decisión global voice elige al narrador; una voz resuelve cada línea en <dir><scene>-<A|B|C>.mp3, y una voz con needs y sin dir se reproduce como subtítulos hasta que se graba. Las opciones añadidas viven en la base de datos de la página, se pueden deshacer y van a la especificación aprobada. Construye bibliotecas con examples/crumb-previs/libraries.py como modelo:

  • Música: busca Freesound CC0 (freesound.py search ... --min-dur 20), freesound.py get, luego python3 _shared/previs/music_lib.py <page>/audio/music/lib <oggs> (extractos de 24 s alineados al pulso, BPM medido); escribe etiquetas y un por qué por pista; filas de ledger en _shared/ASSETS.md.
  • Voces: elige voces Fish públicas con search_voices (sin clones de personas reales o personajes), enuméralas en voices/voices.tsv, escribe voices/lines-<lang>.txt, ejecuta voices/make_voices.sh (modelo gratuito), luego verifica tomas con whisper-cli y regenera las que falten palabras.
  • El director de IA (pestaña Preguntar, lib/director.ts) también puede diseñar aspectos (verificados por contraste, fuentes de Google permitidas), sensaciones de movimiento y nuevas redacciones de líneas (que necesitan una grabación: archiva una nota de solicitud para Claude Code).

El lado de Claude Code de las notas (haz esto cada ronda)

El propietario envía notas desde la página ("Enviar a Claude Code": un comentario en vivo que despierta una sesión de observación, o un mensaje copiado). Luego: 0. Tira antes de cambiar. Claude en claude.ai puede responder un hilo "Enviar a Claude Code" por sí mismo, editar el archivo de datos y publicar una nueva versión. Antes de construir, lee el previs.json publicado, compáralo con tu construcción local y traslada cualquier cambio a build_previs.py para que la próxima construcción lo mantenga.

  1. Establece films/<id>/state/claude {state:"reading"|"working"|"publishing"|"idle", at, message, version, open} para que la página muestre lo que estás haciendo.
  2. Para cada nota abierta: actualízala con claude: {state:"seen"} cuando la leas, {state:"working"} mientras cambias, luego status:"done", claude:{state:"done", at, msg} y añade {by:"claude", text, at} a replies (pin if_version). Usa state:"question" (con la pregunta en msg) cuando necesites al propietario, "wontfix" cuando recomiendes mantenerlo. Las notas con kind:"request" son trabajos de la pestaña Preguntar (grabar una nueva línea, encontrar un sonido); prefer apunta a la opción que le gusta al propietario; intent:"question" quiere una respuesta, no un cambio. Cada at es la hora real: tómala de date -u +%Y-%m-%dT%H:%M:%SZ, nunca una suposición.
  3. Añade líneas a films/<id>/activity ({at, by:"claude", kind:"seen"|"applied"|"published"|"question", text, version}): lo que leíste, lo que cambiaste, lo que publicaste.
  4. Responde en el hilo de comentarios de la página si el propietario usó Enviar a Claude Code, luego resuélvelo.

Reglas

  • Un director, sin comités. Recorre tú mismo la lista de verificación de especialista a continuación, en orden. Sin flujos de trabajo ni subagentes a menos que el propietario lo pida (regla de costo).
  • Infiere agresivamente; pregunta solo por verdaderos bloqueadores (verdad del producto, un activo faltante, una pregunta de licencia). Nunca un cuestionario largo antes de que el propietario vea algo.
  • Tres opciones en cada decisión, por defecto. Dirección, música, sensación de movimiento, ritmo, y por escena: transición, cámara, línea de voz, cada evento SFX. Las opciones deben ser genuinamente diferentes. Marca la elección del director y da a cada opción una oración simple del por qué o la compensación. "Nada" es una opción de SFX válida.
  • Verdad del producto. Cada escena está etiquetada como real_ui, conceptual_ui, conceptual_visual o external_footage; cualquier cosa que no sea real muestra una etiqueta en el reproductor.
  • Las reglas de la casa aún aplican (AGENTS.md, OWNER.md): clichés prohibidos, portadas, dos niveles de texto, foley grabado, la voz predeterminada, licencias. La página solo reproduce audio CC0 o auto-creado; Mixkit (solo render) aparece solo por nombre.
  • Escalar. Un clip de 6 s puede ser una tarjeta de dirección, 3 opciones de música y una animática de 6 s. Una película de producto de 40 s recibe el conjunto completo.
  • Bloqueos. Una vez que el propietario aprueba, la historia, la copia, el orden, la sincronización y las selecciones están bloqueados. Una nota posterior cambia solo su objetivo; enumera lo que preservaste.

Lista de verificación del especialista (el director cubre cada uno, brevemente)

Historia (gancho a los 2 s, un estado por compás) · guion y líneas de voz (palabras por segundo ≤ 3.4) · ritmo editorial (variar duración de tomas, pausas, no cada corte en el pulso) · dirección artística (3 direcciones como conjuntos de tokens: bg, on-bg, card, on-card, muted, line, paper, on-paper, accent, on-accent, frame, display, ui, mono) · tipografía · referencias (tomar prestado / evitar / dónde se usó; gramática, nunca contenido) · cámara (cada movimiento tiene una razón) · movimiento (propósito, easing, overshoot ≤ 4 % en UI, ninguno en texto) · transiciones (un corte simple es válido) · activos (existente / nuevo / generado / marcador de posición, con licencia) · música (BPM y fase medidos, curva de energía, dónde cae el drop) · SFX (activo, tiempo, disparador, ganancia, por qué) · mezcla (voz lidera, duck 8 dB, impacto más fuerte) · motor (elegido, por qué, alternativa, respaldo) · QA.

Archivos (una carpeta por película)

projects/NNN-name/previs/
  build_previs.py          # escribe page/previs.json; copia examples/crumb-previs/build_previs.py y edita (escenas = estilograma HTML + tweens de animación)
  vo-lines.txt             # 3 redacciones por línea, para fish_tts.py
  page/index.html          # construido por _shared/previs/app (npm run build; añade esta página como destino en scripts/inline.mjs)
  page/films.json          # [{"id": "NNN-name", "name": "Producto", "path": ""}]
  page/previs.json         # todo el plan
  page/audio/{music,vo,sfx}/
  changes.jsonl            # registro de cambios solo adjuntar, una operación por línea
  approved-video-spec.json # escrito por _shared/previs/freeze_spec.py después de la aprobación

Pasos

  1. Lee el brief o la solicitud de una línea y la fuente del producto (UI real, tokens, copia). Escribe BRIEF.md con las decisiones inferidas.
  2. Audio (barato, local):
    • Pistas: mide tempo y fase mediante ajuste de peine sobre 85–150 BPM en un sobre de onset de baja banda (AGENTS-tooling.md, "Previs"); corta extractos de 24 s comenzando en un pulso, loudnorm a −18 LUFS: ffmpeg -ss <phase> -t 24 -i bed.wav -af "loudnorm=I=-18:TP=-2,afade=t=out:st=22.5:d=1.5" page/audio/music/A.mp3.
    • Voz: python3 _shared/tools/fish_tts.py --lines previs/vo-lines.txt --out-dir previs/vo-wav (modelo gratuito), luego recorta silencios en page/audio/vo/sN-{A,B,C}.mp3.
    • Foley: copia vistas previas CC0 de _guide/prompt-studio/media/foley/ o descarga con freesound.py.
  3. Planifica en build_previs.py (ver el ejemplo para cada campo): project, summary, chief, story (compases → escenas), directors, assets, gates, pipeline, changes, directions (3), global.music|motion|pacing|voice (3 cada uno), engine, references, style_rules, audio_notes, qa, versions, film_css (todos los colores mediante tokens, clases con prefijo f-), fonts_url, y scenes[] con html, anim (tweens {s, t:[a,b], f, to, e} en x, y, s, sx, sy, r, o, clip, w, blur; {s, set, at, until} alternancias de clase; {s, count:[from,to], t, p, d} contadores; e:'m' sigue la elección de Motion), decisions (tipos de transición cut, push, slide, zoom, iris; cámara {s,x,y,origin}; vo {text, src, dur, at, copy}), sfx (at puede ser una lista para series), key (el momento fijo del storyboard). Dale a cada elemento que el propietario pueda señalar un data-name simple ("Total del recibo", "Botón de solicitud").
  4. Verifica localmente: sirve la carpeta de la página, mira un fotograma de cada escena y uno a mitad de transición, cambia las tres direcciones una vez, confirma que no hay errores en consola. Una pasada, sin bucle.
  5. Comparte la página (localmente, o como un Artifact de claude.ai con las capacidades anteriores) y añade la película a Previs Studio. Dale al propietario el enlace y un resumen de cinco líneas. Detente para revisión.
  6. Bucle de revisión (cada ronda es una republicación):
    • Lee notas, selecciones y aprobación.
    • Para cada nota abierta: cambia solo su objetivo, añade una operación a changes.jsonl ({"v","target","t","change","from","to","reason","preserve":[...]}), luego marca la nota como hecha con una respuesta de una línea (protocolo anterior). Una nota revert pide deshacer un cambio listado.
    • Aumenta versions y añade los changes de la ronda en build_previs.py, vuelve a ejecutarlo, copia previs.json en la copia de Studio, republica. El reproductor muestra un banner "qué cambió" y el Plan lista cada cambio con una solicitud de Deshacer.
  7. Aprobación: cuando state/approval tenga approved: true (lleva picks, tweaks y custom), guárdalo, ejecuta python3 _shared/previs/freeze_spec.py projects/NNN-name/previs --approval <file> (resuelve opciones añadidas y la voz, y lista needs_before_build como líneas no grabadas), escribe SHOTLIST.md a partir de la especificación, luego entrega al skill de motor nombrado en la especificación. El motor construye exactamente la especificación (pulido permitido, decisiones no).

Costo

Solo trabajo en solitario. Una previsión de 20 s son unas pocas horas de una sesión (aproximadamente $30–60 equivalente de API), con Fish en el modelo gratuito y sin renders. El render de producción y sus comprobaciones vienen después de la aprobación.

Individual skills in this repo

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

Skills relacionados