Communitygithub.com

HyperFrames CLI – Habilidades de marketing

Herramienta CLI de HyperFrames: hyperframes init, lint, inspect, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Úsala al crear un proyecto, realizar linting, 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 HyperFrames CLI – Habilidades de marketing?

El skill **HyperFrames CLI** proporciona una completa interfaz de línea de comandos para gestionar el ciclo de vida completo de proyectos de video y animación basados en HyperFrames. Está diseñado para agentes de IA y desarrolladores que trabajan con composiciones HTML, permitiendo desde el scaffolding inicial (`init`) hasta la inspección visual de layouts (`inspect`), linting de estructura (`lint`), previsualización con recarga en caliente (`preview`), renderizado a formato MP4 o WebM (`render`), transcripción de audio con Whisper (`transcribe`) y generación de texto a voz (`tts`). Además incluye comandos de diagnóstico (`doctor`, `browser`, `info`, `upgrade`) y herramientas complementarias (`compositions`, `docs`, `benchmark`). El skill es compatible con agentes como Claude Code, Cursor y Codex, y se ejecuta a través de `npx hyperframes`, requiriendo Node.js >= 22 y FFmpeg. Su documentación detallada cubre cada comando con ejemplos de flags, opciones de calidad y modos de salida tanto para humanos como para máquinas (JSON), optimizando la interacción con grandes modelos de lenguaje.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/rbrown101010/codex-marketing-skills/tree/HEAD/plugin-workflows/hyperframes-cli

Preguntar en tu IA favorita

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

Documentación

HyperFrames CLI

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

Flujo de trabajo

  1. Scaffolding — npx hyperframes init my-video
  2. Escribir — autoría de la composición HTML (ver el skill hyperframes)
  3. Lint — npx hyperframes lint
  4. Inspección visual — npx hyperframes inspect
  5. Previsualización — npx hyperframes preview
  6. Renderizado — npx hyperframes render

Ejecuta lint e inspect antes de previsualizar. 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, recorre la línea de tiempo e informa de texto que se sale de burbujas/contenedores o del lienzo.

Scaffolding

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 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 los medios, transcribe el audio con Whisper e instala los skills de IA para codificación. Ú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 de nivel informativo
npx hyperframes lint --json           # legible por máquina

Realiza lint de index.html y de 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 a lo largo de la línea de tiempo
npx hyperframes inspect ./my-project    # 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 explícitas para hero-frame

Úsalo después de lint y validate, especialmente en 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 cercano
  • Texto recortado por su propia caja de ancho/alto fijo
  • Texto que se extiende fuera del lienzo de la composición
  • Elementos hijos que escapan de contenedores con recorte

Los errores deben corregirse antes de renderizar. Las advertencias se muestran 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 sea compacta para las ventanas de contexto de los 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 la misma inspección visual.

Previsualización

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

Recarga en caliente al cambiar archivos. Abre el estudio en el navegador automáticamente.

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

http://localhost:<port>/#project/<project-name>

Usa el puerto real de la salida de previsualización y el nombre del directorio del proyecto. Por ejemplo, después de npx hyperframes preview --port 3017 en codex-openai-video, reporta 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 previsualización.

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
FlagOpcionesPor 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
--dockerflagoffSalida reproducible
--gpuflagoffCodificación acelerada por GPU
--strictflagoffFallar en errores de lint
--strict-allflagoffFallar 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       # comprobar entorno (Chrome, FFmpeg, Node, memoria)
npx hyperframes browser      # gestionar Chrome incluido
npx hyperframes info         # detalles de versión y entorno
npx hyperframes upgrade      # comprobar actualizaciones

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

Individual skills in this repo

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

Skills relacionados