Communitygithub.com

film-build

Construye un filme de producto en código como una página web determinista seek(t) (UI real, chrome real del SO, texto cinético, prompts escritos, cursor, morphs y movimientos de cámara), revísalo como fotogramas fijos y borradores, renderiza a 60 fps con motion blur y adáptalo a 9:16 sin cambiar el 16:9. Incluye un kit de proyecto (init.sh, motor de filme, herramientas de render/sync/probe/sheet/regression). Etapas 3 y 6 de product-film. Úsalo al construir, corregir o renderizar el metraje de un filme de lanzamiento/promocional, o al hacer su versión vertical.

¿Qué es film-build?

Este skill permite crear un filme de producto completamente mediante código, como una página web determinista que se puede buscar en el tiempo (seek(t)). Es útil para desarrolladores y agentes de IA que necesitan construir, corregir o renderizar metraje promocional de lanzamiento, garantizando que cada fotograma sea reproducible y consistente. Compatible con herramientas de línea de comandos (Node.js, Playwright, Python) y navegadores modernos. Proporciona un motor de filme con escenas, helpers de animación (cámara, texto escrito con teclado, cursor realista, sprites de personajes), y un flujo de revisión basado en fotogramas fijos y borradores antes del render final. También incluye herramientas para adaptar el filme a formato vertical 9:16 sin modificar la versión 16:9, como se describe en el SKILL.md.

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/aqeelshamz/product-film-skills/tree/HEAD/film-build

Preguntar en tu IA favorita

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

Documentación

Film build (Construcción de filme)

Inicio

sh ~/.claude/skills/film-build/kit/init.sh marketing/videos/<film>   # rechaza si la carpeta no está vacía
cd marketing/videos/<film> && npm i && npx playwright install chromium   # si dice NEXT

El kit te proporciona:

ArchivoQué es
film/core.jsel motor: scene({name, from, to, build, run, after}) (tiempos en beats = s × 2), put(el, {o, css}), reg(el, base), C.W/C.H/C.FMT, C.start()
film/film.jsun iniciador con todos los helpers de abajo y cuatro planos de ejemplo (línea, prompt, split, tarjeta de persona). El comentario de cada helper dice de qué rechazo vino. Reemplaza los planos, conserva los helpers.
film/mock.jswindow.MOCK: HTML para piezas reales de UI (paneles, ventanas, pantallas de teléfono), en px de pantalla
film/index.htmlcarga fuentes desde assets/fonts/{display,ui}.woff2 (con fallbacks sans locales)
scripts/render.mjs--sheet, --at t1,t2, --draft, --range a,b, --verify, final, --mux, --fmt 9x16, --all
scripts/sync.mjscopia timeline.json en la página
scripts/review.pykit de crítica a partir del MP4 renderizado: hoja de contactos, tiras de acción más rápida, vista de teléfono, zonas seguras 9:16, métricas
tools/probe.mjscuts (cada corte y el punto medio de cada plano, en segundos de video) o cualquier expresión, ej. "window.UNWARP(12.4)"
tools/sheet.pyorganiza fotogramas fijos en una sola hoja etiquetada
tools/pack_grid.pyrecorta una hoja de personajes de 4×3 (transparente o sobre blanco) en una tira de 12 celdas para sprite(); imprime el tamaño de celda
tools/cut_cast.pyrecorta una fila de personajes en figuras individuales fijas
assets/characters/cuatro personajes de ejemplo (fundador, dev, vendedor, estudiante), tiras de 12 fotogramas con celdas de 360 px
tools/same.shsave / check regresión PSNR entre fotogramas fijos de antes y después

Helpers en el iniciador (úsalos, no reinventes)

  • io (quintic in-out) para movimientos de cámara y morphs; oq (quint-out) para entradas; back para un pequeño sobrepaso.
  • cam(e, s, fx, fy) coloca el punto de enfoque (fx, fy) de un plano de 1920×1080 en el centro del fotograma con escala s. camD hace lo mismo pero nunca muestra más allá de los bordes del plano (escala de cobertura; esencial en 9:16).
  • posIn(e, root) lee la posición de un elemento dentro del plano en movimiento (para destinos del cursor, seguimiento del caret).
  • typed() para palabras que aparecen letra por letra en una línea; keyed() para un teclado real: temporización irregular por carácter, pausas más largas en espacios, un caret parpadeante después. wordsHTML() coloca cada palabra en su ancho final desde el primer fotograma, transparente hasta su momento, para que la línea nunca se reajuste ("la transición de texto no es nada suave").
  • cursor()/putCursor()/bump(): un cursor de flecha real que se desliza, llega temprano, se hunde 15 % al hacer clic.
  • pop() para elementos pequeños que aparecen.
  • sprite(parent, src, cellW, cellH, h) / putSprite(e, t, a, z, loops) para un personaje dibujado: recorre sus 12 fotogramas de a a z, con una pequeña respiración para que nunca esté quieto. Es un <img>, por lo que el motor espera por él.
  • shot(name, t0, t1, build, run) envuelve scene en segundos.
  • Warp de ritmo al final: SLOW (estiramiento global), EV mantiene (congela un momento para lectura) e inserciones; window.CUTS y window.UNWARP dan tiempos de video para ubicación de sonido y voz.
  • PT / pk(a16, a9) elige valores por formato en un solo archivo.

Reglas del motor (determinismo)

El filme es una función pura de t. Cualquier fotograma debe pintarse igual tanto si se renderiza primero como después de cualquier otro fotograma.

  • Solo transformaciones 2D: nada de translate3d, will-change, transiciones CSS, Math.random (usa un hash de un índice).
  • Elementos ocultos al inicio: reg(el, {o: 0}), nunca opacity:0 en línea.
  • Mide el diseño en after() o una vez en build, nunca dentro de run (lee el fotograma anterior).
  • Vistas 3D: reinserta cada fotograma con insertBefore(v, firstChild) para que no sobreviva ningún raster en caché.
  • Animaciones CSS incrustadas (ej. el widget de un producto): pausa y establece animation-delay: calc(-1s * var(--t)).
  • Espera imágenes y fuentes (decode(), document.fonts.ready) antes del primer fotograma.
  • Limita el CSS del producto bajo una clase raíz única; usa nombres de clase únicos en el filme (.w se filtró una vez).
  • classList.add, nunca className =.
  • node scripts/render.mjs --verify debe imprimir 12/12 antes de cualquier render que envíes.

Realismo: lee references/realism.md antes de construir cualquier pantalla

Versión corta: apps reales a densidad real, logos reales de sitios propios de las marcas, chrome del SO con apps que existen en ese SO, fondos de pantalla reales, teléfonos en la cuadrícula real del launcher a tamaños dp reales dibujados por el propio renderizador del producto, UI del producto más rica de lo que crees necesaria, una línea de uso nominativo cada vez que aparece una marca.

Bucle de construcción (guiado por revisión)

  1. Lista de planos del storyboard aprobado en film.js, un shot() cada uno, superpuestos para traspasos.
  2. Primero fotogramas fijos. node tools/probe.mjs cuts → renderiza un fotograma fijo en cada punto medio de plano y en cada traspaso: node scripts/render.mjs --at … luego python3 tools/sheet.py review/stills/16x9 review/sheet.jpg <times>. Lee tú mismo la hoja. Corrige. Repite. (Unos 1–2 min por vuelta, vs 25+ para un render completo).
  3. Pase de control de calidad ANTES de cualquier revisión que envíes: recorre el filme a ≤ 1.5 s y en cada traspaso (hoja de contactos de 10–15 fps sobre cada transición). Revisa references/qa.md línea por línea: solapamientos, recortes, fotogramas en blanco, tiempo de lectura, suavidad del texto, escritura, aviso de logo, realismo del SO, tamaños de teléfono.
  4. Envía fotogramas fijos (la hoja) al propietario para la primera verificación. Espera.
  5. Borrador: node scripts/render.mjs --draft (30 fps, ~4 min), python3 scripts/review.py 1 --draft, lee las tiras. Envía el MP4 borrador. Di claramente que es un borrador de 30 fps sin desenfoque (se ve más entrecortado que el final).
  6. Al "render final": node scripts/render.mjs en segundo plano (60 fps, motion blur; ~25–35 min para 60 s). Nunca edites film.js mientras renderiza: copia primero el proyecto si necesitas seguir trabajando.
  7. Haz commit del código del filme y de la línea de tiempo después de cada ronda aprobada.

Ritmo

Los primeros cortes casi siempre son demasiado rápidos. El texto en pantalla necesita aprox. 0.3 s por palabra + 1 s a opacidad completa (nunca menos de 1.5 s). Prefiere el warp (SLOW 1.1–1.25, EV mantiene en líneas) a reajustar cada plano. Después de cualquier cambio de ritmo, vuelve a ejecutar probe.mjs cuts porque las posiciones de sonido y voz se mueven.

9:16: lee references/formats.md

Reencuadra el mismo filme en un archivo con pk(); prueba que el 16:9 no cambia con tools/same.sh (cada fotograma fijo PSNR = inf); --verify --fmt 9x16; hoja de fotogramas para el propietario; luego final --fmt 9x16 en segundo plano, luego --mux --fmt 9x16.

Individual skills in this repo

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

film-sound

Add sound to a finished product-film picture with real recorded sound effects (CC0 packs such as Kenney's) placed only on real on-screen events, decide with the owner whether there's a music bed, mix to -14 LUFS and mux into the renders without re-rendering. Stage 4 of product-film. Use when a film's picture is approved and needs sound effects or music, or when the owner says the sounds feel fake, synthetic or "AI slop".

film-storyboard

Write the story of a product film as beats (what the viewer sees, the words on screen, the voice, the sound, why the beat exists, and where each claim is proven) and send it to the owner as a one-page storyboard with frames for review, with 2–4 directions when the story is open. Stage 2 of product-film, and the review format reused for the voiceover. Use when planning a launch/promo film's story, shot list, or script, or when the owner says "give me a storyboard", "give me directions", "I'll review and decide".

film-voiceover

Write, review, test and record the voiceover for a product film after its picture is approved, as a script on a storyboard of the film's real frames, with directions to choose from, an eyes-closed coherence check, a pronunciation test for the product name, TTS recording per section (Fish Audio), phrase placement on the film's timeline, mixing and muxing. Stage 5 of product-film. Use when a launch/promo film needs narration, or the owner says the voiceover sounds like AI, doesn't match the frames, or mispronounces the name.

product-film

Make a product launch / promo / explainer film that sells and does not look or sound AI-made, through review gates the owner signs off one at a time. Study a reference video for its grammar (never copy it), then storyboard, build the film in code, add sound, write and record the voiceover, and deliver 16:9 and 9:16. Use when someone wants a launch video, promo, product film, explainer, ad, "a video like this one" for their product, or says the last video looked like "AI slop" or "vibe coded". Entry point for the film-* skills (film-reference-study, film-storyboard, film-build, film-sound, film-voiceover).

Skills relacionados