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,
ultracodees 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:
| Entrada | Valor por defecto | Regla |
|---|---|---|
| URL y nombre del producto | requerido | el producto propio del usuario, o uno que tenga derechos para promocionar |
| Duración | 20 s | 5 secuencias narrativas de 2 a 4 s |
| Formatos | 9x16 primero, luego 1x1, 16x9 | misma línea de tiempo, reencuadrado |
| Llamada a la acción (CTA) | preguntar | palabras exactas en pantalla |
| Un número de prueba | preguntar | debe provenir del usuario o su sitio; nunca inventar uno |
| Música | sintetizar, 120 BPM | una pista suministrada necesita una licencia para este uso |
| Voz / mascota | ninguna | la voz necesita ELEVENLABS_API_KEY en .env |
| Apariencia de referencia | ninguna | opcional, 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]
| Bandera | Uso |
|---|---|
--viewports desktop,mobile | predeterminado; tablet también disponible |
--full-page | capturas de pantalla altas para recortar secciones |
--selector "<css>" | recortar partes específicas del producto (repetible): héroe, tarjeta de precios, panel de tablero |
--dismiss-banners | hacer 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-brand | escribir nombre, URL y los colores sugeridos en studio.json |
--dark | capturar el tema oscuro |
--no-fonts | saltar la descarga de fuentes (predeterminado: guardar las fuentes web que carga la página) |
--allow-private | permitir 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-sandbox | iniciar 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 |
--json | una 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
| Script | Para | Escribe |
|---|---|---|
states.mjs | un 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 calculados | assets/brand/states/<nombre>/: 00-first, 01-escape, scroll-NN, 10-click-..., crop-20-... PNGs y states.json |
canvas-frames.mjs | una pantalla que es un <canvas> que cambia por clic y se anima por sí mismo | assets/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.sandboxlo 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.jsonbrowser,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.blockedy una nota. Si la URL en sí es rechazada, la ejecución falla y no guarda nada. Pase--allow-privatepara 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.jsonostudio.jsonbrand.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:
- 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). - Confirme o corrija la paleta y las fuentes, luego escriba
studio.jsonbrand. Las fuentes capturadas ya están enassets/fonts/, pero solo use una después de confirmar su licencia (UNVERIFIEDsignifica que nadie verificó). Adquiera una fuente de Google connpm 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". - 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 apuntestudio.jsonaudio.musica ella y establezcabpmyduration. 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(ominimalpara una película con mucho UI). Escribeaudio/music.wavy un analíticoaudio/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:
| # | Ritmo | Imagen | Sonido |
|---|---|---|---|
| 1 | Enganche, 0 a 2 s | el problema en no más de 5 palabras de tipo cinético enorme; fotograma 0 ya compuesto | golpe en el downbeat |
| 2 | Producto aparece | el UI real se ensambla pieza por pieza | silbido de entrada, pops en partes |
| 3 | Tres características | cada una un momento de UI con un cursor haciendo una acción real | clic en cada presión |
| 4 | Prueba | el número real único salta a su lugar | tic o campanilla |
| 5 | Bloqueo | logotipo + CTA, golpe final en el último downbeat | ascendente 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,ten un downbeat de la cuadrícula de la sección 5, oraciones cortas. Ejecutenpm run voice -- --dry-runy dígale al usuario el conteo de caracteres antes de quenpm run voicegaste 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]