Communitygithub.com

HyperFrames CLI - Biznomad/agent-skills

Loop de desenvolvimento CLI do HyperFrames — `npx hyperframes` para scaffolding (init), validação (lint, inspect), preview, render e diagnóstico de ambiente (doctor, browser, info, upgrade). Use ao executar qualquer um desses comandos ou ao solucionar problemas do ambiente de build/render do HyperFrames. Para comandos de pré-processamento de assets (`tts`, `transcribe`, `remove-background`), invoque a skill `hyperframes-media`.

O que é agent-skills?

Esta skill abrange o ciclo de desenvolvimento completo do HyperFrames via CLI usando `npx hyperframes`. Ela é essencial para desenvolvedores e agentes de IA que trabalham com a criação, validação e renderização de composições de vídeo baseadas em HTML. A skill suporta scaffolding de projetos (com modelos como 'blank', 'warm-grain' e suporte a Tailwind v4), linting de arquivos HTML para detectar erros de estrutura, inspeção visual headless para identificar textos e elementos fora dos contêineres, preview com hot-reload e renderização parametrizável em formatos MP4, WebM e com qualidade draft/standard/high. Fornece também comandos de diagnóstico (doctor, browser, info) e upgrade. Projetada para ambientes Node.js >= 22 e FFmpeg, ela é a ferramenta principal para iniciar e gerenciar projetos HyperFrames, enquanto a skill complementar `hyperframes-media` lida com pré-processamento de áudio e vídeo (TTS, transcrição, remoção de fundo).

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Biznomad/agent-skills/tree/HEAD/hyperframes-cli

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

HyperFrames CLI

Tudo é executado através de npx hyperframes. Requer Node.js >= 22 e FFmpeg.

Fluxo de Trabalho

  1. Scaffold — npx hyperframes init my-video
  2. Escrever — autor da composição HTML (veja a skill hyperframes)
  3. Lint — npx hyperframes lint
  4. Inspeção visual — npx hyperframes inspect
  5. Preview — npx hyperframes preview
  6. Render — npx hyperframes render

Execute lint e inspect antes do preview. lint detecta data-composition-id ausente, trilhas sobrepostas e timelines não registradas. inspect abre a composição renderizada no Chrome headless, percorre a timeline e relata texto vazando para fora de balões/contêineres ou fora da tela.

Scaffolding

npx hyperframes init my-video                        # assistente interativo
npx hyperframes init my-video --example warm-grain   # escolher um exemplo
npx hyperframes init my-video --video clip.mp4        # com arquivo de vídeo
npx hyperframes init my-video --audio track.mp3       # com arquivo de áudio
npx hyperframes init my-video --example blank --tailwind # com runtime browser Tailwind v4
npx hyperframes init my-video --non-interactive       # pular prompts (CI/agentes)

Modelos: blank, warm-grain, play-mode, swiss-grid, vignelli, decision-tree, kinetic-type, product-promo, nyt-graph.

init cria a estrutura de arquivos correta, copia mídia, transcreve áudio com Whisper e instala skills de codificação de IA. Use-o em vez de criar arquivos manualmente.

Ao usar --tailwind, invoque a skill tailwind antes de editar classes ou tokens de tema. O scaffold usa Tailwind v4.2 via runtime browser, não a configuração Tailwind v3 do Studio.

Linting

npx hyperframes lint                  # diretório atual
npx hyperframes lint ./my-project     # projeto específico
npx hyperframes lint --verbose        # descobertas no nível info
npx hyperframes lint --json           # legível por máquina

Aplica lint em index.html e todos os arquivos em compositions/. Relata erros (devem ser corrigidos), avisos (devem ser corrigidos) e informações (com --verbose).

Inspeção Visual

npx hyperframes inspect                 # inspeciona o layout renderizado ao longo da timeline
npx hyperframes inspect ./my-project    # projeto específico
npx hyperframes inspect --json          # descobertas legíveis por agente
npx hyperframes inspect --samples 15    # varredura de timeline mais densa
npx hyperframes inspect --at 1.5,4,7.25 # timestamps explícitos de hero-frame

Use após lint e validate, especialmente para composições com balões de fala, cartões, legendas ou tipografia compacta. Ele relata:

  • Texto se estendendo para fora do contêiner visual ou balão mais próximo
  • Texto cortado por sua própria caixa de largura/altura fixa
  • Texto se estendendo para fora da tela da composição
  • Filhos escapando de contêineres de corte

Erros devem ser corrigidos antes da renderização. Avisos são apresentados para revisão do agente; adicione --strict para falhar também em avisos. Problemas estáticos repetidos são recolhidos por padrão para que a saída JSON permaneça compacta para janelas de contexto LLM. Se o overflow for intencional para uma animação de entrada/saída, marque o elemento ou ancestral com data-layout-allow-overflow. Se um elemento decorativo nunca deve ser auditado, marque-o com data-layout-ignore.

npx hyperframes layout permanece disponível como um alias de compatibilidade para a mesma passagem de inspeção visual.

Preview

npx hyperframes preview                   # serve o diretório atual
npx hyperframes preview --port 4567       # porta personalizada (padrão 3002)

Recarrega automaticamente nas alterações de arquivo. Abre o estúdio no seu navegador automaticamente.

Ao devolver um projeto ao usuário, use a URL do projeto do Studio, não o caminho do arquivo index.html fonte:

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

Use a porta real da saída do preview e o nome do diretório do projeto. Por exemplo, após npx hyperframes preview --port 3017 em codex-openai-video, relate http://localhost:3017/#project/codex-openai-video.

Trate index.html apenas como contexto de código-fonte. Não há problema em vinculá-lo como um arquivo de implementação, mas não o rotule como projeto ou superfície de preview.

Renderização

npx hyperframes render                                # MP4 padrão
npx hyperframes render --output final.mp4             # saída nomeada
npx hyperframes render --quality draft                # iteração rápida
npx hyperframes render --fps 60 --quality high        # entrega final
npx hyperframes render --format webm                  # WebM transparente
npx hyperframes render --docker                       # saída byte-idêntica
FlagOpçõesPadrãoObservações
--outputcaminhorenders/name_timestamp.mp4Caminho de saída
--fps24, 30, 603060fps dobra o tempo de render
--qualitydraft, standard, highstandarddraft para iterar
--formatmp4, webmmp4WebM suporta transparência
--workers1-8 ou autoautoCada um spawna Chrome
--dockerflagdesligadoSaída reprodutível
--gpuflagdesligadoCodificação acelerada por GPU
--strictflagdesligadoFalha em erros de lint
--strict-allflagdesligadoFalha em erros E avisos
--variablesobjeto JSON—Sobrescreve valores de variáveis declaradas em data-composition-variables
--variables-filecaminho—Arquivo JSON com valores de variáveis (alternativa a --variables)
--strict-variablesflagdesligadoFalha na renderização em chaves não declaradas ou incompatibilidades de tipo em --variables

Orientação de qualidade: draft durante a iteração, standard para revisão, high para entrega final.

Renders parametrizados: a composição declara suas variáveis na raiz <html> com data-composition-variables — um array JSON de declarações ({id, type, label, default} por entrada) que define o schema. Scripts internos leem os valores resolvidos via window.__hyperframes.getVariables(). O CLI --variables '{"title":"Q4 Report"}' é um objeto JSON indexado por id que sobrescreve esses padrões declarados para uma renderização; chaves ausentes são ignoradas, de modo que a mesma composição é executada inalterada no preview de desenvolvimento e na produção. (Os hosts de sub-composição também podem sobrescrever por instância com data-variable-values — mesma forma de objeto, com escopo para uma montagem da sub-composição. Veja a skill hyperframes para o padrão completo.)

Pré-processamento de Assets

npx hyperframes tts, transcribe e remove-background produzem assets (áudio de narração, transcrições no nível da palavra, vídeo transparente) que são inseridos em uma composição. Cada um baixa seu próprio modelo na primeira execução. Para seleção de voz, regras do modelo whisper (a pegadinha .en-traduz-não-inglês), escolha de formato de saída (VP9 alpha WebM vs ProRes) e a cadeia TTS → transcrever → legendas, invoque a skill hyperframes-media.

Solução de Problemas

npx hyperframes doctor       # verifica ambiente (Chrome, FFmpeg, Node, memória)
npx hyperframes browser      # gerencia Chrome empacotado
npx hyperframes info         # detalhes de versão e ambiente
npx hyperframes upgrade      # verifica atualizações

Execute doctor primeiro se a renderização falhar. Problemas comuns: FFmpeg ausente, Chrome ausente, pouca memória.

Outros

npx hyperframes compositions   # lista composições no projeto
npx hyperframes docs           # abre documentação
npx hyperframes benchmark .    # benchmark de desempenho de renderização

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.

Habilidades Relacionadas