Communitygithub.com

johnnyjclin/video-producer

Herramienta CLI de HyperFrames: hyperframes init, lint, validate, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Úsala al iniciar un proyecto, hacer lint o validar composiciones, previsualizar en el estudio, renderizar a video, transcribir audio, generar TTS o diagnosticar el entorno de HyperFrames.

¿Qué es video-producer?

El skill video-producer proporciona la interfaz de línea de comandos (CLI) completa de HyperFrames para gestionar todo el flujo de producción de video programático. Con un solo comando `npx hyperframes <subcomando>`, los desarrolladores pueden iniciar proyectos (`init`), escribir composiciones HTML, hacer lint estático (`lint`), validar en navegador real (`validate`), previsualizar con recarga automática (`preview`), renderizar a MP4 o WebM (`render`), transcribir audio con Whisper (`transcribe`), generar voz sintética (`tts`) y diagnosticar el entorno (`doctor`). Está diseñado para Claude Code y agentes similares, y se integra directamente con Node.js >= 22 y FFmpeg. La validación basada en navegador detecta problemas de contraste WCAG, superposiciones rotas, assets faltantes y contratos de tiempo de ejecución, complementando el lint estático. Es especialmente útil en flujos iterativos: se usa `draft` para iterar rápido, `standard` para revisión y `high` para entrega final, con soporte de GPU y Docker para resultados reproducibles.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/johnnyjclin/video-producer/tree/HEAD/.claude/skills/hyperframes-cli

Preguntar en tu IA favorita

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

Documentación

CLI de HyperFrames

Todo se ejecuta a través de npx hyperframes. Requiere Node.js >= 22 y FFmpeg.

Flujo de trabajo

  1. Andamiar — npx hyperframes init my-video
  2. Escribir — redactar composición HTML (ver el skill hyperframes)
  3. Lint — npx hyperframes lint (comprobaciones estáticas)
  4. Validar — npx hyperframes validate (comprobaciones de ejecución en navegador + auditoría de contraste)
  5. Previsualizar — npx hyperframes preview
  6. Renderizar — npx hyperframes render

Lint detecta problemas estáticos (falta data-composition-id, pistas superpuestas, líneas de tiempo no registradas). Validate detecta problemas de ejecución/visuales al buscar en la composición pausada dentro de un navegador real (contraste, superposiciones rotas, assets faltantes). Ejecuta ambos antes del render.

Validación

npx hyperframes validate                 # validación completa (estática + contraste + contratos)
npx hyperframes validate --no-contrast   # saltar auditoría de contraste WCAG al iterar rápido
npx hyperframes validate --json          # salida legible por máquina

La validación busca en varios marcas de tiempo de la composición pausada, captura pantalla de la página, muestrea píxeles detrás de cada elemento de texto para calcular las relaciones de contraste WCAG y verifica los contratos de ejecución (window.__timelines, presencia de class="clip", atributos data-* válidos). Ejecútala antes de cada render — es económica y detecta problemas que lint no puede ver.

Andamiado

npx hyperframes init my-video                        # asistente interactivo
npx hyperframes init my-video --example warm-grain   # elegir un ejemplo
npx hyperframes init my-video --video clip.mp4        # con archivo de video
npx hyperframes init my-video --audio track.mp3       # con archivo de audio
npx hyperframes init my-video --non-interactive       # saltar avisos (CI/agentes)

Plantillas: blank, warm-grain, play-mode, swiss-grid, vignelli, decision-tree, kinetic-type, product-promo, nyt-graph.

init crea la estructura de archivos correcta, copia medios, transcribe audio con Whisper e instala habilidades de codificación de IA. Úsalo en lugar de crear archivos manualmente.

Linting

npx hyperframes lint                  # directorio actual
npx hyperframes lint ./my-project     # proyecto específico
npx hyperframes lint --verbose        # hallazgos a nivel de información
npx hyperframes lint --json           # legible por máquina

Realiza lint en index.html y todos los archivos en compositions/. Reporta errores (deben corregirse), advertencias (deberían corregirse) e información (con --verbose).

Previsualización

npx hyperframes preview                   # servir directorio actual
npx hyperframes preview --port 4567       # puerto personalizado (por defecto 3002)

Recarga automática en cambios de archivo. Abre el estudio en el navegador automáticamente.

Renderizado

npx hyperframes render                                # MP4 estándar
npx hyperframes render --output final.mp4             # salida con nombre
npx hyperframes render --quality draft                # iteración rápida
npx hyperframes render --fps 60 --quality high        # entrega final
npx hyperframes render --format webm                  # WebM transparente
npx hyperframes render --docker                       # salida idéntica byte a byte
BanderasOpcionesPor defectoNotas
--outputrutarenders/nombre_timestamp.mp4Ruta de salida
--fps24, 30, 603060fps duplica tiempo de render
--qualitydraft, standard, highstandarddraft para iterar
--formatmp4, webmmp4WebM soporta transparencia
--workers1-8 o autoautoCada uno inicia Chrome
--dockerbanderaoffSalida reproducible
--gpubanderaoffCodificación acelerada por GPU
--strictbanderaoffFallar en errores de lint
--strict-allbanderaoffFallar en errores Y advertencias

Guía de calidad: draft mientras se itera, standard para revisión, high para entrega final.

Transcripción

npx hyperframes transcribe audio.mp3
npx hyperframes transcribe video.mp4 --model medium.en --language en
npx hyperframes transcribe subtitles.srt   # importar existente
npx hyperframes transcribe subtitles.vtt
npx hyperframes transcribe openai-response.json

Texto a Voz

npx hyperframes tts "Texto aquí" --voice af_nova --output narracion.wav
npx hyperframes tts script.txt --voice bf_emma
npx hyperframes tts --list  # mostrar todas las voces

Solución de problemas

npx hyperframes doctor       # verificar entorno (Chrome, FFmpeg, Node, memoria)
npx hyperframes browser      # gestionar Chrome empaquetado
npx hyperframes info         # versión y detalles del entorno
npx hyperframes upgrade      # buscar actualizaciones

Ejecuta doctor primero si falla el render. Problemas comunes: falta FFmpeg, falta Chrome, poca memoria.

Otros

npx hyperframes compositions   # listar composiciones en el proyecto
npx hyperframes docs           # abrir documentación
npx hyperframes benchmark .    # comparar rendimiento de render

Skills relacionados