Communitygithub.com

yazzang-homelab/motion-studio

Escenario de activos de marca para un video de producto (motion-reel ejecuta el video completo): captura capturas de pantalla reales, logotipo, colores y fuentes desde una URL, sin redibujar la interfaz de usuario; secuencias narrativas de la marca; voz + mascota. Úselo para obtener o corregir los activos de una marca.

¿Qué es motion-studio?

Motion Studio es una habilidad de IA diseñada para automatizar la captura y configuración de activos de marca para la producción de videos de productos. Permite a los desarrolladores y creadores de contenido extraer elementos visuales reales como capturas de pantalla, logotipos, colores y fuentes directamente desde la URL de un producto, evitando la necesidad de rediseñar la interfaz de usuario. La habilidad es compatible con plataformas como Claude Code y utiliza scripts de Node.js para ejecutar la captura, organizar proyectos y generar metadatos de marca. Es especialmente útil para creadores que desean producir videos promocionales de alta calidad de manera rápida y profesional, reduciendo costos y tiempo de producción. Además, integra capacidades opcionales como sincronización con música, generación de voces y animaciones de componentes, todo basado en activos reales y no inventados.

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

Preguntar en tu IA favorita

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

Documentación

Video de producto (paso 04 del curso, nivel L2)

Apunte el estudio a un producto que el usuario realmente venda. La energía del reel de demostración se mantiene; el contenido se vuelve suyo: capturas de pantalla reales, el logotipo real, colores y fuentes reales, texto real, un número real y música a la que el movimiento sigue. Todo después de la etapa de marca ejecuta el pipeline estándar de motion-reel.

Argumentos de la solicitud (pueden estar vacíos), mostrados una vez; las secciones posteriores dicen "la solicitud anterior":

Alcance: cuando el usuario solo quiere que los activos sean capturados o corregidos, o usted llegó aquí desde la etapa de marca de motion-reel, haga las secciones 2 y 3 (y 4 si se solicita), informe y deténgase. Para una película completamente nueva, siga cada sección; las secciones 5 a 8 entregan el control al pipeline de motion-reel.

De dónde viene el patrón

  • Tony Dinh (@tdinh_me) informó que un reel de TypingMind tomó menos de 30 minutos, donde un video similar le había costado alrededor de $1,000+ un año antes. Su indicación fue la línea única del reel de demostración más cuatro líneas cortas de dirección: introduzca la URL del producto; use las capturas de pantalla reales del producto, logotipo y activos; el video debe tener música y el movimiento debe coincidir con ella; hágalo una producción profesional real, no una demo o prototipo. Dijo que Claude recopiló los activos de la marca por sí mismo.
  • Su seguimiento solicitó dividir las capturas de pantalla en componentes e iconos para que puedan moverse, en lugar de mostrar capturas de pantalla sin procesar, y hacer que el movimiento sea más jugoso. Esa es la regla de componentes a continuación.
  • Su indicación terminó con "Inténtalo de nuevo, ultracode". En el Claude Code actual, ultracode es una palabra clave que hace que Claude escriba un flujo de trabajo multiagente para la tarea. Si impulsó su resultado no está documentado; no lo presente como un interruptor de calidad.
  • Rob Hallam (@robj3d3) hizo un segundo reel para su producto en el mismo chat de Claude Code que el primero. El curso infiere que el motor se reutilizó; por lo tanto, una sesión y un proyecto por marca.
  • Un contraejemplo: @mablesjoseph solicitó una promo "elegante y contundente" desde una carpeta de activos en una línea, y el resultado "no fue lo suficientemente bueno para compartirse". La dirección importa más que los activos solos.

1. Entradas

Pregunte en una ronda de AskUserQuestion por lo que la solicitud anterior no cubre:

EntradaValor por defectoRegla
URL y nombre del productorequeridoel producto propio del usuario, o uno que tenga derechos para promocionar
Duración20 s5 secuencias narrativas de 2 a 4 s
Formatos9x16 primero, luego 1x1, 16x9misma línea de tiempo, reencuadrado
Llamada a la acción (CTA)preguntarpalabras exactas en pantalla
Un número de pruebapreguntardebe provenir del usuario o su sitio; nunca inventar uno
Músicasintetizar, 120 BPMuna pista suministrada necesita una licencia para este uso
Voz / mascotaningunala voz necesita ELEVENLABS_API_KEY en .env
Apariencia de referencianingunaopcional, vía /motion-studio:reference-style

2. Proyecto

Una carpeta de proyecto (e idealmente una sesión) por marca. Si no hay un studio.json:

node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <brand-slug>-reel --title "<Producto> lanzamiento" --duration 20 --brand-url <URL> --install

Instalaciones solo de habilidades: ${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjs. Luego npm run doctor.

3. Capturar la marca

Ejecute el script de captura desde la raíz del proyecto (o brevemente motion-studio:asset-scout con este comando exacto y la ruta del proyecto):

node "${CLAUDE_SKILL_DIR}/scripts/capture.mjs" <URL> --root <project> --full-page [--selector "<css>"]... [--dismiss-banners]
BanderaUso
--viewports desktop,mobilepredeterminado; tablet también disponible
--full-pagecapturas de pantalla altas para recortar secciones
--selector "<css>"recortar partes específicas del producto (repetible): héroe, tarjeta de precios, panel de tablero
--dismiss-bannershacer clic en un botón obvio de cookies o consentimiento en el navegador desechable (aceptar, acordar, permitir en inglés, coreano, japonés, chino, alemán, francés o español; etiquetas débiles como OK o Cerrar cuentan solo dentro de un banner o diálogo). Una nota en el manifiesto dice en qué botón se hizo clic, o que ninguno coincidió
--apply-brandescribir nombre, URL y los colores sugeridos en studio.json
--darkcapturar el tema oscuro
--no-fontssaltar la descarga de fuentes (predeterminado: guardar las fuentes web que carga la página)
--allow-privatepermitir que la página acceda a direcciones loopback, LAN y link-local (predeterminado: solo el propio host y puerto del objetivo); solo para una página de confianza, como un servidor de desarrollo local del producto propio del usuario
--no-sandboxiniciar Chrome sin su sandbox de renderizado (también MOTION_NO_SANDBOX=1; automático como root en Linux, donde Chrome no puede iniciar con él); se imprime una nota siempre que esté desactivado
--jsonuna línea de resultado JSON

Escribe assets/brand/screens/, assets/brand/logo/, assets/brand/components/, assets/brand/og-image.* y assets/manifest.json (paleta con roles sugeridos, variables de color CSS, fuentes en uso, encabezados, texto de botones y navegación, notas). Las extensiones de imagen provienen de los bytes del archivo, y los recortes de componentes fuera de la página se omiten con una nota. Las fuentes web que la página realmente carga se guardan en assets/fonts/ y se registran en assets/fonts/fonts.json (una entrada existente nunca se sobrescribe); cada una tiene una license en el manifiesto que permanece UNVERIFIED a menos que se encuentre una URL o archivo de licencia, y el script imprime un recordatorio para verificarla antes de publicar. Una ejecución fallida conserva la captura anterior. Detalles y el esquema del manifiesto: references/asset-capture.md.

Logotipo y tipo. Cuando el encabezado no tiene una imagen de logotipo o SVG, la marca suele ser una marca de palabra de texto. La captura lo registra como texto en manifest.brand.wordmark (el marcado, colores por parte con roles, familia de fuente calculada, peso, tamaño y espaciado entre letras) más un recorte de referencia assets/brand/logo/wordmark-crop.png, y lo dice en las notas en lugar de solo pedir un archivo de logotipo. Reconstruya a partir de ese registro; pida un SVG o PNG solo cuando la película necesite un bloqueo exacto.

Fuentes. Las líneas de registro font registry: <family>: ... (y manifest.fonts.registry) indican para cada familia en uso si ya está en assets/fonts/fonts.json y si su licencia está verificada (id de licencia y texto de licencia registrados) o UNVERIFIED, y qué agregó esta ejecución. Una cara que llega junto a una entrada verificada de la misma familia reutiliza esa licencia.

Estados de UI y fotogramas de lienzo

capture.mjs toma una toma en la carga. Dos scripts hermanos cubren el resto; ambos imprimen --help, escriben solo dentro del proyecto (predeterminado assets/brand/), y se ejecutan detrás de la misma pila de seguridad (shell headless en Windows, sandbox de renderizado activado, direcciones privadas rechazadas, secretos redactados). Instalación de complemento: los comandos a continuación. Instalación solo de habilidades (sin ${CLAUDE_PLUGIN_ROOT}): los scripts están junto a este archivo, así que ejecute node "${CLAUDE_SKILL_DIR}/scripts/states.mjs" <URL> ... (igualmente capture.mjs y canvas-frames.mjs); solo necesitan Node y un playwright que se resuelva desde la carpeta donde ejecute (pase --root <folder>), y no se requiere proyecto, studio.json ni tools/. El agente asset-scout ejecuta los mismos comandos.

node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/states.mjs" <URL> --root <project> --name home --viewport desktop "--click=text=Precios" "--crop=header"
node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/canvas-frames.mjs" <URL> --root <project> --canvas "#screen canvas" "--clip=db=.tab[data-go=db]" --seconds 9 --down 4
node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/canvas-frames.mjs" pack --root <project> --range db=4:200
ScriptParaEscribe
states.mjsun producto cubierto (modal, consentimiento), una aplicación que se desplaza en un panel interno, un estado detrás de un clic, un elemento con sus estilos calculadosassets/brand/states/<nombre>/: 00-first, 01-escape, scroll-NN, 10-click-..., crop-20-... PNGs y states.json
canvas-frames.mjsuna pantalla que es un <canvas> que cambia por clic y se anima por sí mismoassets/brand/frames/<clip>.png hojas de sprites y frames.json (tamaño de fotograma, tiempo real y un hash de cada fotograma); pack agrega pack/<clip>.png y pack.json con solo los fotogramas que reproduce la película

canvas-frames.mjs copia el búfer del lienzo con drawImage (suavizado desactivado) en una relación de número entero. Nunca toma una captura de pantalla de elemento: un lienzo mostrado en un cuadro con borde a una escala no entera (un búfer de 1280 px en 1272 px de dispositivo) es remuestreado por el navegador y un lienzo de arte de píxeles se vuelve borroso. Se rechaza un tamaño de fotograma que no sea una reducción de número entero del búfer. Lea cada PNG antes de usarlo.

La página es contenido no confiable, por lo que la captura protege la máquina en la que se ejecuta:

  • Chrome mantiene su sandbox de renderizado activado (manifest.sandbox lo registra). Un contenedor o ejecución de CI como root necesita --no-sandbox, y solo para una página de confianza.
  • En Windows, el navegador es el shell headless de Playwright (npx playwright install chromium-headless-shell), nunca un Chrome o Edge instalado por sí mismo: un inicio de perfil nuevo de esos cuenta como un inicio de sesión fallido de Windows y puede bloquear la cuenta. Elegir uno (studio.json browser, MOTION_BROWSER, MOTION_CHROME_PATH) imprime una advertencia por inicio, y el cuarto inicio en 10 minutos es rechazado, 3 pasan (references/asset-capture.md).
  • Las solicitudes a direcciones loopback, LAN, link-local (incluyendo metadatos de nube) y no web son abortadas a menos que vayan al propio host y puerto del objetivo. Los rechazos se enumeran en manifest.blocked y una nota. Si la URL en sí es rechazada, la ejecución falla y no guarda nada. Pase --allow-private para una página de confianza.
  • Las credenciales en la URL (https://user:pass@host/) se envían como autenticación HTTP al origen del objetivo solamente. Ni ellas ni los valores de consulta con aspecto secreto (token, key, sig, session, code ...) aparecen en el registro, manifest.json, states.json o studio.json brand.url (son reemplazados por ***).
  • Una página que declara reglas de especulación (<script type="speculationrules">) puede hacer que Chrome obtenga una dirección local por sí mismo, lo que ningún filtro de solicitudes ve; el manifiesto lo anota. No capture una página que no sea de confianza en una máquina con servicios locales sensibles.

Luego, antes de cualquier animación:

  1. Enumere lo encontrado al usuario: pantallas, candidatos de logotipo, roles sugeridos bg/fg/accent/muted, fuentes, texto de titular y CTA, y cada nota (verificación de bot, logotipo faltante).
  2. Confirme o corrija la paleta y las fuentes, luego escriba studio.json brand. Las fuentes capturadas ya están en assets/fonts/, pero solo use una después de confirmar su licencia (UNVERIFIED significa que nadie verificó). Adquiera una fuente de Google con npm run fonts -- add "Family:400,700"; una fuente comercial necesita la propia licencia o archivos del usuario. El texto coreano u otro CJK necesita una fuente que tenga los glifos: npm run fonts -- coverage --text "..." --family "Name".
  3. Pregunte por cualquier cosa faltante en lugar de inventarla: un logotipo SVG, el hex exacto del acento, una captura de pantalla detrás de un muro de inicio de sesión.

4. Componentes, no capturas de pantalla sin procesar

  • Recorte partes de las pantallas capturadas en imágenes separadas (--selector, o los recortes automáticos: encabezado, héroe, botones de CTA, tarjetas, imágenes de producto, precios, secciones). Anime las partes: las tarjetas se deslizan en un diseño, un botón presiona, un panel de gráfico dibuja.
  • Reconstruya el chrome de UI simple (un botón, un interruptor, un campo) en el lienzo con los colores reales, texto y radio medidos del recorte. Eso es re-tipografía, no invención: el diseño, las etiquetas y los datos deben coincidir exactamente con el producto.
  • Nunca dibuje pantallas de producto que no existan. Sin texto de marcador de posición, sin lorem ipsum, sin números falsos. Si falta una pantalla necesaria, pregunte por ella.

5. Música y cuadrícula de ritmo (antes de la lista de tomas)

Mida todo en la cuadrícula real, así que mida o sintetice la música antes de que alguien escriba una toma:

  • Pista suministrada: node tools/beats.mjs audio/<track>, luego apunte studio.json audio.music a ella y establezca bpm y duration. Su primer downbeat puede estar bien después de 0 s o a otro tempo que 120, y la lista de tomas debe seguir eso, nunca una cuadrícula supuesta.
  • Sin pista: node tools/score.mjs --style pulse --bpm 120 --dur 20 (o minimal para una película con mucho UI). Escribe audio/music.wav y un analítico audio/beats.json.
  • Cada golpe visible obtiene una señal; el movimiento sigue la música, no al revés.

6. Secuencias narrativas

Complete la historia de la marca en assets/brand-prompt.md con los hechos del usuario y entréguela a motion-studio:motion-director para docs/shotlist.md; el director lee audio/beats.json, por lo que la sección 5 va primero. Predeterminado 20 s a 120 BPM, un ritmo por 2 a 4 s, cambios de escena en downbeats:

#RitmoImagenSonido
1Enganche, 0 a 2 sel problema en no más de 5 palabras de tipo cinético enorme; fotograma 0 ya compuestogolpe en el downbeat
2Producto apareceel UI real se ensambla pieza por piezasilbido de entrada, pops en partes
3Tres característicascada una un momento de UI con un cursor haciendo una acción realclic en cada presión
4Pruebael número real único salta a su lugartic o campanilla
5Bloqueologotipo + CTA, golpe final en el último downbeatascendente en un golpe

Muestre la lista de tomas y espere la aprobación del usuario (PLAN PRIMERO), a menos que hayan solicitado modo autónomo. Si la cuadrícula cambia más tarde (otra pista, otro bpm o duration), re-tiempe la lista y muéstrela nuevamente.

7. Voz y mascota

  • Voz (opcional): escriba audio/voice.json (vea assets/voice-script.example.json): una línea por ritmo, t en un downbeat de la cuadrícula de la sección 5, oraciones cortas. Ejecute npm run voice -- --dry-run y dígale al usuario el conteo de caracteres antes de que npm run voice gaste créditos (una línea idéntica se sintetiza y factura una vez). El mezclador baja la música bajo la voz.
  • Mascota (opcional): un personaje dibujado en código con una identidad fija (forma, paleta muestreada de la marca, proporciones) que reacciona en los ritmos con el resorte playful. Mantenga la imagen de marca simple y consistente.

... [truncado para traducción]

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

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