Communitygithub.com

yazzang-homelab/motion-studio

Convierte una referencia (un fotograma, un video o una biblioteca de imágenes) en docs/style_guide.md y una lista de tomas con rejilla de ritmo: mide cortes, paleta y cadencia, toma la gramática, no el contenido, espera la aprobación. Úsalo cuando el usuario proporcione o nombre un estilo.

¿Qué es motion-studio?

Motion Studio es una habilidad especializada para agentes de IA (como Claude Code, Cursor o Codex) que sistematiza la extracción de un estilo visual a partir de una referencia dada por el usuario, transformándola en documentos de producción listos para usar. A partir de un fotograma, un video o una carpeta de imágenes, la herramienta analiza automáticamente la paleta de colores, los tipos de transición, la densidad de composición, los tiempos de corte y la energía de movimiento. Luego genera una guía de estilo (`docs/style_guide.md`) y una lista de tomas sincronizada con el ritmo (`docs/shotlist.md`). El proceso sigue un enfoque de "tomar la gramática, no el contenido", evitando copiar logotipos, personajes o material con derechos de autor. La habilidad está diseñada para funcionar en cualquier proyecto que cuente con un archivo `studio.json` y depende de herramientas Node.js (`refs.mjs`) para el análisis automatizado. Antes de generar cualquier código de producción, se requiere la aprobación explícita del usuario de ambos documentos, lo que permite iterar sobre el estilo sin comprometer el código base.

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

Preguntar en tu IA favorita

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

Documentación

Estilo de referencia (paso 05 del curso)

Sin referencia, el modelo deriva hacia una apariencia predeterminada: texto centrado sobre un degradado con todos los elementos apareciendo gradualmente. Rexan Wong (@rexan_wong) revisó un lote de clips virales y descubrió que nombrar un estilo funciona mejor que describirlo, y que una referencia proporciona al modelo el ritmo, el tipo y las transiciones a copiar. Esta habilidad convierte una referencia en dos documentos aprobados antes de que exista cualquier código de producción.

Argumentos de la solicitud (pueden estar vacíos), mostrados una vez:

La escalera de referencia

EscalónQué da el usuarioQué extraesHerramienta
Un fotogramauna imagen fija de un video que le encantapaleta, tipo, textura, densidad de composiciónrefs.mjs analyze refs/<carpeta> + examínalo
Un videoun archivo local de una película que admiralo anterior más tiempos de corte, duraciones de toma, energía de movimiento por segundo, transicionesrefs.mjs extract + analyze
Una bibliotecauna carpeta con sus propias imágenes o trabajo anteriorun estilo propio que nadie más puede copiarrefs.mjs analyze refs/<carpeta>

La pieza de código puro de Pleometric para TikTok comenzó a partir de un solo fotograma de otra animación viral; su película al estilo Donald señaló a Opus su propia galería de imágenes PC-98. Dónde encontrar referencias: videos de lanzamiento en whatships.com, animación en Dribbble y películas de lanzamiento de la competencia. Estúdialas; nunca las incrustes ni redistribuyas.

1. Obtén la referencia en disco

  • Copia el archivo o carpeta en refs/ dentro del proyecto (inicialízalo con /motion-studio:studio-init primero si no hay un studio.json).
  • Si solo se proporciona un enlace al video de otra persona, pide al usuario una copia local que esté autorizado a estudiar. No descargues contenido de terceros por tu cuenta.
  • Un fotograma único: colócalo en su propia carpeta (refs/frame/) para que analyze lo trate como un conjunto de imágenes.
  • Pregunta qué tomar y qué no tomar cuando el usuario tenga una opinión ("el grano y el tipo, no los personajes").

2. Mídelo

Ejecuta desde la raíz del proyecto:

ReferenciaComandos
videonode tools/refs.mjs extract refs/<video> --every 0.5 y luego node tools/refs.mjs analyze refs/<video>
fotograma o bibliotecanode tools/refs.mjs analyze refs/<carpeta>
cortador rápido (muchos cortes omitidos)añade --threshold 0.2 a analyze

Salidas: refs/frames/frame_NNNN.png, refs/frames/frames.json, refs/contact.png (hoja etiquetada de hasta 60 mosaicos; una hoja alargada se pagina como cualquier hoja de contacto: refs/contact.png es la página 1, luego refs/contact-2.png, contact-3.png ...; abre cada página; el resultado --json las lista en contacts), y refs/analysis.json con tiempos de corte, duraciones de toma (media, mediana, rango), una paleta de 6 colores con porcentajes, brillo y contraste, energía de movimiento por segundo con su pico, y una sugerencia de densidad de texto. El resumen impreso es un bloque de inicio para la guía de estilo.

3. Escribe la guía de estilo y la lista de tomas

Indica a motion-studio:style-analyst (puede escribir docs/style_guide.md, docs/shotlist.md y refs/**):

Raíz del proyecto: <ruta absoluta>. Referencia: refs/<archivo o carpeta>. Tema: <tema>. Duración: <S> s.
Abre refs/contact.png (y refs/contact-2.png ... si está paginada) y algunos fotogramas alrededor de los cortes, lee refs/analysis.json.
Escribe docs/style_guide.md siguiendo las notas de la guía de estilo, luego docs/shotlist.md para una película de <S> s
sobre <tema> en ese estilo, sobre la rejilla de ritmo de audio/beats.json (o <BPM> BPM si no existe).
Toma la gramática de la referencia, nunca su contenido, logotipos, personajes o texto.
Devuelve preguntas en lugar de suponer.

Las notas sección por sección están en assets/style-guide-notes.md. Para usuarios que quieran pegar un prompt en una sesión nueva, los mismos pasos están escritos como assets/reference-prompt.md.

4. Toma la gramática, nunca el contenido

TomaNunca tomes
relaciones de paleta (fondo oscuro, un acento cálido, proporción del acento)logotipos, personajes, mascotas
familias tipográficas por clase, peso, tracking, saltos de escalacomposiciones o fotogramas exactos
duraciones de toma y dónde caen los cortes contra el ritmoel texto, afirmaciones o datos de la referencia
tipos de transición (corte duro, barrido con máscara, corte por correspondencia)su metraje, música o voz
lenguaje de cámara (acercamientos, barridos panorámicos, planos fijos)formas específicas de marca o imagen corporativa
textura (cantidad de grano, papel, semitonos) y cómo el texto entra y salecualquier cosa que el usuario no haya pedido tomar prestada

5. La compuerta

Muestra ambos archivos (un resumen compacto de la guía de estilo y la tabla de la lista de tomas es suficiente) y espera la aprobación del usuario antes de cualquier código de producción. Cuando lo rechace, reescribe la lista de tomas (y la guía de estilo si la apariencia es incorrecta), nunca parchees código para "mostrar en su lugar". Registra la decisión en la línea Estado: al inicio de docs/shotlist.md.

6. Deja que el modelo elija la técnica

Especifica la apariencia y las restricciones, no la biblioteca. Pleometric sugirió p5.js y Opus escribió su propio renderizador de papel en su lugar. Dentro de este estudio, esto significa: describe la textura y el movimiento que deseas en la guía de estilo, y deja que la compilación elija cómo dibujarlo en el motor de lienzo (helpers de lib/draw.js o dibujo personalizado). Nombra un framework solo cuando el usuario lo necesite para reutilización (ruta B, /motion-studio:seek-engine).

Siguiente: construye con /motion-studio:motion-reel desde su etapa 5; para un bucle de estado de UI en este estilo, /motion-studio:ui-morph-spec.

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

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