Communitygithub.com

Biznomad/agent-skills

Ciclo 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 al solucionar problemas del entorno de compilación/renderizado de HyperFrames. Para comandos de preprocesamiento de assets (`tts`, `transcribe`, `remove-background`), invoca la skill `hyperframes-media` en su lugar.

¿Qué es agent-skills?

Esta skill documenta el ciclo de desarrollo completo de HyperFrames, un CLI empaquetado como `npx hyperframes` que permite a los agentes de IA (como Claude Code, Cursor o Codex) y a los desarrolladores humanos crear, validar, previsualizar y renderizar proyectos de composición de video. Es compatible con Node.js >= 22 y requiere FFmpeg. El flujo de trabajo típico incluye: scaffolding (`npx hyperframes init`), linting para detectar errores estructurales, inspección visual para verificar que el texto no se desborde de contenedores y burbujas, previsualización con recarga en caliente y renderizado final con opciones de calidad y parámetros. La skill es especialmente valiosa cuando se depuran problemas de entorno (usando `npx hyperframes doctor`) o se necesita una inspección detallada del layout con `npx hyperframes inspect`. Para tareas de preprocesamiento como generación de voz, transcripción o eliminación de fondos, se debe invocar la skill `hyperframes-media` por separado. La documentación incluye ejemplos detallados de todos los comandos, banderas y formatos de salida, lo que permite a los agentes guiar al usuario de forma precisa durante todo el proceso de desarrollo.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Biznomad/agent-skills/tree/HEAD/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. Scaffolding — npx hyperframes init my-video
  2. Escribir — autoría de composiciones HTML (ver la skill hyperframes)
  3. Lint — npx hyperframes lint
  4. Inspección visual — npx hyperframes inspect
  5. Vista previa — npx hyperframes preview
  6. Renderizar — npx hyperframes render

Ejecuta lint e inspect 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 sobre texto que se desborda 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 --example blank --tailwind # con Tailwind v4 runtime del navegador
npx hyperframes init my-video --non-interactive       # omitir indicaciones (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 las skills de codificación IA. Úsalo en lugar de crear archivos manualmente.

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

Linting

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

Verifica 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 layout 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 el 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 hero

Ú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 los 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 sea compacta para los contextos de ventana 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 estando disponible como alias de compatibilidad para la misma inspección visual.

Vista Previa

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

Recarga en caliente al detectar cambios de 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:<port>/#project/<project-name>

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 de código fuente. Está bien vincularlo como archivo de implementación, pero no lo etiquetes como el proyecto o la 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                       # idéntico byte a byte
BanderasOpcionesPredeterminadoNotas
--outputrutarenders/nombre_marca_tiempo.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 abre Chrome
--dockerbanderaapagadoSalida reproducible
--gpubanderaapagadoCodificación acelerada por GPU
--strictbanderaapagadoFallar en errores de lint
--strict-allbanderaapagadoFallar 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-variablesbanderaapagadoFallar el 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.

Renderizados parametrizados: la composición declara sus variables en la raíz <html> con data-composition-variables — un array JSON de declaraciones ({id, type, label, default} por entrada) que define el esquema. Los scripts internos leen los valores resueltos a través de window.__hyperframes.getVariables(). El CLI --variables '{"title":"Q4 Report"}' es un objeto JSON clave por id que sobrescribe esos valores predeterminados declarados para un renderizado; las claves faltantes se mantienen, por lo que la misma composición se ejecuta sin cambios en la vista previa de desarrollo y en producción. (Los hosts de sub-composiciones también pueden sobrescribir por instancia con data-variable-values — misma forma de objeto, limitado a una montura de la sub-composición. Consulta la skill hyperframes para ver 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 problema de .en que traduce no inglés), elección del formato de salida (VP9 alpha WebM vs ProRes) y la cadena TTS → transcribe → subtítulos, invoca la skill hyperframes-media.

Solución de Problemas

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

Individual skills in this repo

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

Biznomad/agent-skills

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says "landing page", "post-click experience", "landing page audit", "conversion rate", or "landing page optimization".

Biznomad/agent-skills

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 25 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says "TikTok Ads", "TikTok marketing", "TikTok Shop", "Spark Ads", "Smart+", or "TikTok campaign".

Biznomad/agent-skills

YouTube Ads specific analysis covering campaign types, creative quality, audience targeting, and measurement. Evaluates video ad performance across skippable, non-skippable, bumper, Shorts, and Demand Gen formats. Use when user says "YouTube Ads", "video ads", "pre-roll", "bumper ads", "YouTube campaign", or "Shorts ads".

Biznomad/agent-skills

Help users get promoted at work. Use when someone is preparing for a promotion conversation, building their case for advancement, trying to understand what's blocking their promotion, or figuring out how to get to the next level in their career.

Biznomad/agent-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.

Biznomad/agent-skills

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. Shows which VERSION slots are currently claimed by open PRs, which sibling Conductor workspaces have WIP work likely to ship soon, and what slot /ship would pick next. No mutations — just a snapshot. Use when asked to "landing report", "what's in the queue", "show me open PRs", or "which version do I claim next". (gstack)

Biznomad/agent-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.

Biznomad/agent-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.

Biznomad/agent-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.

Biznomad/agent-skills

Still-to-video conversion guide: model selection, motion prompting, and camera movement. Covers Wan 2.5 i2v, Seedance, Fabric, Grok Video with when to use each. Use for: animating images, creating video from stills, adding motion, product animations. Triggers: image to video, i2v, animate image, still to video, add motion to image, image animation, photo to video, animate still, wan i2v, image2video, bring image to life, animate photo, motion from image

Biznomad/agent-skills

>- The Landing Page Audit skill performs comprehensive evaluations of post-click experiences, combining technical performance analysis with conversion rate optimization (CRO) assessment.

Biznomad/agent-skills

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

Biznomad/agent-skills

Optimize landing pages for higher conversion rates using proven frameworks and design patterns. Use when designing, reviewing, or improving landing pages, hero sections, pricing pages, CTAs, or when the user asks about conversion optimization.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. (gstack)

Biznomad/agent-skills

Building promotion cases, brag documents, tracking wins, and self-advocacy for career advancement. Use when preparing for promotions, documenting accomplishments, or building your case for advancement.

Biznomad/agent-skills

Best practices for Remotion - Video creation in React

Biznomad/agent-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.

Biznomad/agent-skills

Produce programmable videos with Remotion using scene planning, asset orchestration, and validation gates for automated, brand-consistent video content.

Biznomad/agent-skills

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

Skills relacionados