Communitygithub.com

delorenj/skills

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

O que é skills?

Esta skill fornece uma interface de linha de comando completa para o HyperFrames, um framework de composição de vídeo baseado em HTML/CSS/JavaScript. Ela orquestra todo o ciclo de desenvolvimento de vídeos, desde a criação inicial de projetos até a renderização final. A skill oferece comandos para scaffolding (`init`), linting (`lint`), inspeção visual (`inspect`), pré-visualização com hot-reload (`preview`) e renderização multi-formato (`render`) com suporte a parâmetros Docker e GPU. Inclui também ferramentas de diagnóstico (`doctor`, `browser`, `info`, `upgrade`) para garantir que o ambiente esteja configurado corretamente. Projetada para agentes de IA como Claude Code e Cursor, ela permite que desenvolvedores e sistemas automatizados criem, validem e renderizem composições de vídeo complexas de forma eficiente, com detecção de erros de layout, suporte a transcrição de áudio e templates pré-definidos. A skill é ideal para fluxos de automação em CI/CD, prototipação rápida de conteúdo de vídeo e integração com assistentes de IA que precisam gerar saídas de mídia.

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

Perguntar na sua IA favorita

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

Documentação

CLI do HyperFrames

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

Fluxo de Trabalho

  1. Scaffolding — npx hyperframes init my-video
  2. Escrever — crie a composição HTML (veja a skill hyperframes)
  3. Lint — npx hyperframes lint
  4. Inspeção visual — npx hyperframes inspect
  5. Pré-visualização — npx hyperframes preview
  6. Renderização — npx hyperframes render

Execute lint e inspect antes da pré-visualização. O lint detecta data-composition-id ausentes, trilhas sobrepostas e timelines não registradas. O inspect abre a composição renderizada no Chrome headless, percorre a timeline e relata texto vazando de bolhas/contêineres ou para 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 do navegador Tailwind v4
npx hyperframes init my-video --non-interactive       # pular prompts (CI/agentes)

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

O comando init cria a estrutura correta de arquivos, copia a mídia, transcreve o áudio com Whisper e instala as skills 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 do navegador, 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        # achados em nível informativo
npx hyperframes lint --json           # formato legível por máquina

Verifica 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 na timeline
npx hyperframes inspect ./my-project    # projeto específico
npx hyperframes inspect --json          # achados legíveis por agente
npx hyperframes inspect --samples 15    # varredura mais densa da timeline
npx hyperframes inspect --at 1.5,4,7.25 # timestamps explícitos de quadros-chave

Use este comando após lint e validate, especialmente para composições com balões de fala, cartões, legendas ou tipografia apertada. 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 recorte

Erros devem ser corrigidos antes da renderização. Avisos são exibidos para revisão do agente; adicione --strict para falhar também em avisos. Problemas estáticos repetidos são colapsados por padrão para que a saída JSON permaneça compacta para janelas de contexto LLM. Se o estouro 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.

Pré-visualização

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 studio no seu navegador automaticamente.

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

http://localhost:<port>/projeto/<nome-do-projeto>

Use a porta real da saída da pré-visualização e o nome do diretório do projeto. Por exemplo, após npx hyperframes preview --port 3017 em codex-openai-video, reporte http://localhost:3017/projeto/codex-openai-video.

Trate index.html apenas como contexto de código-fonte. É aceitável vinculá-lo como um arquivo de implementação, mas não o rotule como projeto ou superfície de pré-visualização.

Renderização

npx hyperframes render                                # MP4 padrão
npx hyperframes render --output final.mp4             # saída com nome personalizado
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                       # byte-idêntico
FlagOpçõesPadrãoObservações
--outputcaminhorenders/nome_timestamp.mp4Caminho de saída
--fps24, 30, 603060fps dobra o tempo de renderização
--qualitydraft, standard, highstandarddraft para iterar
--formatmp4, webmmp4WebM suporta transparência
--workers1-8 ou autoautoCada um inicia um Chrome
--dockerflagdesligadoSaída reproduzível
--gpuflagdesligadoCodificação acelerada por GPU
--strictflagdesligadoFalha em erros de lint
--strict-allflagdesligadoFalha em erros E avisos
--variablesobjeto JSON—Sobrescreve valores de variáveis declarados 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 incompatibilidade de tipos em --variables

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

Renderizações parametrizadas: 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 esquema. Scripts internos leem os valores resolvidos via window.__hyperframes.getVariables(). O CLI --variables '{"title":"Relatório Q4"}' é um objeto JSON chaveado por id que sobrescreve os padrões declarados para uma renderização; chaves ausentes usam o fallback, então a mesma composição funciona inalterada na pré-visualização de desenvolvimento e em produção. (Anfitriões 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 por 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.

Diagnóstico

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

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

Outros

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

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.

Habilidades Relacionadas