Communitygithub.com

QA de Entrega de Edición

Verifica las ediciones finales de video antes de la entrega. Útil cuando un agente necesita inspeccionar un archivo MP4/MOV/WebM renderizado, confirmar duración/resolución/fotogramas/audio, generar o revisar hojas de contacto, analizar CSV de línea de tiempo, verificar densidad de cortes/mezcla de fuentes, comprobar integración y cohesión de FX, verificar sincronización texto-con-golpe, detectar fotogramas débiles o marcadores de posición accidentales, y decidir si una edición social sincronizada al ritmo está lista para mostrar.

¿Qué es QA de Entrega de Edición?

Este skill automatiza la verificación de calidad (QA) de ediciones de video finales, garantizando que los renders cumplan con los requisitos técnicos y creativos antes de la entrega. Permite a agentes de IA inspeccionar archivos de video renderizados (MP4, MOV, WebM) para verificar especificaciones técnicas como duración, resolución, tasa de fotogramas y presencia de audio. También genera o revisa hojas de contacto para identificar fotogramas débiles, marcas de agua o marcadores de posición, y analiza archivos CSV de línea de tiempo para evaluar la densidad de cortes, la mezcla de fuentes y la coherencia narrativa. El skill incluye comprobaciones avanzadas para ediciones con efectos integrados y capas de texto, como la verificación de sincronización texto-golpe (con tolerancia de 100 ms), detección de elementos que parezcan 'stickers' no rastreados, y revisiones de bucles invisibles. Está diseñado para plataformas de edición como Claude Code, Cursor y Codex, y utiliza un script Python (`scripts/qa_video_edit.py`) para generar informes JSON y Markdown, aunque siempre se recomienda complementar con una revisión humana visual. Soporta umbrales adaptables por tipo de edición y una etapa de 'prueba barata' (renderizado de baja resolución) para detectar problemas costosos antes de los renders completos.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BusyBee3333/viral-video-edit-skills/tree/main/skills/edit-delivery-qa

Preguntar en tu IA favorita

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

Documentación

¿Qué hace QA de Entrega de Edición?

Resumen

Usa este skill antes de presentar una edición de video como terminada. El resultado esperado es un informe de QA conciso: especificaciones técnicas, salud de la línea de tiempo, notas de revisión visual y cualquier corrección necesaria antes de la entrega.

Comprobaciones Requeridas

  1. Sondear el render final:
    • duración
    • resolución
    • tasa de fotogramas
    • códec de video
    • presencia de flujo de audio
    • contenedor de entrega
  2. Generar una hoja de contacto si no existe ya una.
  3. Revisar la hoja de contacto para detectar:
    • fotogramas activos e intencionales
    • sin tarjetas de título/entrevistas/fotogramas en blanco a menos que sean deliberados
    • sin marcas de agua ni superposiciones de previsualización de stock
    • sujeto/acción legibles después del recorte
    • acentos que parezcan intencionales, no relleno aleatorio
  4. Inspeccionar el CSV de la línea de tiempo si está disponible:
    • cantidad de segmentos
    • duración promedio/mínima/máxima de segmento
    • mezcla de fuentes
    • mezcla de tipo/categoría
    • uso de golpes prioritarios
  5. Comparar el resultado con el formato objetivo y el resumen creativo.
  6. Indicar si la edición está lista, necesita una revisión menor o requiere un rerender.

Objetivos de Montaje Sincronizado al Ritmo

Para cortes densos de montaje social:

  • Duración: normalmente 30-40s.
  • Vertical: 1080x1920; horizontal: 1920x1080.
  • Tasa de fotogramas: mínimo 30fps.
  • Para un montaje de alta energía de 35s, 70-90 segmentos es saludable si el metraje lo soporta.
  • Longitud media del segmento: aproximadamente 0.35-0.50s.
  • El audio debe estar presente y limpio.
  • La hoja de contacto debe mostrar principalmente metraje activo/intencional.

Verificaciones de FX Integrados y Artesanía (adiciones de 2026-07)

Para ediciones con efectos o capas de texto, añade estas a las comprobaciones requeridas:

  • Verificación de cohesión / sticker: ¿algún elemento compuesto se lee como un sticker no rastreado en lugar de un objeto en la escena? ¿Algún segmento se lee como un corte a un video diferente? ¿Algún plano rompe la gradación compartida (un aspecto único entre los naturales)? Cualquier sí = revisión: estas son las causas de rechazo de mayor frecuencia.
  • Verificación de sincronización de texto: si una línea de gancho debe caer en un golpe, mide el desfase real entre el fotograma de aparición del texto y el acento de audio; |desfase| > 100 ms = rerender.
  • Verificación de bucle: reproducir el final en el inicio; las ediciones de unión de bucle deben ser invisibles.
  • Verificación a escala de teléfono: inspeccionar a tamaño completo Y a escala de teléfono; guardar fotogramas de revisión en marcas de tiempo obligatorias (por ejemplo, 1/4/8/12/14s de una pieza de 15s) más una verificación puntual de fotograma tardío junto con el informe de QA.
  • Etapa de prueba barata (antes de las construcciones completas, no después): renderizar un esqueleto de baja resolución de los primeros 3-5 segundos y verlo a velocidad de desplazamiento antes de comprometerse con el render completo/ VFX — los criterios de eliminación son baratos en esta puerta y caros después de VFX.
  • Entregable QuickTime: cuando la revisión ocurra en reproductores Apple, también producir y verificar por separado un .mov compatible con QuickTime.
  • Para cualquier cosa que se haga pública, ejecutar cinco puertas independientes: técnica, visual, narrativa, originalidad/derechos, paquete de plataforma. El QA automatizado respalda pero nunca reemplaza ver el render a velocidad normal. El grano está bien (los espectadores lo prefieren); la blockiness, el banding, el desenfoque de upscale, las marcas de agua y los bordes son las penalizaciones reales.

Patrones de Fracaso

Envía la edición de vuelta para revisión cuando veas:

  • sin flujo de audio o extracto de audio incorrecto
  • relación de aspecto incorrecta o recorte no deseado
  • fotogramas vacíos, tarjetas de título, entrevistas, marcas de agua de stock o superposiciones de precio
  • acción oculta por el recorte vertical
  • demasiados inserts débiles de multitud/láser/naturaleza que reemplazan la premisa principal
  • golpes musicales prioritarios servidos por metraje de bajo movimiento
  • CSV de línea de tiempo y render final discrepan materialmente

Script

Ejecutar scripts/qa_video_edit.py contra el video final. Añadir --timeline y --contact-sheet cuando estén disponibles:

python3 scripts/qa_video_edit.py final.mp4 --timeline final_timeline.csv --contact-sheet final_contact_sheet.jpg --out final_qa

El script escribe JSON y Markdown. También puede crear una hoja de contacto con FFmpeg cuando se establece --make-contact-sheet.

Revisión Humana

El script detecta especificaciones y problemas de línea de tiempo; no reemplaza ver o inspeccionar fotogramas. Siempre empareja el QA automatizado con al menos una revisión de la hoja de contacto, y mira el render final cuando la edición es de alto riesgo o visualmente densa.

Para el estándar Conteto Machino, lee references/edit-qa-standard.md.

Referencias opcionales:

  • references/qa-thresholds.md: umbrales adaptables por tipo de edición.
  • references/example-prompts.md: indicaciones reutilizables de QA final.
  • references/gui-vision.md: visión de producto para un panel visual de QA y entrega.

Individual skills in this repo

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

beat-synced-montage-builder

Build beat-synced social video montages from song-analysis outputs and source footage. Use when an agent needs to assemble, plan, or revise a music-timed edit; map footage to beats/onsets/cut markers; create vertical or landscape montage timelines; integrate audio-reactive FX into shots; mix gameplay, crowd, concert, nature, menu, or other accent footage; generate timeline CSVs, contact sheets, and edit briefs; or adapt the Conteto Machino / Smash Mash workflow for another song or footage library.

generated-media-sourcing

Generate or plan media assets for beat-synced edits when real footage is missing or the user asks for generated visuals - AI video (Gemini/Veo/Flow), AI images, or procedural audio-reactive GPU renders (tunnels, portals, kaleidoscopes, starbursts, mandalas, title pieces via Python+moderngl GLSL). Use with beat-synced-montage-builder when a montage needs generated clips, stills, or procedural audio-reactive elements instead of, or alongside, sourced footage.

song-edit-analysis

Analyze songs and audio files for beat-synced video editing, clip timing, energy mapping, viral window selection, onset-locked cut grids, footage selection, and agent-readable edit briefs. Use when an agent needs to inspect an MP3/WAV/M4A/audio track, estimate tempo and beat grids, identify sections, produce cut markers, pick the best 15-30s window of a song for short-form video, or guide a human or another agent in choosing footage that matches musical energy.

viral-video-edits

End-to-end system for making S-tier beat-synced short-form music video edits — song analysis, viral window selection, footage sourcing with shot-level QA, hook writing, onset-locked cutting, integrated audio-reactive FX (person mattes, procedural GLSL renderers, cinematic grade), and delivery QA. Use this whenever the user asks to make a video edit, music video, reel, TikTok/Shorts/vertical video, beat-synced montage, lyric/hook video, audio-reactive visual, tunnel/portal/kaleidoscope render, or to promote a song with video content — even if they don

Skills relacionados