Communitygithub.com

nateherkai/hyperframes-student-kit

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

¿Qué es hyperframes-student-kit?

HyperFrames CLI es una herramienta de línea de comandos que centraliza todo el flujo de trabajo de creación de video con el framework HyperFrames. Permite desde el andamiaje inicial de proyectos (`init`) hasta la validación de composiciones (`lint`), previsualización en tiempo real con recarga en caliente (`preview`), renderizado a video en múltiples formatos y calidades (`render`), transcripción de audio y video (`transcribe`), generación de texto a voz (`tts`), y diagnóstico del entorno (`doctor`). Soporta plataformas como Node.js >=22, FFmpeg y Chrome, y se ejecuta mediante `npx hyperframes`. Es ideal para desarrolladores que buscan automatizar la producción de video programático, ya sea para prototipos rápidos (calidad draft) o entregas finales de alta calidad. La herramienta también ofrece opciones avanzadas como renderizado con Docker para resultados byte-idénticos, aceleración por GPU, y exportación en WebM con transparencia. Su diseño modular permite integrarse fácilmente en pipelines CI/CD o flujos de agentes de IA.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/nateherkai/hyperframes-student-kit/tree/HEAD/.agents/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 mediante npx hyperframes. Requiere Node.js >= 22 y FFmpeg.

Flujo de trabajo

  1. Andamiaje — npx hyperframes init my-video
  2. Escribir — crea composiciones HTML (consulta la skill hyperframes)
  3. Validar — npx hyperframes lint
  4. Previsualizar — npx hyperframes preview
  5. Renderizar — npx hyperframes render

Valida antes de previsualizar — detecta data-composition-id faltantes, pistas superpuestas, líneas de tiempo no registradas.

Andamiaje

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       # omitir prompts (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 archivos multimedia, transcribe audio con Whisper e instala skills de IA. Úsalo en lugar de crear archivos manualmente.

Validación

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

Valida 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 el directorio actual
npx hyperframes preview --port 4567       # puerto personalizado (predeterminado 3002)

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

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                       # byte-idéntico
BanderaOpcionesPredeterminadoNotas
--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 validación
--strict-allbanderaoffFallar en errores Y advertencias

Guía de calidad: draft mientras iteras, 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 el renderizado falla. Problemas comunes: FFmpeg faltante, Chrome faltante, poca memoria.

Otros

npx hyperframes compositions   # listar composiciones en el proyecto
npx hyperframes docs           # abrir documentación
npx hyperframes benchmark .    # evaluar rendimiento del renderizado

Individual skills in this repo

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

nateherkai/hyperframes-student-kit

Agent 2 of the video editing pipeline. Finds and removes spoken mistakes — stutters, repeated words, false starts, and retakes (re-recorded lines) — from a talking-head recording. Use after cut-silences, when asked to cut mistakes, remove stutters / repeats / filler restarts, clean up flubs, or keep the best take. Works review-gated: it proposes every cut with context and a reason for approval, then renders only the approved cuts via ffmpeg. Requires a word-level transcript.

nateherkai/hyperframes-student-kit

Agent 1 of the video editing pipeline. Removes silences and dead air from a talking-head recording. Use when asked to cut silences, trim pauses, remove dead air / gaps, or tighten the pacing of a raw video, given a word-level transcript. Produces an edit list (EDL), a re-timed transcript for downstream agents, and optionally the cut video via ffmpeg. Does NOT cut mistakes, repeats, or false starts — that is the cut-mistakes agent.

nateherkai/hyperframes-student-kit

Edit a raw talking-head video through transcription, silence trimming, mistake review, visual storytelling, motion graphics, and verified HyperFrames rendering. Use for a complete edit; route a single requested operation directly to its specialist skill.

nateherkai/hyperframes-student-kit

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.

nateherkai/hyperframes-student-kit

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.

nateherkai/hyperframes-student-kit

Plan, write, time, style, and validate motion-graphic beats for long-form talking-head HyperFrames videos. Use when Codex is asked to add or improve visual beats, glassmorphism lower thirds, crumpled-paper full-screen takeovers, transcript-synced callouts, pacing coverage, YouTube retention graphics, or render-ready overlays in an existing HyperFrames video project.

nateherkai/motion-showreel

Build 10–30s motion-design showreels in the style of Nate's Opus 5.5 CLAUDE/MOTION REEL — brand motif chapters, HUD, BPM-locked cuts, logo lockup.

nateherkai/website-to-hyperframes

Capture a website URL and produce a HyperFrames promo/product-tour video — site → finished marketing video outcome.

Skills relacionados