Communitygithub.com

HyperFrames CLI

Usa el ciclo de desarrollo de HyperFrames CLI: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, render simple o en lote, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, auth, tts y remove-background. También útil para diagnosticar fallos de construcción o renderizado. validate, inspect y layout son alias obsoletos; usa check. Cubre renderizado local, en la nube de HeyGen, AWS Lambda y Google Cloud Run.

¿Qué es HyperFrames CLI?

HyperFrames CLI es una herramienta de línea de comandos para crear y renderizar composiciones de video de forma programática. Ofrece un ciclo de desarrollo completo: desde el scaffold inicial (init, capture) hasta la revisión (lint, check, snapshot), previsualización (preview, play) y renderizado (render, cloud, lambda, cloudrun). Soporta múltiples destinos de renderizado: local (requiere Node.js 22+ y FFmpeg), en la nube de HeyGen (sin infraestructura propia), AWS Lambda y Google Cloud Run. El flujo de trabajo recomendado es: lint para retroalimentación rápida, check como puerta final (incluye lint y auditorías de accesibilidad), preview para aprobación del usuario, y render solo tras aprobación. También incluye herramientas especializadas como beats (parrilla de ritmo), keyframes (diagnóstico de animaciones), present (presentación sincronizada) y feedback (reporte de telemetría). Es ideal para desarrolladores que integran generación de video en pipelines CI/CD o agentes de IA, ya que ofrece salida JSON, modo non-TTY y variables de entorno para control de ejecución.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dbillion/hermes-skills-public/tree/HEAD/skills-external/hyperframes-cli

Preguntar en tu IA favorita

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

Documentación

¿Qué hace HyperFrames CLI?

Ejecuta comandos como npx hyperframes ... a menos que las instrucciones del proyecto proporcionen un envoltorio. Obedece el envoltorio cuando esté presente. La CLI requiere Node.js 22 o superior y FFmpeg.

Ciclo de desarrollo

  1. Andamio: npx hyperframes init <proyecto> o captura un sitio. En modo no TTY, pasa --non-interactive --example=<nombre>.
  2. Autor: escribe la composición usando /hyperframes-core.
  3. Obtén retroalimentación rápida mientras editas: ejecuta npx hyperframes lint después del primer pase de HTML y después de cambios estructurales.
  4. Ejecuta la puerta final: ejecuta npx hyperframes check; vuelve a ejecutar lint antes de abrir el navegador. No antepongas una invocación redundante de lint independiente. Añade --snapshots para fotogramas generales anotados y encontrar recortes.
  5. Inspecciona subcomposiciones: cuando index.html monta data-composition-src, captura fotogramas intermedios e inspecciona cada escena montada.
  6. Abre la vista previa final del Studio: ejecuta npx hyperframes preview, entrega la URL del proyecto de línea de tiempo al usuario y pregunta si desea revisar o renderizar.
  7. Renderiza solo después de la aprobación: usa calidad de borrador para iteraciones y alta calidad para la entrega final.
  8. Verifica la salida: confirma que el archivo existe, no está vacío y tiene una duración plausible.
# Iteración rápida de verificación; repite según sea necesario durante la autoría.
npx hyperframes lint

# Puerta final obligatoria; incluye lint.
npx hyperframes check
npx hyperframes preview
npx hyperframes render --quality high --output out.mp4
test -s out.mp4
ffprobe -v error -show_format out.mp4

check ejecuta lint primero, luego usa una sesión de navegador y un pase de búsqueda para auditar errores de ejecución, solicitudes fallidas, diseño, afirmaciones de *.motion.json y contraste WCAG. Los hallazgos persistentes condicionan el código de salida; los hallazgos transitorios de entrada o salida son informativos. Usa --strict para condicionar las advertencias. validate, inspect y layout siguen siendo alias por compatibilidad, pero no deben aparecer en nuevas instrucciones o scripts.

Dos superficies de vista previa diferentes

No confundas estos estados:

SuperficieCuándo puede abrirsePropósito
Tablero de guion gráficoAntes de las comprobaciones de composición, solo si storyboard: yesRevisar tarjetas de plan y bocetos de estructura. Abre ?view=storyboard#project/<nombre>.
Vista previa de composición finalDespués de que check paseRevisar la línea de tiempo ensamblada antes de renderizar. Abre #project/<nombre>.

El tablero temprano no es aprobación del video final. El renderizado siempre requiere la aprobación final definida por hyperframes-core/references/review-loop.md.

Prueba de humo de subcomposición

Las auditorías estáticas no pueden detectar todas las fallas de montaje. Cuando el proyecto usa subcomposiciones, captura al menos un punto visible intermedio para cada ranura anfitriona:

npx hyperframes snapshot --at <t1>,<t2>,<t3>

Trata el contenido pequeño sin estilo, los iconos de tamaño de lienzo, los elementos de héroe faltantes o los tiempos de espera de registro de línea de tiempo como defectos de montaje que bloquean el renderizado. Consulta hyperframes-core/references/sub-compositions.md para las correcciones correspondientes.

Convenciones de agente

  • Prefiere --json para llamadas de agente y CI. El modo servidor render, preview y play no proporcionan salida JSON ordinaria; preview --selection --json y preview --context --json son excepciones del modo de consulta.

  • doctor --json siempre sale con código cero. Filtra en su carga útil:

    npx hyperframes doctor --json | jq -e '.ok' >/dev/null
    
  • El modo no TTY es automático. init requiere --example allí; usa --non-interactive para forzar un comportamiento determinista en un TTY.

  • Usa un solo HYPERFRAMES_RUN_ID para todos los comandos en el mismo bucle de verificación.

  • Usa --strict, --strict-all y --strict-variables cuando las advertencias, variables o condiciones de CI correspondientes deban condicionar el renderizado.

  • Las rutas JSON redactan el directorio de inicio como $HOME; no intentes revertir la redacción.

  • Nunca renderices solo porque las comprobaciones pasen. Haz una pausa en la vista previa final y espera la aprobación.

Ediciones dirigidas por Studio

Cuando el usuario se refiere a "este elemento" o a la selección actual, consulta a Studio en lugar de adivinar:

npx hyperframes preview --context --json --context-fields selection

Usa selection.target.hfId cuando esté disponible, de lo contrario su selector y archivo fuente. Si el resultado informa no-selection, pídele al usuario que haga clic en el elemento y vuelve a ejecutar. Solicita solo los segmentos de contexto que necesites; usa --context-detail full solo para estilos calculados o metadatos de texto editables. El comportamiento completo y los códigos de falla están en references/preview-render.md.

Opciones de renderizado

NecesidadComando
Iteración local rápidanpx hyperframes render --quality draft
Entrega local finalnpx hyperframes render --quality high --output out.mp4
Renderizado reproducible en contenedornpx hyperframes render --docker --strict --output out.mp4
Renderizado por lotes basado en variables localesnpx hyperframes render --batch rows.json --output "renders/{name}.mp4"
Renderizado en la nube de HeyGen sin infraestructuranpx hyperframes cloud render
Renderizado distribuido AWS autogestionadonpx hyperframes lambda render <proyecto> --width 1920 --height 1080 --wait
Renderizado distribuido GCP autogestionadonpx hyperframes cloudrun render <proyecto> --width 1920 --height 1080 --wait

Usa renderizado en la nube cuando el usuario quiera renderizado alojado sin Chrome local, FFmpeg o AWS. Usa Lambda solo cuando la propiedad de AWS sea un requisito. Usa Cloud Run solo cuando la propiedad de GCP sea un requisito. Lee la referencia correspondiente antes de ejecutar cualquier ruta en la nube.

Después de verificar un renderizado exitoso, envía un informe de retroalimentación a menos que la telemetría esté deshabilitada o el usuario haya optado por no participar:

npx hyperframes feedback --rating <0-10> --comment "<resultado específico o fricción>"

Mantén concisa la retroalimentación de ejecución limpia. Para cualquier error o fricción, captura un paquete de reproducción antes de enviar; no envíes solo un resumen de síntomas. Incluye el comando reejecutable y el directorio de trabajo, comportamiento esperado versus real, error exacto, si la salida se completó/recurrió/falló, solución alternativa y estado del proyecto de reproducción. Si el problema no se reprodujo de nuevo, dilo e incluye el último comando y registros fallidos. Usa --file-issue solo con consentimiento: publica una reproducción mínima en una URL pública. El formato de paquete requerido y la advertencia de privacidad están en references/preview-render.md.

Lee la referencia correspondiente antes de ejecutar un comando

Las siguientes referencias y habilidades propietarias son contratos de comando obligatorios, no lecturas de fondo opcionales. Antes de ejecutar un comando en la tabla, lee su fila correspondiente.

NecesidadReferencia
init, capture, skillsreferences/init-and-scaffold.md
lint, check, archivos laterales de movimiento, snapshotreferences/lint-validate-inspect.md
compare, grade-compare, render --batch basado en variablesreferences/compare-and-batch.md
beats para la parrilla de ritmo del Studio de un proyecto existentereferences/beats.md
preview, play, render, publish, contexto de Studio, retroalimentaciónreferences/preview-render.md
doctor, gestión del navegadorreferences/doctor-browser.md
auth, renderizado en la nube de HeyGen y variables de plantillareferences/cloud.md
Implementación y renderizado en AWS Lambdareferences/lambda.md
Implementación y renderizado en Google Cloud Runreferences/cloudrun.md
info, upgrade, compositions, docs, benchmark, telemetría, preprocesamiento de mediosreferences/upgrade-info-misc.md

Para variables de composición, lee también /hyperframes-core → references/variables-and-media.md. Para hyperframes add y hyperframes catalog, usa /hyperframes-registry. Antes de hyperframes present, lee /slideshow; antes de hyperframes keyframes, lee /hyperframes-keyframes. Para TTS, transcripción, subtítulos o eliminación de fondo, usa /media-use.

Los comandos especializados están documentados deliberadamente por sus flujos de trabajo propietarios:

npx hyperframes present <dir-proyecto> --port 3004 --no-open
npx hyperframes beats <dir-proyecto> --json
npx hyperframes keyframes <dir-proyecto> --json

present sirve una presentación navegable con sincronización de presentador y audiencia. beats es la utilidad independiente de parrilla de ritmo del Studio definida en references/beats.md. keyframes descubre diagnósticos de animación y trayectoria de movimiento seguros para la búsqueda.

Individual skills in this repo

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

dbillion/hermes-skills-public

Edit an existing image based on a text prompt.

dbillion/hermes-skills-public

Add `flutter_localizations` and `intl` dependencies, enable "generate true" in `pubspec.yaml`, and create an `l10n.yaml` configuration file. Use when initializing localization support for a new Flutter project.

dbillion/hermes-skills-public

Expert in video composition, editing, and format conversion. Use when the user wants to generate high-quality video, overlay images on video, concatenate clips, create GIFs, or sync audio to video using mcp-avtool-go and mcp-veo-go.

dbillion/hermes-skills-public

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

dbillion/hermes-skills-public

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

dbillion/hermes-skills-public

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

Skills relacionados