Communitygithub.com

delorenj/skills

Bucle de desarrollo CLI de HyperFrames: `npx hyperframes` para scaffolding (init), validación (lint, inspect), vista previa, renderizado y solución de problemas del entorno (doctor, browser, info, upgrade). Úsalo al ejecutar cualquiera de estos comandos o solucionar problemas del entorno de compilación/renderizado de HyperFrames. Para comandos de preprocesamiento de activos (`tts`, `transcribe`, `remove-background`), invoca la habilidad `hyperframes-media`.

¿Qué es skills?

Esta habilidad define el bucle de desarrollo completo de la CLI de HyperFrames, una herramienta para crear, validar y renderizar composiciones de video HTML. Está diseñada para desarrolladores y agentes de IA (como Claude Code, Cursor o Codex) que trabajan con proyectos HyperFrames. Proporciona comandos para scaffolding (`init`), linting (`lint`) y revisión visual (`inspect`) antes de renderizar, así como comandos para solución de problemas (`doctor`, `browser`, `info`, `upgrade`). Es útil porque estandariza el flujo de trabajo: el agente puede crear la estructura del proyecto, verificar errores de diseño y renderizar el video final en MP4, WebM u otros formatos. La CLI está basada en Node.js >=22 y requiere FFmpeg. El scaffolding ofrece plantillas (`blank`, `warm-grain`, `play-mode`, etc.) y soporta variables de composición para renders parametrizados. El comando `inspect` detecta texto fuera de burbujas/containers o del canvas, y `lint` identifica errores estructurales. Para preprocesamiento de activos (TTS, transcripción, eliminación de fondo), se debe invocar la habilidad `hyperframes-media`.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/delorenj/skills/tree/HEAD/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 la habilidad hyperframes)
  3. Lint — npx hyperframes lint
  4. Inspección visual — npx hyperframes inspect
  5. Vista previa — npx hyperframes preview
  6. Renderizar — npx hyperframes render

Realiza lint e inspección antes de la vista previa. 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 texto que se sale de burbujas/contenedores o del canvas.

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 --example blank --tailwind # con Tailwind v4 en runtime del navegador
npx hyperframes init my-video --non-interactive       # omitir 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.

Al usar --tailwind, invoca la habilidad tailwind antes de editar clases o tokens de tema. El scaffolding usa Tailwind v4.2 a través del runtime del navegador, no la configuración Tailwind v3 de Studio.

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 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 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 de fotogramas clave

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

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

Los errores deben corregirse antes de renderizar. Las advertencias se muestran para revisión del agente; agrega --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 la misma pasada de inspección visual.

Vista previa

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

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

Al devolver un proyecto al usuario, usa la URL del proyecto de Studio, no la ruta del archivo fuente index.html:

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

Usa el puerto real de la salida de vista previa 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 del código fuente. Está bien enlazarlo como archivo de implementación, pero no lo etiquetes como proyecto o superficie de vista previa.

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
FlagOpcionesPredeterminadoNotas
--outputrutarenders/nombre_timestamp.mp4Ruta de salida
--fps24, 30, 603060fps duplica el tiempo de renderizado
--qualitydraft, standard, highstandarddraft para iterar
--formatmp4, webmmp4WebM soporta transparencia
--workers1-8 o autoautoCada uno inicia Chrome
--dockerbanderadesactivadoSalida reproducible
--gpubanderadesactivadoCodificación acelerada por GPU
--strictbanderadesactivadoFallar en errores de lint
--strict-allbanderadesactivadoFallar en errores Y advertencias
--variablesobjeto JSON—Sobrescribir valores de variables declaradas en data-composition-variables
--variables-fileruta—Archivo JSON con valores de variables (alternativa a --variables)
--strict-variablesbanderadesactivadoFallar renderizado en claves no declaradas o tipos incorrectos en --variables

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

Renders parametrizados: la composición declara sus variables en la raíz <html> con data-composition-variables — un arreglo JSON de declaraciones ({id, type, label, default} por entrada) que define el esquema. Los scripts dentro leen los valores resueltos mediante window.__hyperframes.getVariables(). La CLI --variables '{"title":"Q4 Report"}' es un objeto JSON indexado por id que sobrescribe esos valores predeterminados declarados para un render; las claves faltantes pasan sin cambios, por lo que la misma composición se ejecuta sin cambios en la vista previa de desarrollo y en producción. (Los hosts de subcomposiciones también pueden sobrescribir por instancia con data-variable-values — misma forma de objeto, con ámbito en una instancia de la subcomposición. Consulta la habilidad hyperframes para el patrón completo).

Preprocesamiento de activos

npx hyperframes tts, transcribe y remove-background producen activos (audio de narración, transcripciones palabra por palabra, video transparente) que se colocan en una composición. Cada uno descarga su propio modelo en la primera ejecución. Para selección de voz, reglas del modelo whisper (el error de .en-traduce-no-inglés), elección del formato de salida (VP9 alpha WebM vs ProRes) y la cadena TTS → transcribir → subtítulos, invoca la habilidad hyperframes-media.

Solución de problemas

npx hyperframes doctor       # verificar entorno (Chrome, FFmpeg, Node, memoria)
npx hyperframes browser      # gestionar Chrome incluido
npx hyperframes info         # versión y detalles del 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 .    # comparar rendimiento de renderizado

Individual skills in this repo

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

delorenj/skills

Plan and generate terminal ASCII animations/screensaver-style output (FPS, refresh rules, loop policy, low-flicker guidance), with a static poster frame and an optional local demo script.

delorenj/skills

ASCII video: convert video/audio to colored ASCII MP4/GIF.

delorenj/skills

Plan, build and quality-check a premium short commercial for a real business (roofing, property, ecommerce, B2B software) using AI-generated footage, code-built motion (HTML/GSAP), selective Three.js and an independent-critic "Gauntlet" loop. Use when asked to make a launch-style / SaaS-style video, business ad, explainer, sample reel or pitch video, or to review and improve one. Encodes motion principles distilled from 28 professional launch films, a quality bar, audio rules and a business-offer playbook.

delorenj/skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

delorenj/skills

Generate professional voiceovers using ElevenLabs AI. Use when the user needs to create voiceovers for videos, audio narration, or text-to-speech content. Supports multiple voices with character presets (narrator, salesperson, expert) for natural delivery. Includes single scene regeneration for fine-tuning.

delorenj/skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

delorenj/skills

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.

delorenj/skills

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 dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

delorenj/skills

Manim CE animations: 3Blue1Brown math/algo videos.

delorenj/skills

Join a Google Meet or Zoom call as a video meeting agent via PikaStreaming. Trigger: user drops a Google Meet or Zoom link, or asks to join a meeting.

delorenj/skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

delorenj/skills

Generate speech using the self-hosted voxxy (vox) TTS service at https://vox.delo.sh. Use when the user asks to speak, say, narrate, synthesize speech, clone a voice, create a voice, add or register a voice, pipe TTS, or control voice qualities by description (e.g. "a young woman with a cheerful voice"). Handles HTTP API usage, voice profile management, description-based voice design, cloning, MCP registration, and integration patterns for new platforms.

delorenj/skills

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.

delorenj/skills

YouTube transcripts to summaries, threads, blogs.

Skills relacionados