Communitygithub.com

revisión y entrega de video

El ciclo que convierte una película montada en una película entregada. Revisa fotogramas, mide el sonido, ejecuta comprobaciones, muestra borradores y muestras a la persona, actúa según sus comentarios, renderiza el máster, verifica el archivo terminado, escribe el registro del proyecto e informa. Úsalo después de cualquier montaje o cambio, antes de cada renderizado y cada vez que lleguen comentarios.

¿Qué es revisión y entrega de video?

Esta habilidad define un flujo de trabajo completo de revisión y entrega de video, diseñado para agentes de IA que trabajan con herramientas como Hyperframes y FFmpeg. Su objetivo principal es cerrar el ciclo entre un cambio en el proyecto y la entrega final del archivo, garantizando calidad y consistencia. El proceso comienza con la revisión de fotogramas mediante linting y snapshots, continúa con la creación de borradores de baja calidad para medir sonido y apariencia visual, y permite mostrar opciones al cliente con contact sheets comparativas. Incluye pautas detalladas para interpretar y actuar sobre comentarios comunes (por ejemplo, «aburrido», «parece IA», «no puedo conectar»), evitando debates subjetivos y priorizando cambios concretos. Luego guía el renderizado del máster en 4K, la verificación técnica del archivo final (resolución, sonoridad, códigos QR), la actualización de los documentos del proyecto (SCRIPT.md, SPEC.md, CREDITS.md, REVIEW.md) y la redacción de un mensaje de entrega claro y objetivo. Finalmente, cubre tareas de mantenimiento como la limpieza de archivos temporales y la protección del repositorio del cliente. Está pensada para agentes como Claude Code, Cursor o Codex, y se ejecuta mediante comandos CLI y scripts locales.

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

Preguntar en tu IA favorita

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

Documentación

Revisión y entrega

1. El ciclo después de cada cambio

  1. npx hyperframes lint. Cero errores.
  2. npx hyperframes snapshot --at 3.4,7.8,35.2,... en los momentos que cambiaste, más uno antes y uno después. Abre la hoja de contactos y léela realmente: ¿está cada tarjeta completa? ¿alguna cara cubierta? ¿algún texto sale de su recuadro? ¿hay algo medio dibujado que debería estar terminado?
  3. Corrige y repite hasta que los fotogramas estén correctos.
  4. npx hyperframes check --json (o scripts/check.sh con material 4K). Corrige errores. Lee las advertencias una vez y decide: corrígelas, o consérvalas y explica por qué en REVIEW.md. Advertencias que vale la pena atender: nada cambia durante más de tres segundos, un primer fotograma vacío, texto que se sale de un contenedor.

Las instantáneas son baratas; los renderizados no. Haz toda la inspección que puedas antes de renderizar.

2. Borradores

Un borrador es la película completa en baja calidad: npx hyperframes render --quality draft -o renders/draft-01.mp4, de uno a tres minutos para una película de 100 segundos a 1080p. Luego:

  • Prepara una hoja del archivo renderizado (scripts/sheet.sh renders/draft-01.mp4 sheet.jpg 1/2.6 8x5) y léela. Muestra la película tal como se codificó, incluyendo el metraje, cosa que las instantáneas pueden errar.
  • Mide la sonoridad: ffmpeg -i draft.mp4 -af ebur128=peak=true -f null -.
  • Mide el nivel cada dos segundos (scripts/levels.py draft.mp4 2) y compáralo con el plan: ¿la parte silenciosa es silenciosa? ¿el clímax llega donde aparece el producto?

Entrega el borrador a la persona con una nota breve sobre lo que contiene y en qué quieres que ponga atención visual y auditiva. El primer borrador existe para ser corregido; entrégalo temprano en lugar de pulido.

3. Mostrar opciones

Cuando la pregunta es visual (un estilo de resalte, una fuente, una disposición, un color), muestra fotogramas fijos, no renderizados.

  • Construye cada opción, toma instantáneas de los mismos tres o cuatro momentos y guarda las hojas de contactos una al lado de la otra con nombres simples (A-subrayado.jpg, B-banda.jpg).
  • Di en una línea cada una qué son A y B, y cuál elegirías tú y por qué.
  • Espera la respuesta solo sobre este punto; sigue trabajando en todo lo que no dependa de ello.

Cuando sus palabras podrían significar dos cosas, así es como lo averiguas. Cuesta un minuto. Un renderizado completo equivocado cuesta diez y su paciencia.

4. Actuar según los comentarios

Los comentarios llegan breves, informales y a veces molestos. Manéjalos así:

  • Reformúlalos como una acción antes de actuar, en una línea: «Foto de Singapur: mismo texto pequeño que las demás, tanto en el problema como en el final.»
  • Aplícalo donde sea aplicable. Si un elemento estaba mal, sus hermanos en otras partes de la película están igual de mal.
  • Toma el gusto como dado. «Lento», «aburrido», «se ve barato», «demasiado grueso»: cámbialo; no lo defiendas. Si estás en desacuerdo sobre un punto factual (ocultaría una cara, una afirmación sería falsa), dilo una vez, con la razón.
  • Notas comunes y qué significan:
Ellos dicenHaz
lento, soñoliento, aburridotomas más cortas, voz más rápida, corta líneas, música más enérgica; no más efectos
no parece real, parece IAmetraje real de personas reales; menos gráficos inventados
parece clips de archivo pegadosuna sola gradación en todo; personas recurrentes; tarjetas consistentes
no puedo conectar con ellonombres, trabajos, deseos específicos; el problema en sus propias palabras
el sonido es plano, monótonomusicaliza por estado de ánimo; silencio antes del clímax
hazlo pegadizoreescribe el gancho y la línea de cierre; añade un callback
este es diferente de los demáshazlo coincidir exactamente con sus hermanos
más atención en estas palabrasuna marca de énfasis por línea, mostrada primero como fotogramas fijos
  • Varios mensajes a la vez: ocúpate de cada uno; di en una línea cómo. Un mensaje posterior anula uno anterior.
  • Registra las decisiones en REVIEW.md y en la memoria: qué eligió, qué rechazó, en sus palabras.

5. El renderizado máster

Cuando el borrador esté aprobado o los cambios restantes sean pequeños:

  1. Verifica el espacio libre en disco. Un renderizado 4K necesita unos 11 GB de espacio temporal por cada 100 segundos.
  2. npx hyperframes render --quality delivery --resolution landscape-4k -o renders/<nombre>-4k.mp4, en segundo plano. Añade --gpu si quieren velocidad o lo pidieron; di lo que cuesta (aproximadamente la mitad de la tasa de bits).
  3. Si preguntan cuánto falta, lee el progreso del renderizado y responde con un número.

Nombra las versiones de forma clara (-v2, -v3). Cuando una versión es rechazada, bórrala para que nadie la abra por error.

6. Verificar el archivo terminado

Haz esto en el archivo que estás a punto de entregar, no en el proyecto.

  • ffprobe: resolución, frecuencia de fotogramas, duración, tamaño.
  • Una hoja del archivo completo: todas las secciones presentes, sin tramo en blanco o congelado, el último fotograma correcto.
  • Un recorte a tamaño completo de un texto y de un rostro: tipografía nítida, metraje no pixelado.
  • Sonoridad: alrededor de −16 LUFS integrados, pico real a −1 dBFS o menos.
  • El código QR decodificado de un fotograma tardío (scripts/scan.py): el enlace exacto, a tamaño completo y a medio tamaño.
  • La dirección en la tarjeta final responde cuando se solicita.

7. El registro del proyecto

Actualiza los cuatro archivos antes de informar. templates/ tiene cada uno como esqueleto.

  • SCRIPT.md: la tabla del guion (tiempo, imagen, voz), las personas, de dónde viene cada línea, los números.
  • SPEC.md: objetivo, salida, plan de tiempo y sonido, apariencia, tipografía, movimiento, la lista de tomas con fotogramas, una lista de control de calidad.
  • CREDITS.md: cada fuente y su licencia.
  • REVIEW.md: decisiones tomadas; medido, inspeccionado, no comprobado; decisiones abiertas; tomas más débiles; advertencias conservadas a propósito; cómo cambiar la película (qué archivo, qué comando).

8. El mensaje de entrega

Breve, en este orden:

  1. El archivo: ruta, resolución, duración, tamaño.
  2. Qué cambió desde la última versión, como una lista breve.
  3. Qué comprobaste y cómo; qué no comprobaste (nunca lo escuchaste).
  4. Qué necesita su decisión, lo más importante primero: cosas que no están en vivo en el producto, cualquier cosa en pantalla que la empresa podría no querer mostrar, licencias por confirmar, pronunciaciones para escuchar.

Sin adjetivos sobre tu propio trabajo. Si algo falló o falta, esa es la primera línea.

9. Mantenimiento

  • Conserva las descargas fuente y los manifiestos a partir de los cuales se cortó la película; elimina los candidatos que no usaste, los borradores antiguos y los cachés cuando falte espacio o cuando te lo pidan. Mira lo que estás a punto de eliminar; elimina solo lo que hiciste.
  • Nunca hagas commit ni subas su repositorio a menos que te lo pidan.
  • Mantén los scripts generadores y los scripts auxiliares en el proyecto, no en una carpeta temporal que se borre al reiniciar.

Individual skills in this repo

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

Skills relacionados