Video de Producto desde URL
Pipeline: URL → extraer → borrador del brief → preguntas ciegas → construir → revisar → renderizar.
La plantilla del brief creativo está en references/video-brief.md. El script de extracción es scripts/extract_site.mjs. Lee la plantilla del brief antes del paso 4.
1. Verificar el entorno
node --version # necesita 18+
Obtener sitios web arbitrarios y descargar Chromium requieren acceso de red abierto. En Claude Code en la web, el acceso de red del entorno debe estar configurado como Completo (la lista blanca "Confiado" predeterminada bloquea la mayoría de los sitios cliente y la descarga del navegador). Si una descarga falla con un error de red/proxy, indícaselo al usuario en una línea y recurre al paso alternativo (ver paso 2 de respaldo).
2. Extraer el sitio
mkdir -p work && cd work
npm init -y >/dev/null && npm i playwright@1 >/dev/null
npx playwright install --with-deps chromium # omite --with-deps si no eres root
node <skill-dir>/scripts/extract_site.mjs "<URL>" ./site
Esto escribe en ./site/:
site.json— título, etiquetas meta/OG, encabezados, CTAs, navegación, texto del cuerpo, colores de marca clasificados, variables de color CSS, fuentes, candidatos a logotipo, subpáginas rastreadashero-desktop.png,hero-mobile.png,full-desktop.png,section-*.png,page-*.pnglogo.*si se encuentra
claims es una red amplia (cualquier cosa con números) — trátalo como una lista para revisar, no una lista de afirmaciones para usar.
Si Chromium ya está instalado en otro lugar (ej. /opt/pw-browsers), omite la instalación y establece PLAYWRIGHT_BROWSERS_PATH en esa ruta.
Luego mira las capturas de pantalla (abre los PNGs) — no confíes solo en el JSON. Evalúa: ¿hay una interfaz de usuario de producto real visible, o solo gráficos de marketing/fotos de archivo? ¿Qué secciones se recortarían bien en un primer plano? ¿Los colores extraídos coinciden con lo que ves?
Respaldo (sin navegador / bloqueado): descarga el texto de la página con cualquier herramienta de extracción web existente, completa lo que puedas y marca los colores, el logotipo y las capturas de pantalla como faltantes; se convierten en preguntas ciegas.
3. Redactar los DETALLES DEL PROYECTO
Completa cada campo del bloque de DETALLES DEL PROYECTO. Etiqueta cada valor con su fuente:
[site]— indicado en el sitio (cita o casi cita)[inferred]— lectura razonable del sitio[guess]— no respaldado; necesita confirmación
Reglas:
- Afirmaciones: solo usa métricas/testimonios/afirmaciones que aparezcan textualmente en el sitio, y etiquétalos como
[site]. Nunca inventes números, recuentos de clientes o resultados. Si el sitio no tiene ninguno, el video no tiene ninguno. - Funcionalidades: elige las 2–3 que sean más visuales y más concretas. Una funcionalidad que no se pueda mostrar en pantalla es una elección débil.
- Beneficio principal: una oración, en lenguaje de resultado para el usuario, no el eslogan de la empresa a menos que el eslogan ya sea un beneficio claro.
- Colores: elige un conjunto moderado de la extracción (fondo, texto, 1 marca, 1 acento como máximo). Proporciona códigos hexadecimales.
- Activos: enumera las rutas de archivo reales de
./site/y di lo que muestra cada uno.
4. Hacer preguntas ciegas — una vez, agrupadas
Antes de construir, envía UN mensaje que contenga el bloque de detalles redactados más las preguntas. Reglas:
- Pregunta solo lo que cambia el video y no se pudo resolver desde el sitio. Omite cualquier cosa que ya esté clara.
- Cada pregunta lleva tu valor predeterminado propuesto, para que el usuario pueda responder "adelante" y tú continúes.
- Máximo ~6 preguntas, ordenadas por impacto. Breves.
Revisa estos puntos ciegos (pregunta solo los que apliquen):
- Propósito — ¿muestra de venta fría para el negocio, su anuncio pagado, una pieza de portafolio o un video de lanzamiento? (Cambia CTA, tono, relación de aspecto).
- Relación de aspecto — 9:16 (Reels/TikTok/DM) vs 16:9 (sitio web/YouTube/LinkedIn). Predeterminado: 9:16 para presentaciones/anuncios, 16:9 para inserciones en sitio web.
- Audiencia — si el sitio atiende a varios (ej. compradores y vendedores), ¿a cuál?
- Elección de funcionalidades — si hay más de 3 candidatos, confirma tus selecciones.
- Visuales del producto — si las capturas de pantalla no muestran una interfaz de usuario real (solo fotos/ilustraciones), pregunta: ¿usar interfaz de usuario recreada simplificada, usar sus fotografías, o el usuario tiene capturas de pantalla reales de la aplicación?
- Logotipo — faltante, de baja resolución o solo un favicon → ¿construir una marca de texto limpia a partir de la fuente de la marca?
- Afirmaciones — el sitio tiene estadísticas/testimonios: ¿incluirlos (textualmente) o mantenerlo libre de afirmaciones?
- CTA — sin CTA clara en el sitio, o el propósito es una presentación → ¿qué debería decir/enlazar la tarjeta final?
- Negocio físico/local sin aplicación → la maqueta del dispositivo no encaja; propón un visual central alternativo (sus fotos, una tarjeta de reserva/menú, un pin de mapa).
- Música/locución — el brief es video silencioso; menciónalo solo si el propósito del usuario implica sonido (anuncios).
Si el usuario dice "solo adelante" o responde parcialmente, usa tus valores predeterminados y establécela en una línea.
5. Completar el brief y ejecutarlo
Lee references/video-brief.md. Inserta los DETALLES DEL PROYECTO confirmados (elimina las etiquetas de fuente) y guárdalo como work/brief.md. Luego sigue el brief como tus propias instrucciones: primero el storyboard (muéstralo brevemente, no es necesario esperar aprobación a menos que el usuario haya pedido revisar), luego construye.
Configuración de Remotion (no interactiva)
mkdir video && cd video
npm init -y >/dev/null
npm i remotion @remotion/cli react react-dom
npm i -D typescript @types/react
npx remotion browser ensure
mkdir -p src public && cp ../site/*.png ../site/logo.* public/ 2>/dev/null
Todos los paquetes remotion / @remotion/* deben tener exactamente la misma versión. Entrada: src/index.ts llama a registerRoot(Root); src/Root.tsx registra el <Composition>. Referencia los activos con staticFile('name.png') y <Img>. Carga fuentes web con @remotion/google-fonts cuando la fuente de la marca sea una fuente de Google, de lo contrario un reemplazo cercano.
Estructura:
src/content.ts— todo el texto, colores, nombres de archivos de activos, duraciones de escenas (en segundos). Este es el archivo que edita el usuario.src/scenes/*.tsx— un componente por escena.src/components/*— marco de dispositivo, revelación de texto, etc.- Duración total calculada a partir de las duraciones de escenas en
content.ts.
Usa interpolate + spring de remotion, <Sequence> o @remotion/transitions <TransitionSeries> para las escenas. Sin animaciones CSS ni Math.random() (representaciones no deterministas); usa random('seed') de remotion si es necesario.
6. Revisar antes de la representación final
Representa fotogramas fijos en fotogramas representativos (inicio, medio y final de cada escena) y míralos:
npx remotion still src/index.ts <CompId> out/f-<n>.png --frame=<n>
Verifica contra la lista de revisión del brief: texto legible en tamaño de teléfono, nada recortado, un punto focal por escena, capturas de pantalla no estiradas, final se mantiene ≥1.5s. Corrige, luego vuelve a verificar los fotogramas que cambiaste.
7. Renderizar y entregar
npx remotion render src/index.ts <CompId> out/<product>-video.mp4
Entrega: la ruta del MP4, el storyboard del brief (breve) y una nota de edición de 4 líneas: el texto/colores/duraciones están en src/content.ts, los activos en public/, vista previa con npx remotion studio, volver a renderizar con el comando anterior. Indica cualquier valor predeterminado que hayas asumido en una línea.