broadcast-news-video

Broadcast News Video

Convierte un guión de noticias en un video de TV editable. Por defecto genera gráficos de código: globo de puntos de la Tierra en la intro, fondo azul oscuro, acentos en rosa, barras de título blancas, ticker y subtítulos bilingües. Usa los scripts de este Skill para crear un proyecto de HyperFrames.

1. Define el contenido

• Reutiliza el tema, la relación de aspecto y la voz que el usuario ya haya indicado. Por defecto: 1920×1080, 30 fps, locución acelerada 1.3× manteniendo el tono.
• Para noticias reales, verifica la fuente original. Indica la hora de publicación, la hora del suceso y la hora de verificación. Diferencia entre juicio mediático, confirmación oficial, resultado estimado y explicación institucional. Guarda los enlaces en un archivo FACTS.md junto al proyecto.
• Cuando se citen datos reales en pantalla, indica la fuente. Los datos de ejemplo deben marcarse como "simulación" y no dar la impresión de ser reales.
• Consulta las reglas de producción para escribir locuciones cortas y planos por escena. Los subtítulos no deben incluir comas ni puntos.
• No uses generación de avatares ni servicios de video salvo que se solicite explícitamente. No invoques generadores de video por créditos por defecto.

2. Crea el proyecto

En los comandos, asigna SKILL_DIR al directorio donde se encuentra este archivo, y WORK_DIR a un directorio de salida independiente del usuario. No escribas ningún archivo dentro del directorio del Skill.

python3 -m pip install -r "$SKILL_DIR/scripts/requirements.txt"
python3 "$SKILL_DIR/scripts/setup.py" --output "$WORK_DIR"

Copia assets/example.json como brief.json del proyecto, luego modifícalo según la guía de configuración para adaptarlo al contenido del usuario. El ejemplo está marcado explícitamente como ficticio. Cambia el nombre del canal, la fecha, los títulos, las barras de información y los datos de los planos; no conserves la narrativa del ejemplo.

Para vista previa sin locución:

python3 "$SKILL_DIR/scripts/build.py" --brief "$WORK_DIR/brief.json" --output "$WORK_DIR"

build.py genera la intro y las escenas (cards, dots, flow, quote), una sola pista de subtítulos, un SRT, la línea de tiempo y la música de fondo. Todo el texto visible está escapado en HTML; las animaciones se controlan mediante una línea de tiempo de GSAP en pausa.

3. Locución (opcional)

Prioriza el uso de audio y subtítulos ya existentes que el usuario haya autorizado. No subas voces privadas a repositorios públicos. Coloca los archivos de audio en voice/ dentro del directorio de salida. Cada escena especifica la ruta del archivo de voice relativa al brief; los captions usan los segundos del audio original y se dividen por speed durante la construcción.

Si el usuario solicita locución con MiniMax, usa la variable de entorno MINIMAX_API_KEY y el --voice-id indicado por el usuario. No incluyas claves en JSON, scripts, documentación ni argumentos de línea de comandos; no imprimas la clave ni guardes la respuesta cruda de la API. Esta interfaz puede generar costos; solo ejecútala si el usuario ha autorizado la locución.

python3 "$SKILL_DIR/scripts/voice.py" --brief "$WORK_DIR/brief.json" --output "$WORK_DIR/voice" --dry-run
python3 "$SKILL_DIR/scripts/voice.py" --brief "$WORK_DIR/brief.json" --output "$WORK_DIR/voice" --voice-id "$MINIMAX_VOICE_ID" --execute
python3 "$SKILL_DIR/scripts/build.py" --brief "$WORK_DIR/voice/brief.voiced.json" --output "$WORK_DIR"

Al generar la locución, se acelera el audio manteniendo el tono; los subtítulos se sincronizan con la aceleración; la música se reproduce a velocidad normal. No aceleres nuevamente durante el renderizado. Si falla la solicitud de pago o se desconoce el resultado, detente y no reintentes automáticamente. Si la API devuelve marcas de tiempo reales, úsalas; no uses marcas estimadas basadas en proporción de caracteres como si fueran precisas.

4. Verificación y entrega

Requiere Node.js 22+, FFmpeg/FFprobe. Probado con HyperFrames 0.9.23.

npx --yes [email protected] check "$WORK_DIR" --json
npx --yes [email protected] snapshot "$WORK_DIR" --at 1.5,5,10
npx --yes [email protected] preview "$WORK_DIR" --background
npx --yes [email protected] render "$WORK_DIR" --quality delivery --output "$WORK_DIR/news.mp4"

• Corrige errores de lint/tiempo de ejecución/diseño; revisa las capturas en el punto medio de cada escena para verificar títulos, fuentes, subtítulos, ticker y el significado de los puntos.
• Ajusta los tiempos de snapshot --at a los puntos medios reales de las escenas según timeline.json.
• Si el usuario solicita el video final o ha autorizado la ejecución continua, renderiza después de la verificación; de lo contrario, ofrece una previsualización editable.
• Usa FFprobe para comprobar la duración, resolución, tasa de fotogramas y pistas de audio del MP4; usa FFmpeg para buscar errores de decodificación. Escucha la locución y la mezcla; si no lo haces, indica honestamente que no se verificó.
• Entrega el MP4, final.srt, las capturas y el proyecto editable. Conserva las notas de verificación y las licencias de los activos.

5. Compartición pública

Empaqueta solo el Skill y los ejemplos neutrales. Excluye audios personales, videos originales, credenciales, guiones privados, respuestas de API, rutas absolutas del sistema, activos de marca e IDs de voz privados. Ejecuta primero scripts/audit.py para escanear el directorio que se publicará; luego revisa los archivos rastreados por Git y la identidad del commit; no confíes solo en .gitignore.

El contenido original de este Skill se distribuye bajo assets/LICENSE-MIT.txt; GSAP, las fuentes y los mapas descargados conservan sus licencias respectivas, según las notas de terceros.