Revisión de video

¿Qué hace Revisión de video?

La herramienta convierte un archivo de video o un proyecto de Remotion en un paquete de revisión que puedes leer: fotogramas como PNG, hallazgos de audio, la línea de narración y el texto OCR en pantalla de cada fotograma, comprobaciones automáticas y lo que cambió desde la última revisión, todo en report.md. Tu trabajo es ejecutarlo y luego revisar el video a partir del paquete.

1. Ejecutar la herramienta

Ejecútala con este comando exacto (funciona tanto desde la herramienta Bash como desde PowerShell), usando la ruta del usuario entre comillas:

powershell -NoProfile -ExecutionPolicy Bypass -File "${CLAUDE_SKILL_DIR}/review-video.ps1" "<archivo de video o carpeta del proyecto Remotion>" [opciones]

• Archivo de video (MP4, MOV, etc.): fotogramas cada 2 s, alrededor de cada cambio de escena y al final.
• Carpeta del proyecto Remotion: fotogramas renderizados con npx remotion still (sin necesidad de render completo) y el audio renderizado por separado. Usa la primera composición a menos que se indique -Composition <id>; la salida lista las demás. Necesita que npm install ya se haya ejecutado en el proyecto.

Opciones útiles (todas opcionales):

Opción	Uso
-Composition <id>	Remotion: qué composición renderizar.
-Frames 0,90,450	Remotion: renderizar solo estos números de fotograma.
-Interval <s>	Segundos entre fotogramas regulares (por defecto 2). Usa 4 o más para videos largos.
-Narration <archivo>	Fuente de narración si no se encuentra automáticamente: .srt, .vtt, .csv, .md tabla de grabación o voiceover.json.
-Project <carpeta>	Carpeta donde buscar la narración cuando el video está fuera de su proyecto.
-OutDir <carpeta>	Dónde escribir el paquete.
-CompareWith <carpeta>	Comparar con una carpeta de revisión anterior (p. ej., de un nombre de archivo previo). Por defecto, cada ejecución compara con la última ejecución del mismo video.
-ChangesPdf	También crear un PDF solo de los fotogramas cambiados, cuando el usuario solo quiere los cambios.
-KeyFramesPdf	Crear key-frames.pdf en la carpeta de revisión: entre 15 y 20 fotogramas, un fotograma completamente construido por escena más los fotogramas marcados, etiquetados con marca de tiempo, escena y hallazgo, de menos de 10 MB. Si la carpeta de revisión ya contiene una revisión completa, se construye a partir de esos fotogramas y no cambia nada más; de lo contrario, la revisión se ejecuta primero. Añade -NoPdf para saltar la hoja de contacto completa.
-KeyFramesMaxMB <n>	Límite de tamaño para key-frames.pdf (por defecto 10).
-WordsPerSecond <n>	Velocidad de lectura para la comprobación de tiempo de lectura (por defecto 3).
-NumberWordsFrom <n>	Las palabras numéricas habladas se verifican desde este valor hacia arriba (por defecto 10).
-SafeMargins t,r,b,l	Márgenes de área segura para Shorts a 1080x1920 (por defecto 288,192,672,48, las cifras cautelosas de Google).
-WordList <archivo>	Palabras adicionales que el corrector ortográfico acepta.
-SceneThreshold 0.3	Para imágenes de cámara (el valor por defecto 0.02 es adecuado para diapositivas con fundidos).
-NoOcr	Saltar las comprobaciones de texto en pantalla.
-NoPdf	Saltar el PDF cuando el usuario solo quiere tu revisión.
-NoAudio	Remotion: saltar el renderizado de audio.

Los videos largos toman tiempo: unos 2 minutos por cada 8 minutos de video, y unos 4 segundos por cada fotograma de Remotion. Usa un tiempo de espera de 10 minutos. Las últimas líneas de la salida dan las rutas de report.md, la carpeta de fotogramas y los PDFs, además de totales de una línea para el audio, las comprobaciones de texto y los cambios. El paquete se guarda en <nombre-del-video>-review\ junto al video, o en out\<composición>-review\ dentro de un proyecto Remotion, a menos que se haya indicado -OutDir. Cada ejecución mantiene la anterior en previous\.

Si la salida termina con FAILED:, detente e indica al usuario el motivo. Si falta ffmpeg, la solución es winget install --id Gyan.FFmpeg -e, luego una nueva terminal. Las líneas que comienzan con WARNING: también aparecen al principio del informe. Transmítelas.

2. Revisión superficial o completa

Ejecutar la herramienta es económico; abrir fotogramas es lo que consume el uso del usuario, porque cada fotograma que abres es una imagen que leer. Una revisión completa de un video de 15 minutos, con seis subagentes Opus abriendo cada fotograma, una vez agotó una sesión de uso completa. Por lo tanto:

• Revisión superficial por defecto, a menos que el usuario solicite una revisión completa (con palabras como "revisión completa", "cada fotograma", "revisar todo"). En una revisión superficial, trabaja desde report.md: el resumen, las comprobaciones, la línea de tiempo de la narración y el texto OCR y las banderas de cada fotograma. Examina los fotogramas de cambio de escena (end of scene y scene change) a través de sus filas en el informe, y abre una imagen de fotograma solo donde algo parezca incorrecto: una comprobación marcada, una línea de narración que no encaja con el texto en pantalla, un fotograma cambiado, un problema de audio en ese momento, o texto OCR vacío o distorsionado donde debería haber una diapositiva. Al final, indica que fue una revisión superficial y cuántos fotogramas abriste.
• Siempre abre algunos fotogramas reales, tanto en una revisión superficial, una revisión solo de texto o un veredicto solo de línea de tiempo: aproximadamente una diapositiva completamente construida por escena (el fotograma end of scene, una vez que todo ha aparecido), o 15 a 20 distribuidos a lo largo del video si no hay escenas claras. Muestran el estilo visual (diseño, superposiciones, cuadros desbordados, contraste, fotogramas en blanco) que el texto no puede. Para un video largo, haz que el subagente Sonnet que lo revisa superficialmente los abra. Siempre indica al final cuántos fotogramas se abrieron.
• Revisión completa solo cuando se solicite. Si el video dura más de 5 minutos (consulta Length y Frames en el resumen de report.md), detente antes de abrir cualquier fotograma: informa al usuario cuántos fotogramas hay y cuántos abrirías, que una revisión completa consumirá mucho de su uso, y pregunta si desea continuar, si prefiere una revisión superficial, o si desea volver a ejecutar con un -Interval mayor para menos fotogramas (-Interval 4 reduce a la mitad los fotogramas regulares). Espera la respuesta.
• Al realizar una revisión completa: ejecuta como máximo dos subagentes a la vez y abre como máximo 100 fotogramas en total, a menos que el usuario haya indicado otro número o haya dicho "cada fotograma, sin límite". Usa Sonnet para los subagentes a menos que el usuario solicite Opus; si lo hace, úsalo, pero menciona una vez que consume mucho más uso. Asigna a cada subagente su propio rango de fotogramas y las filas correspondientes de report.md, y haz que devuelva solo los problemas que encontró.

Recuentos aproximados de fotogramas: -Interval 2 (el valor por defecto) da 30 fotogramas regulares por minuto de video, -Interval 4 da 15 y -Interval 10 da 6, más hasta dos por cambio de escena.

Cómo preguntan los usuarios

El usuario dice	Haz
"Revisa C:\ruta\al\video.mp4"	Revisión superficial.
"Haz una revisión completa de C:\ruta\al\video.mp4"	Revisión completa, hasta 100 fotogramas (pregunta primero si dura más de 5 minutos).
"...revisión completa..., cada fotograma, sin límite"	Revisión completa de cada fotograma. Pregunta primero si dura más de 5 minutos, indicando que puede consumir una sesión de uso completa.
"...usa subagentes Sonnet" / "...usa Opus"	Ese modelo para los subagentes (Sonnet es el valor por defecto de todas formas).
"Haz una revisión superficial con Sonnet y escribe un archivo de línea de tiempo, luego dame tu opinión general a partir de la línea de tiempo"	Ejecuta la herramienta, luego haz que un subagente Sonnet revise superficialmente el paquete, abra la muestra de fotogramas clave (una diapositiva completamente construida por escena) y escriba timeline.md en la carpeta de revisión: una entrada por escena con su rango de tiempo, la narración en resumen, el texto en pantalla en resumen, cómo se ven los visuales y cualquier problema. Lee solo ese archivo (no abras fotogramas tú mismo) y da una opinión general: estructura, ritmo, claridad, estilo visual, y si las diapositivas apoyan la narración. Indica cuántos fotogramas se abrieron.
"Crea el PDF de revisión de C:\ruta\al\video.mp4 para poder adjuntarlo a un chat"	Ejecuta la herramienta y da la ruta completa del PDF. No revises ni abras fotogramas a menos que te lo pidan.
"Crea un archivo de línea de tiempo y un PDF de fotogramas clave... para poder adjuntar ambos a un chat"	Ejecuta la herramienta con -KeyFramesPdf (ver "Compartir con un AI de chat" más abajo) y escribe la línea de tiempo como se indicó anteriormente.

Compartir con un AI de chat

Para un video largo, no adjuntes el PDF de hoja de contacto completo (cientos de fotogramas). Entrega al usuario dos cosas: un archivo de línea de tiempo de texto (timeline.md, como se indicó anteriormente) y el PDF de fotogramas clave, creado con -KeyFramesPdf (añade -NoPdf si no se desea el PDF completo; en una carpeta que ya tiene una revisión, reutiliza los fotogramas y se ejecuta en segundos). Contiene entre 15 y 20 fotogramas: un fotograma completamente construido por escena más los fotogramas que la revisión marcó, cada uno etiquetado con marca de tiempo, nombre de escena y el hallazgo, de menos de 10 MB, guardado como key-frames.pdf en la carpeta de revisión. Da su ruta completa. Si la herramienta no pudo encontrar escenas claras (sin distintivo de pie de página numerado), distribuye los fotogramas de manera uniforme y lo indica en las etiquetas. No puede detectar problemas visuales por sí misma, así que si encontraste alguno (una superposición, un fotograma en blanco), indica qué marcas de tiempo revisar al entregarlo. El PDF completo es mejor para videos cortos como Shorts, o -ChangesPdf para solo los fotogramas cambiados.

3. Revisar el video

1. Lee report.md. En orden: advertencias; cambios desde la última revisión (solo cuando hubo una ejecución anterior: los fotogramas cambiados, con un enlace al fotograma antiguo y las palabras añadidas y eliminadas); un resumen; hallazgos de audio; la línea de tiempo de la narración (cada línea con su inicio, fin y puntuación de coincidencia); las comprobaciones de texto en pantalla (ortografía, tiempo de lectura, números, áreas seguras de Shorts); luego una tabla de cada fotograma con su tiempo, por qué se tomó, su archivo en frames/, la narración en ese momento, su texto OCR y sus banderas. "(pausa; última línea)" significa que nadie está hablando y la línea mostrada fue la que se acabó de decir.
2. Si el usuario preguntó qué cambió, o hay una sección de cambios presente, comienza con los fotogramas cambiados: abre cada uno junto con su fotograma anterior y di qué cambió.
3. Compara cada diapositiva con su línea de narración. En una revisión superficial, hazlo a partir del texto OCR en el informe y abre solo los fotogramas que parezcan incorrectos (ver sección 2). En una revisión completa, abre los fotogramas con la herramienta Read, dentro del límite acordado: primero los fotogramas marcados end of scene (cada uno es una diapositiva terminada justo antes de que cambie) y scene change (cada uno es la siguiente diapositiva una vez que se ha estabilizado), luego cada fotograma marcado, luego los fotogramas regulares donde cambia la línea de narración o algo se construye en pantalla.
4. Trata las comprobaciones automáticas como pistas, no como veredictos, y confirma cada una en la imagen del fotograma:
   • Ortografía: el OCR puede leer mal texto pequeño, tenue o monoespaciado, y algunas palabras marcadas son deliberadas (nombres, palabras mal escuchadas mostradas a propósito). Informa solo las que la imagen confirma.
   • Tiempo de lectura: las diapositivas marcadas tienen más palabras nuevas de las que caben en su tiempo a las palabras por segundo indicadas. Los diagramas narrados con muchas etiquetas lo activan fácilmente; indica qué diapositivas realmente necesitan más tiempo.
   • Números: un número hablado no encontrado en pantalla es o una discrepancia real (la diapositiva muestra una cifra diferente) o un número que el OCR no detectó, a menudo dígitos grandes de titulares. Verifica el fotograma.
   • Áreas seguras: texto dentro de los márgenes de superposición de YouTube en videos verticales. Los márgenes por defecto son los más cautelosos publicados, así que prioriza el texto cerca de los bordes inferior y derecho.
5. En los fotogramas que abras, verifica también visualmente si hay texto en pantalla, números, nombres o etiquetas que no coincidan con la narración, texto cortado o superpuesto, bajo contraste, fotogramas vacíos o negros, y contenido placeholder o sobrante; líneas de narración marcadas como "not found"; y problemas de audio en el informe (recortes, pico verdadero por encima de -1 dBTP, clics o pops, silencios a mitad del video, volumen lejos de aproximadamente -14 LUFS).
6. Informa brevemente: primero los problemas, cada uno con el número de fotograma y la marca de tiempo (por ejemplo #14 00:22.00) y qué está mal, luego los hallazgos de audio, luego cualquier cosa que la herramienta no pudo verificar. Di claramente si todo coincide. No modifiques el proyecto a menos que el usuario lo solicite; si una palabra marcada es correcta, puedes sugerir añadirla a review-words.txt en la carpeta del proyecto.

Los PDFs

<nombre>-review.pdf está en la misma carpeta: una página de portada con los hallazgos de audio, las comprobaciones y cualquier cambio, luego de 6 a 9 fotogramas por página, cada uno etiquetado con su marca de tiempo, cualquier problema encontrado (rojo), la línea de narración y el texto OCR (azul, errores ortográficos subrayados). Se mantiene por debajo de 20 MB. Con -ChangesPdf también hay <nombre>-changes.pdf con solo los fotogramas cambiados. Cuando el usuario quiera algo para adjuntar a un chat de Claude o enviar a alguien, dale la ruta completa. Usa -MaxPdfMB <n> para un límite más pequeño. key-frames.pdf (con -KeyFramesPdf) es el que se debe adjuntar para videos largos.