Communitygithub.com

govindgoel2001/kit-de-edicion-de-video

Herramienta CLI HyperFrames — hyperframes init, lint, inspect, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Úsala para crear proyectos, lintear, validar, inspeccionar el diseño visual en composiciones, previsualizar en el estudio, renderizar a video, transcribir audio, generar TTS o solucionar problemas del entorno HyperFrames.

¿Qué es kit-de-edicion-de-video?

El kit de herramientas CLI HyperFrames proporciona un flujo de trabajo completo para la edición y producción de video basada en composiciones HTML. Permite a desarrolladores y agentes de IA crear proyectos desde cero con `npx hyperframes init`, lintear y validar composiciones para detectar errores de layout y superposiciones, inspeccionar visualmente el resultado en un navegador sin interfaz gráfica (headless Chrome), previsualizar en un estudio con recarga en caliente, y renderizar a formatos MP4 o WebM con diferentes calidades y tasas de cuadros. También incluye transcripción de audio/video mediante Whisper, generación de texto a voz (TTS) y comandos de diagnóstico como `doctor` para verificar el entorno (FFmpeg, Chrome, Node.js). Está diseñado para ser usado tanto por humanos como por agentes de IA (como Claude Code o Cursor), ofreciendo salida JSON para consumo automático y un modo no interactivo para integración con CI. La herramienta requiere Node.js >= 22 y FFmpeg, y es ideal para proyectos que necesitan videos generados programáticamente con layouts precisos, animaciones y texto dinámico.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/govindgoel2001/video-editing-toolkit/tree/HEAD/vendor/hyperframes-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. Scaffold — npx hyperframes init mi-video
  2. Escribir — crear la composición HTML (consulta la skill de hyperframes)
  3. Lint — npx hyperframes lint
  4. Inspección visual — npx hyperframes inspect
  5. Previsualizar — npx hyperframes preview
  6. Renderizar — npx hyperframes render

Ejecuta lint e inspect antes de preview. lint detecta data-composition-id faltantes, pistas superpuestas y líneas de tiempo no registradas. inspect abre la composición renderizada en Chrome sin interfaz gráfica, navega por la línea de tiempo e informa sobre texto que se sale de burbujas/contenedores o del lienzo.

Scaffolding

npx hyperframes init mi-video                        # asistente interactivo
npx hyperframes init mi-video --example grano-calido  # elegir un ejemplo
npx hyperframes init mi-video --video clip.mp4        # con archivo de video
npx hyperframes init mi-video --audio pista.mp3       # con archivo de audio
npx hyperframes init mi-video --non-interactive       # omitir preguntas (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 skills de codificación de IA. Úsalo en lugar de crear archivos manualmente.

Linting

npx hyperframes lint                  # directorio actual
npx hyperframes lint ./mi-proyecto    # proyecto específico
npx hyperframes lint --verbose        # hallazgos de nivel informativo
npx hyperframes lint --json           # legible por máquina

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

Inspección visual

npx hyperframes inspect                 # inspeccionar el diseño renderizado en la línea de tiempo
npx hyperframes inspect ./mi-proyecto   # proyecto específico
npx hyperframes inspect --json          # hallazgos legibles por agente
npx hyperframes inspect --samples 15    # barrido más denso de la línea de tiempo
npx hyperframes inspect --at 1.5,4,7.25 # marcas de tiempo de fotograma clave explícitas

Úsalo después de lint y validate, especialmente para composiciones con burbujas de diálogo, tarjetas, subtítulos o tipografía ajustada. Reporta:

  • Texto que se extiende fuera del contenedor visual o burbuja más cercana
  • Texto recortado por su propia caja de ancho/alto fijo
  • Texto que se extiende fuera del lienzo de la composición
  • Hijos que escapan de contenedores de recorte

Los errores deben corregirse antes de renderizar. Las advertencias se exponen para revisión del agente; añade --strict para fallar también en advertencias. Los problemas estáticos repetidos se colapsan por defecto para que la salida JSON se mantenga compacta para ventanas de contexto de LLM. Si el desbordamiento es intencional para una animación de entrada/salida, marca el elemento o ancestro con data-layout-allow-overflow. Si un elemento decorativo nunca debe auditarse, márcalo con data-layout-ignore.

npx hyperframes layout sigue disponible como alias de compatibilidad para el mismo pase de inspección visual.

Previsualización

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

Recarga en caliente con los cambios de archivos. Abre el estudio automáticamente en tu navegador.

Al devolver un proyecto al usuario, usa la URL del proyecto en el Estudio, no la ruta del archivo index.html fuente:

http://localhost:<port>/#project/<nombre-del-proyecto>

Usa el puerto real de la salida de preview y el nombre del directorio del proyecto. Por ejemplo, después de npx hyperframes preview --port 3017 en codex-openai-video, informa http://localhost:3017/#project/codex-openai-video.

Trata index.html solo como contexto de código fuente. Está bien enlazarlo como archivo de implementación, pero no lo etiquetes como el proyecto o la superficie de preview.

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 byte-idéntica
BanderasOpcionesPor defectoNotas
--outputrutarenders/nombre_timestamp.mp4Ruta de salida
--fps24, 30, 603060fps duplica el 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 iteres, 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         # detalles de versión y entorno
npx hyperframes upgrade      # buscar actualizaciones

Ejecuta doctor primero si el renderizado falla. 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 .    # evaluar rendimiento de renderizado

Individual skills in this repo

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

govindgoel2001/video-editing-toolkit

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

govindgoel2001/video-editing-toolkit

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

govindgoel2001/video-editing-toolkit

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For CLI commands (init, lint, preview, render, transcribe, tts) see the hyperframes-cli skill.

govindgoel2001/video-editing-toolkit

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

govindgoel2001/video-editing-toolkit

Edit any video by conversation. Transcribe, cut, color grade, generate overlay animations, burn subtitles — for talking heads, montages, tutorials, travel, interviews. No presets, no menus. Ask questions, confirm the plan, execute, iterate, persist. Production-correctness rules are hard; everything else is artistic freedom.

govindgoel2001/video-editing-toolkit

Production pipeline for mathematical and technical animations using Manim Community Edition. Creates 3Blue1Brown-style explainer videos, algorithm visualizations, equation derivations, architecture diagrams, and data stories. Use when users request: animated explanations, math animations, concept visualizations, algorithm walkthroughs, technical explainers, 3Blue1Brown style videos, or any programmatic animation with geometric/mathematical content.

Skills relacionados