Communitygithub.com

product-film

Crea un video de lanzamiento, promoción o explicación de producto que venda y no parezca ni suene generado por IA, mediante revisiones paso a paso que el propietario aprueba una a una.

¿Qué es product-film?

Product-film es una habilidad para agentes de IA que automatiza la producción de videos promocionales de alta calidad, evitando el aspecto y sonido artificial típicos de contenido generado por IA. El proceso se estructura en ocho etapas (Brief, Referencia, Storyboard, Imagen, Sonido, Voz en off, Formatos y Entrega), cada una con una puerta de revisión que el propietario del producto debe aprobar explícitamente antes de avanzar. La habilidad impone reglas estrictas de realismo, especificidad y determinismo: cada elemento mostrado debe existir en el producto real, los logos y recursos deben ser auténticos, y se debe generar un archivo de verificación (`render.mjs --verify`) antes de cada render. Está diseñada para integrarse con las habilidades complementarias `film-reference-study`, `film-storyboard`, `film-build`, `film-sound` y `film-voiceover`, y se ejecuta mejor en asistentes de codificación como Claude Code, Cursor o Codex que puedan manejar la lógica de renderizado en Node.js. La salida final son archivos MP4 en 16:9 y 9:16, con créditos, licencias y una lista de verificación de lo que no se ha podido comprobar.

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

Preguntar en tu IA favorita

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

Documentación

Video de producto

Un video de producto lo juzga primero una sola persona: el propietario. Corrige lo que está mal, tú lo arreglas, y el video mejora ronda a ronda. Esta habilidad existe para que las correcciones del propietario sean innecesarias: cada regla aquí proviene de una corrección que alguien tuvo que hacer a mano. Lee references/lessons.md antes de empezar, y de nuevo antes de cada revisión que envíes. Es el registro de lo que los propietarios rechazaron y por qué.

El pipeline y sus puertas

Nada pasa a la siguiente etapa hasta que el propietario haya aprobado la actual. La aprobación es un sí claro en el chat, no silencio ni "se ve bien pero…". Después de cualquier cambio que el propietario solicite, envíalo de nuevo a revisión.

EtapaHabilidadEnvías a revisiónPuerta
0 · Briefestael brief: producto, comprador, la única cosa que debe convencer, duración, formatos, dónde se reproduciráel propietario aprueba el brief
1 · Referenciafilm-reference-studylo que hace la referencia y qué tomar prestado, como números y fotogramasel propietario acepta qué se toma y qué no
2 · Storyboardfilm-storyboarduna página de storyboard: un fotograma por beat, palabras en pantalla, por qué está cada beat; 2–4 direcciones si la historia está abiertael propietario elige una dirección y aprueba los beats
3 · Imagenfilm-buildprimero fotos fijas, luego un borrador a 30 fps, nunca un render final primeroel propietario aprueba la imagen ("render final")
4 · Sonidofilm-soundel final con efectos de sonido y la decisión de músicael propietario aprueba el sonido
5 · Voz en offfilm-voiceoverel guion sobre un storyboard de fotogramas REALES, luego pruebas de nombre, luego el corte con vozel propietario aprueba el guion, la pronunciación y luego el corte
6 · Formatosfilm-build (formatos)fotos fijas en 9:16, luego el render en 9:16el propietario aprueba; 16:9 demostrablemente sin cambios
7 · Entregaestalos archivos, subtítulos, créditos, lo que no está verificadohecho

"Antes de renderizar, déjame revisar": el propietario quiere ver el plan y las fotos fijas antes de que gastes 30 minutos en un render. Un render final sin un borrador aprobado es tiempo perdido y erosiona su confianza.

Cómo preguntar (cada puerta)

En cada puerta, plantea opciones concretas en lugar de preguntas abiertas, y haz que cada opción sea algo que un editor real elegiría. Las opciones genéricas ("moderno", "limpio", "dinámico") son cómo un video se convierte en basura de IA. references/question-bank.md tiene las preguntas y opciones para cada etapa: aspecto, movimiento, ritmo, transiciones, escritura, personajes, sonido, música, voz, entrega. Reglas:

  • Dos a cuatro opciones por pregunta, cada una con cómo se ve o suena y su coste o riesgo. Pon tu elección primero y di por qué en una línea.
  • Pregunta solo lo que cambia el trabajo. Decide el resto a partir de la marca y la referencia, y di lo que decidiste.
  • Cuando el propietario hable en voz alta sobre ideas, no implementes cada frase. Investiga, luego vuelve con 2–4 direcciones y sus compensaciones, y deja que elija ("dame algunas direcciones con sus compensaciones para que pueda decidir").
  • Cuando el propietario diga "espera, te diré más", detente y espera. No sigas editando.
  • Cuando llegue una corrección, encuentra la regla detrás de ella y revisa todo el video en busca del mismo error, no solo el punto que señalaron.

Reglas que se aplican en cada etapa

  1. Solo real. Cada función, widget, pantalla, fuente de números y afirmación en el video funciona en el producto hoy. Si el video necesita algo que el producto no puede hacer, constrúyelo en el producto (y registra la decisión) o elimínalo. Cada afirmación hablada o mostrada tiene una fuente a la que puedas señalar (un archivo, un documento, una prueba).
  2. Específico, no genérico. Logos reales de los sitios web de las marcas. Cromo real del SO con aplicaciones que realmente existen en ese SO. Tamaños de dispositivo reales. Fondos de pantalla reales (con licencia). Interfaz de usuario rica y detallada: "demasiado simple" se lee como "¿por qué pagaría por esto?". Consulta film-build/references/realism.md.
  3. El punto de vista del espectador. El video es para un desconocido que nunca ha oído hablar del producto. Prueba cada beat: ¿lo entenderían? ¿Podrían malinterpretarlo (por ejemplo, pensar que el producto ES la IA)? ¿Trata sobre su vida o sobre nuestras funciones?
  4. No hecho por IA. Sin pitidos sintéticos, maquetas mínimas, imitaciones de fuentes de iconos de marcas reales, tríadas y textos de "tu X, tu Y", ni voz en off que describa la escena. Los propietarios conocen estas señales, y también sus compradores. Un competidor fue criticado públicamente por un video de lanzamiento que parecía "hecho con Claude".
  5. Legible y fluido. Cada línea se mantiene el tiempo suficiente para leerla hasta el final. La escritura parece de un teclado. Nada se corta, superpone o parpadea vacío. Ritmo para humanos: los primeros cortos casi siempre son demasiado rápidos.
  6. Determinismo. El video es una función pura del tiempo; render.mjs --verify debe pasar antes de cualquier render que envíes.
  7. Informes pequeños y honestos. Cuando envíes una revisión, di qué cambió, qué sigue abierto y qué no pudiste comprobar (no puedes escuchar el audio: dilo y pregunta). Nunca digas que algo está verificado si no lo comprobaste.
  8. Confirma a menudo (código, scripts, storyboard, guion de VO). Los renders, el audio y las fotos fijas quedan fuera de git.

Estructura del proyecto

<film>/
  brief.md                 etapa 0
  reference/               salida del estudio (fotogramas, hojas, summary.md, NOTES.md)
  storyboard.json          fuente etapa 2 → review/storyboard.html
  film/                    la página del video (core.js, film.js, mock.js, index.html)
  scripts/ tools/          render, sync, sound, voice, mix, probes (del kit de film-build)
  timeline.json vo.json    tiempo de imagen y señales de sonido; frases de voz en off
  VO-SCRIPT.md             la voz en off aprobada con de dónde viene cada afirmación
  assets/                  fuentes, logos, fondos de pantalla, sfx, personajes, CREDITS.md
  renders/ audio/ review/  (ignorados por git)

Empieza con sh ~/.claude/skills/film-build/kit/init.sh <film>.

Etapa 0 · Brief

Antes de cualquier otra cosa, escribe brief.md y haz que lo aprueben:

  • Producto, en una frase que un desconocido entienda. No el eslogan.
  • Quién compra, en sus palabras. Varios tipos de personas si el producto sirve a varios (personas): qué revisa o necesita cada uno cada día.
  • La única cosa de la que el video debe convencerlos, y el único malentendido que debe evitar.
  • Pruebas disponibles: qué es real hoy, qué se ha construido y grabado, qué se puede mostrar.
  • Duración y formatos: un video de lanzamiento que muestre variedad necesita unos 45–65 s. 20 s es demasiado corto para mostrar varias personas y sus casos de uso. Formatos: 16:9 primero, luego 9:16, a menos que el propietario diga lo contrario.
  • Dónde se reproduce (site hero, X, Reels, YouTube) y las reglas de la marca (colores, tipo, palabras que nunca usar, logos).
  • Qué nunca debe parecer el producto (por ejemplo, "nunca un dock"), y cualquier competidor del que mantenerse alejado.

Etapa 7 · Entrega

  • renders/16x9.mp4 y renders/9x16.mp4 (60 fps, desenfoque de movimiento, voz y sonido mezclados).
  • assets/CREDITS.md: cada fondo de pantalla, logo, fuente, sonido y personaje, con su licencia.
  • Si aparecen marcas: una línea de uso nominativo en pantalla mientras se muestran ("Los nombres de productos y logotipos pertenecen a sus propietarios…").
  • Una lista simple de lo que no está verificado (por ejemplo, "las cuatro solicitudes aún no se han construido en la aplicación real").
  • Subtítulos y una miniatura si se solicita (usa las habilidades sociales y de redacción del propietario; sin señales de IA).

Después del video

Añade cada nueva corrección que el propietario haya hecho a references/lessons.md, bajo la etapa a la que pertenece, con lo que estaba mal y la regla que lo evita. Ese archivo es cómo el próximo video comienza por delante de este.

Individual skills in this repo

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

film-build

Build a product film in code as a deterministic seek(t) web page (real product UI, real OS chrome, kinetic text, typed prompts, a cursor, morphs and camera moves), review it as stills and drafts, render it at 60 fps with motion blur, and adapt it to 9:16 without changing 16:9. Ships a project kit (init.sh, film engine, render/sync/probe/sheet/regression tools). Stage 3 and 6 of product-film. Use when building, fixing or rendering the picture of a launch/promo film, or making its vertical version.

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.

Skills relacionados