Communitygithub.com

Imágenes y pantallas de video

Obtén las imágenes a partir de las cuales se construye una película. Encuentra y licencia metraje real y fotos de stock, elige personas consistentes, corta clips de sus fuentes, gradúa todo con un mismo look, captura pantallas reales de productos y genera un código QR. Úsalo después de que exista el guion y cada vez que sea necesario cambiar metraje, fotos, capturas de pantalla o la gradación de color.

¿Qué es Imágenes y pantallas de video?

Este skill automatiza el flujo de trabajo de producción de video que va desde la búsqueda de material de archivo real hasta la gradación de color y la inclusión de pantallas de producto auténticas. Está diseñado para equipos de creación de contenido que necesitan mantener coherencia visual y credibilidad evitando contenido generado por IA para rostros humanos. El skill utiliza la API oficial de Pexels para buscar metraje real, genera hojas de contacto para seleccionar los segundos adecuados, y aplica una gradación unificada a todos los clips mediante un archivo de filtros de ffmpeg. También incluye scripts para capturar pantallas reales de productos web, móviles o físicos usando Playwright con factor de escala 3, y para generar códigos QR con corrección de errores del 30%. La integración con Claude Code o Cursor permite ejecutar estos scripts directamente desde el chat, manteniendo un manifiesto de cortes y un archivo CREDITS.md actualizado. Está pensado para productores de video, editores y desarrolladores que trabajan en spots publicitarios, videos corporativos o contenido promocional que requiere metraje real y capturas fieles del producto.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shubhamnshukla/video-agent-kit/tree/main/skills/video-footage-and-screens

Preguntar en tu IA favorita

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

Documentación

Metraje y pantallas

1. Metraje real, no generado

Usa metraje real de stock de personas reales a menos que la persona solicite video generado. Los espectadores detectan las caras generadas, y una película sobre problemas reales pierde su base cuando lo hacen.

Dónde. Pexels (Licencia Pexels: gratuita para uso comercial, sin atribución) a través de su API oficial: scripts/stock_search.py videos "<consulta>" directorio_salida guarda miniaturas y una lista con el archivo más grande de cada clip, generalmente 4K. Necesita una clave PEXELS_API_KEY gratuita. Otras bibliotecas con las que la persona tenga cuenta también están bien. Registra el id de todo lo que descargues.

Cómo buscar. Busca la acción y el estado de ánimo, no la trama: "hombre preocupado portátil", "mujer café portátil cafetería", "pareja planeando mesa". Descarga miniaturas, organízalas en una hoja de contacto y elige mirando.

Una persona, varios clips. Un personaje necesita más de un plano: tranquilo para la introducción, preocupado para el problema, relajado para el final. Encuentra una sesión, no un clip. En la página de un clip, los ids vecinos del mismo creador suelen ser el mismo actor con la misma ropa y en la misma habitación. Dos o tres clips de una persona valen más que diez clips de diez personas.

Elige el reparto antes de nombrar. Mira a quién muestra realmente el metraje, luego elige nombres, trabajos y ciudades que encajen. Los repartos mixtos están bien. No pongas un nombre a una cara que claramente no le corresponde.

Rechaza clips con logotipos de marca visibles que no puedas recortar o desenfocar, pantallas legibles de otros productos, matrículas, texto en el idioma equivocado para la historia, o un estado de ánimo que contradiga el ritmo (una cara sonriente en el problema).

2. Elegir los segundos

Crea una hoja de contacto de cada candidato a un fotograma por segundo (scripts/sheet.sh). Anota, por clip, los segundos que están tranquilos, los segundos que están preocupados, y cualquier segundo con un logotipo o un bulto de cámara. Una diapositiva o una revelación al inicio de un clip suele ser inutilizable.

Si una toma debe cubrir una línea larga, córtala en dos con un acercamiento: el mismo clip mostrado de nuevo a partir de un segundo posterior con un tamaño 1,2×. Si una toma es demasiado corta, ralentízala: hasta el 80% se reproduce bien; por debajo de eso, interpola fotogramas con ffmpeg minterpolate (mi_mode=mci) y mira el resultado para detectar deformaciones antes de usarlo.

3. Corte y gradación

Escribe cada corte en footage.tsv (nombre, archivo fuente, inicio, duración) y produce los clips con scripts/footage.sh footage.tsv grade.vf assets/footage 3840x2160. Un solo paso hace el corte, la escala y la gradación, directamente desde el archivo fuente.

  • Mantén el manifiesto. Es el único registro de dónde proviene un corte. Si se pierde, scripts/match.py puede encontrar un offset nuevamente comparando fotogramas.
  • Corta a la resolución que entregarás. El metraje en 1080p escalado en una película 4K se ve borroso junto al texto nítido.
  • Conserva las descargas de origen que la película utiliza; elimina el resto una vez que el reparto esté decidido.

Una gradación para todo. Los clips de cinco sesiones parecen cinco películas hasta que comparten una gradación. grade.vf es una receta inicial neutra: saturación ligeramente más baja, negros levantados, blancos contenidos, grano fino, una viñeta suave. Para vincular el metraje a una marca, añade un paso colorbalance antes de noise que incline las sombras hacia el color oscuro de la marca y los realces hacia su color claro, como máximo un pequeño porcentaje, por ejemplo colorbalance=rs=0.045:gs=-0.03:bs=0.06:rh=0.055:gh=0.025:bh=-0.045 para sombras ciruela y realces crema. Mira un recorte a tamaño completo de un rostro después de la gradación: la piel debe seguir pareciendo piel.

Una copia con enfoque suave de un clip (escala a 480 px, desenfoca, vuelve a escalar) sirve como fondo para texto.

4. Fotos y accesorios

Las fotos utilizadas como accesorios (la cosa que una persona desea, un lugar) provienen de las mismas fuentes bajo las mismas reglas de licencia. Elige imágenes sin rostros reconocibles: una boda mostrada como manos y anillos, no una pareja que no sea tu personaje. Desenfoca el nombre de un fabricante con ffmpeg delogo. Recorta todos los accesorios a una misma relación de aspecto para que puedan compartir un diseño de marco.

5. El producto real

Lo que se muestra del producto es el producto real. Nunca vuelvas a dibujar una interfaz y nunca hagas pasar material de archivo como si fuera el producto.

ProductoQué capturar
Sitio webel sitio en vivo en una ventana de escritorio: la sección principal, las secciones clave y capturas de desplazamiento de página completa para recorrerlas
Aplicación web o SaaScada estado de la tarea, iniciado sesión en una cuenta de demostración con datos creíbles
Aplicación móvillo mismo, en una ventana de teléfono, mostrada dentro de un marco de teléfono
Producto físico o tiendalas propias fotos y metraje de la empresa; la página del producto; pide archivos si los del sitio son pequeños
Servicioel flujo de reserva o registro, y los resultados reales que la empresa tiene permitido mostrar

Cómo. Usa un navegador sin cabeza (Playwright) contra el sitio en vivo, o el producto ejecutado localmente en su modo de demostración o simulación, con un factor de escala de dispositivo de 3 para que las pantallas se mantengan nítidas al ampliarlas. Captura cada estado por el que el guion atraviesa, en orden, y nombra los archivos por paso. Si no tienes acceso a un producto con sesión iniciada, dilo y pide un inicio de sesión de demostración o capturas de pantalla; no inventes las pantallas.

La cuenta de demostración. Asígnale los números de la historia, para que la pantalla diga lo que dice el narrador. Si el producto calcula resultados (fechas, cantidades), usa lo que realmente calcula para esas entradas, incluso si la historia quedaría más ordenada con números redondos.

No cambies el producto. Si los datos de demostración deben cambiar, cambia una copia desechable de la capa de simulación o fixture y mantén el diff y el script de captura en el proyecto. Nunca edites el código de la interfaz para obtener una mejor imagen y nunca hagas commit en su repositorio.

Fija lo que usas. Copia las capturas que la película utiliza en assets/screens/. Las herramientas y las reejecuciones sobrescriben las carpetas de trabajo.

Piezas extraídas. La forma más potente de mostrar una pantalla es el teléfono a un lado con una pieza de esa pantalla (una tarjeta, un número, una oración) ampliada al lado. Captura ese elemento por sí solo a alta resolución; un recorte de la pantalla completa se vuelve borroso al ampliarlo, y aún más borroso en 4K.

Di lo que no está en vivo. Verifica de qué rama o entorno provienen tus capturas. Si una pantalla de la película no está en producción, escríbelo en REVIEW.md e informa a la persona.

6. La marca

Toma las fuentes y colores del producto y del sitio web mismos, no de memoria: lee las importaciones de fuentes y las variables CSS del sitio, y las de la aplicación. Pueden diferir (un sitio de marketing con un par de tipografías, la aplicación con otra); pregunta cuál debe seguir la película si no es obvio, y deja que las capturas de pantalla mantengan su propio tipo. Descarga los archivos de fuente (Google Fonts sirve woff2 por subconjunto) en assets/fonts/ y anota la licencia.

Verifica que las tipografías tengan los glifos que la película necesita: signos de moneda (₹, €), flechas, los signos de multiplicación y menos. Donde falte un glifo, configúralo en una tipografía de respaldo.

7. El código QR

scripts/qr.py genera un SVG con un 30% de corrección de errores para que pueda colocarse un logotipo en el medio. Pon etiquetas UTM en el enlace (utm_source, utm_medium=qr, utm_campaign) para que las visitas desde la película se puedan contar, y muestra la dirección corta como texto junto al código. Verifica que la dirección responda antes de usarla. Después de que se haya construido la tarjeta final, decodifica el código de un fotograma renderizado con scripts/scan.py.

8. Créditos

Añade cada fuente a CREDITS.md en el momento de descargarla: archivo, id o URL, creador si se conoce, licencia, dónde se usa. Hazlo en el momento de la descarga; reconstruirlo después cuesta más y se pierden elementos.

Individual skills in this repo

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

Skills relacionados