Communitygithub.com

yazzang-homelab/motion-studio

Envía todos los formatos desde una sola línea de tiempo, luego empaqueta: reframe con layout() (nunca recortar), renderiza todos los formatos, controles por formato, deliver.mjs, una skill de marca, una oferta de servicio. Úsalo para 'exportar 9:16 y 16:9', 'entregar', 'crear una skill'.

¿Qué es motion-studio?

Motion Studio es una skill de IA para agentes como Claude Code que transforma un video clip en un pipeline de producción repetible, permitiendo exportar múltiples formatos (9:16, 1:1, 16:9, 4:5) desde una sola línea de tiempo sin recortes, gracias al sistema de layout() que reubica y redimensiona el contenido para cada formato. Incluye herramientas de revisión crítica para cada formato, renders finales, mezcla de audio y un módulo de entrega (deliver.mjs) que verifica duración, tamaño, volumen, póster y la puerta de crítica, fallando con mensajes claros si algo está mal. Además, guía al usuario para empaquetar todo el pipeline como su propia skill de marca (por ejemplo, /acme-reel) y, opcionalmente, crear una oferta de servicio profesional. Está diseñado para proyectos cinematográficos reales donde la consistencia y la calidad son críticas, soportando plataformas como Reels, TikTok, YouTube y feeds de X.

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

Preguntar en tu IA favorita

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

Documentación

Envía formatos, una skill y un servicio (paso 12 del curso)

Tres movimientos convierten un buen clip en un negocio repetible: exporta cada formato desde una sola línea de tiempo, empaqueta el pipeline como una skill para que el próximo video sea una oración y, si el usuario lo desea, véndelo. Trabaja en la raíz del proyecto cinematográfico. Argumentos, mostrados una vez:

Los archivos de esta skill viven en ${CLAUDE_SKILL_DIR} (las plantillas en assets/).

1. Reencuadra por formato, nunca recortes

Las escenas se dibujan contra el layout L (ctx.L en la fábrica, c.L en un dibujo), así que una línea de tiempo renderiza 9:16, 1:1, 16:9 (y 4:5) con texto y UI colocados para cada forma.

FormatoTamañoEtiqueta
9x161080x1920Reels, TikTok, Shorts
1x11080x1080X / feed
16x91920x1080YouTube, sitio
4x51080x1350feed retrato
HerramientaUso
L.uunidad de tamaño: 1 a 1080 px de lado corto; 120 * L.u se lee del mismo tamaño en cada formato
L.Sel rectángulo seguro {x, y, w, h} de studio.json safe[fmt] (márgenes de la UI de la plataforma)
L.pos(ax, ay)un punto dentro del rectángulo seguro, ax, ay de 0 a 1
L.pick({ '9x16': a, '1x1': b, '16x9': c, portrait, landscape, square, default })valores por formato: clave exacta, luego orientación, luego predeterminado
L.split('auto', ratio, gap)dos regiones: apiladas en retrato y cuadrado, lado a lado en paisaje
L.cols(n, gap) / L.rows(n, gap)columnas o filas dentro del rectángulo seguro
fitFontSize(g, text, maxW, (s) => font(s, family, weight), lo, hi, { tracking, step })el tamaño más grande que cabe en un ancho (lib/layout.js + lib/draw.js); step: 16 para fuentes de mapa de bits
wrapText(g, text, maxW, font(size, family), { maxLines, ellipsis })líneas para texto multilínea, sin cortar nunca dentro de una sílaba Hangul (lib/draw.js)
draw(g, lt, c) {
  const { L, brand } = c;
  const { a, b } = L.split('auto', L.pick({ landscape: 0.45, default: 0.4 }), 32 * L.u);   // título | producto
  const size = Math.min(L.pick({ '9x16': 170, '1x1': 140, '16x9': 150 }) * L.u,
                        fitFontSize(g, 'MAKE IT MOVE.', a.w, (s) => font(s, brand.fonts.display, 400)));
  kinetic(g, 'MAKE IT MOVE.', a.x, a.y + a.h * 0.6, lt, { size, family: brand.fonts.display, weight: 400, color: brand.colors.fg, spring: 'default' });
  drawProduct(g, b, lt, c);                                         // la UI del producto llena la región b en cada formato
}

Reglas: sin píxeles literales; contenido clave dentro de L.S; el mismo momento ocurre al mismo tiempo en cada formato (solo cambian la colocación y el tamaño); un formato que parece un recorte de otro es un P1 en la crítica. Ajusta los márgenes safe en studio.json, no en el código. Previsualiza cada formato con npm run preview (F cambia formatos, G muestra las guías de seguridad).

2. Revisa cada formato

El bucle de crítica se ejecuta en el formato principal; antes de la final, ejecuta al menos una ronda por cada otro formato, cada una con su propia evidencia (aproximadamente 115 s de tiempo de herramienta por pase en vivo y 85 s por pase --video, medidos en una película de 12 a 20 s):

node tools/stills.mjs --format 1x1
node tools/render.mjs --format 16x9 --draft --sub 1 --scale 0.5     # aproximadamente 20 s; luego: npm run sfx, node tools/mix.mjs --format 16x9
node tools/critique.mjs --format 16x9                                 # película en vivo -> out/review/16x9/
node tools/critique.mjs --format 16x9 --video out/16x9/final.mp4      # render mezclado -> out/review/16x9/video/

Registra cada una como su propia ronda (## Ronda <n> — 16x9 — ...). La puerta lee la última ronda, así que termina con una ronda aprobada.

3. Renderiza, mezcla, entrega

Estos toman minutos: el demo de 12 s se renderiza en aproximadamente 4 min para tres formatos a 60 fps (aproximadamente 20 s por segundo de película), mix toma 40 a 80 s y deliver aproximadamente 40 s. Inicia npm run build, render:final, mix y deliver con la opción run_in_background de la herramienta Bash y un registro, consulta el registro (tail -n 3), lee el resultado después de la línea exit, y nunca esperes en primer plano más de aproximadamente 2 minutos; agrega --chunk 10 a una final de tres formatos o más de aproximadamente 30 s. El runbook de motion-reel ("Comandos largos") tiene el patrón.

PasoComandoSalida
todo, en ordennpm run buildscore (si falta), sfx, render final de todos los formatos, mix, deliver
render final (con puerta)npm run render:finalout/<fmt>/silent.mp4, poster.png, render.json para cada formato en studio.json formats
mezcla y muxnpm run mixout/score.wav, out/<fmt>/final.mp4, out/final.mp4 (principal), out/poster.png
controles y paquetenpm run deliverout/deliver/<slug>_<fmt>.mp4 + póster + cada página de la hoja de contactos (<slug>_<fmt>_contact.png, luego _contact-2.png ...), out/deliver/manifest.json, docs/production.json

deliver.mjs verifica, por formato, out/<fmt>/final.mp4 contra el studio.json ACTUAL: recuento de fotogramas (duración x fps), el tamaño del formato, fps y duración exacta (un corte renderizado antes de una edición de duration o fps falla como render obsoleto; un render borrador o escalado también falla), sonoridad integrada y pico verdadero contra audio.lufs +- audio.lufsTolerance y audio.truePeak; tramos de silencio (un tramo de 1 s o más por debajo de -50 dB falla como silencio, por ejemplo silencio 2.2 s en 00:02.1, a menos que comience en los primeros 0.3 s, comience en el último segundo o esté dentro de un intervalo critique.allowSilence); tamaño de archivo contra deliver.maxBytes (predeterminado x: 536,870,912 bytes = límite de carga de 512 MB de X; agrega los límites de otras plataformas allí); póster presente; la costura del bucle para películas en bucle; y la puerta de crítica. Advierte (sin fallo) cuando las fuentes de la película son más recientes que el render. Sale con 1 y nombra cada verificación fallida; un final.mp4 ilegible también falla. Con --json, un fallo imprime una línea { ok: false, error, failed: [...] }, también cuando la ejecución no puede comenzar (un studio.json inválido, un formato desconocido, una bandera incorrecta). --format 1x1 re-entrega solo ese formato y mantiene los archivos entregados y las entradas del manifiesto de los demás (carriedOver); una puerta fallida retira cada archivo entregado. docs/production.json registra título, formatos, duraciones, sonoridad, rondas, últimos puntajes, el nivel de esfuerzo (de CLAUDE_EFFORT cuando está configurado) y versiones de herramientas.

Verificación fallidaSolución
fotogramas o duración incorrectos, o render obsoletovuelve a ejecutar npm run render:final; nunca entregues un render parcial
sonoridad o pico verdadero/motion-studio:sound-design (tabla de informe de mezcla)
silenciouna pista termina temprano o un fondo suena bajo nada: regenérala (npm run score, sfx, voice), npm run mix, entrega de nuevo
tamaño superior al límitenode tools/render.mjs --format <f> --final --crf 18 luego npm run mix de nuevo
póster faltanteestablece studio.json poster (segundos) o elimina --no-poster
puerta/motion-studio:critique-loop

Informa al usuario: cada archivo en out/deliver/, los números por formato del manifiesto, los puntajes de la última ronda y qué mejorarías a continuación.

4. Empaqueta el pipeline como tu propia skill

Para que el próximo video sea una oración (/acme-reel video de lanzamiento para modo oscuro, 20 s, vertical):

  1. Elige el nombre: <marca>-reel, minúsculas, dígitos y guiones.
  2. Crea .claude/skills/<marca>-reel/SKILL.md en el repositorio de la marca (ámbito del proyecto, compartido a través de git) o en ~/.claude/skills/<marca>-reel/SKILL.md (personal). Comienza desde ${CLAUDE_SKILL_DIR}/assets/brand-skill-template.md (assets/brand-skill-template.md).
  3. Complétalo desde este proyecto, no de memoria: valores de marca de studio.json, docs/style_guide.md, el docs/shotlist.md aprobado como patrón de ritmo narrativo, y las lecciones en docs/review_log.md (lo que el crítico seguía señalando se convierte en una regla estricta). Copia el logotipo en .claude/skills/<marca>-reel/assets/.
  4. Mantén la descripción por debajo de aproximadamente 230 caracteres con frases de activación concretas, el cuerpo por debajo de aproximadamente 200 líneas.
  5. Pruébalo en una sesión nueva con una solicitud real y verifica que solo pregunte por lo que cambia por video.
  6. Para compartir más allá de un repositorio, publícalo como un plugin (un repositorio con .claude-plugin/plugin.json y skills/<nombre>/SKILL.md), de la misma manera que buildwithhanif/claude-animation-skill y este plugin están publicados.

5. Conviértelo en un servicio (opcional)

${CLAUDE_SKILL_DIR}/assets/service-offer.md (assets/service-offer.md) es una oferta para rellenar: qué está incluido (música, una mascota en cualquier estilo, características del producto, una oferta al final, cualquier idioma, hasta 3 ediciones), formatos, tiempo de entrega, qué proporciona el cliente, derechos y divulgación, y precios. Ancla de precio: Tony Dinh informó haber pagado aproximadamente $1,000+ por un video de lanzamiento similar un año antes de hacer uno con Opus 5.5 en menos de 30 minutos (https://x.com/tdinh_me/status/2103703135902740699). Ayuda al usuario a rellenarlo; no lo publiques ni lo envíes por él.

Siguiente: comienza la próxima película con /motion-studio:motion-reel, o la nueva skill /<marca>-reel del usuario.

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

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

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