saranambiar/hyperframes-video-agent-skills

Habilidades reutilizáveis, scripts e fluxos de trabalho de produção para criação de vídeo liderada por agente com HyperFrames, FFmpeg, legendas, sincronização de áudio e QA de renderização. Projeto comunitário baseado em trabalho real com HyperFrames; não é um repositório oficial da HyperFrames ou HeyGen.

O que é hyperframes-video-agent-skills?

Este skill fornece um conjunto abrangente de instruções e fluxos de trabalho reutilizáveis para agentes de IA que criam vídeos usando HyperFrames, FFmpeg e outras ferramentas. Ele é projetado para automatizar decisões de edição de vídeo, como corte, sincronização de narração, transições, legendas e garantia de qualidade, reduzindo o esforço manual e garantindo consistência na produção. Baseado em experiência prática com HyperFrames, o skill é compatível com agentes como Claude Code e Cursor, e documenta procedimentos detalhados para integração de gravações de tela, mapeamento de momentos do produto e validação de renderização. Sua estrutura modular permite que o agente siga listas de verificação precisas, tomando decisões informadas sobre quando cortar ou manter elementos da UI, como sincronizar estados do produto com falas e como garantir que legendas não obstruam informações importantes.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add saranambiar/hyperframes-video-agent-skills

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Integração de Demonstração de Produto

Use este skill quando a gravação do produto fizer parte do vídeo final.

Recepção

Antes da edição:

  • Verifique duração da gravação, resolução, taxa de quadros e áudio.
  • Identifique se a gravação inclui tela, janela do navegador, cursor, zooms, rolagens ou tempo ocioso.
  • Identifique os momentos necessários do produto e seus timestamps.
  • Identifique frases de narração que devem estar alinhadas com estados do produto.
  • Peça aprovação antes de um corte agressivo se uma UI importante puder ser cortada.

Decisão de Corte

Padrão: preservar a UI em vez de remover o fundo da tela.

Use corte apenas quando:

  • A UI importante permanece visível durante zooms e rolagens.
  • O corte não corta cabeçalhos, rótulos, contexto do cursor ou estado final.
  • Um quadro de prova confirma que o zoom mais restrito ainda funciona.

Use sem corte ou corte leve quando:

  • A gravação faz zoom em diferentes áreas.
  • O momento do produto se move pela tela.
  • O usuário já disse que uma saída cortada cortou texto importante.

Leia references/crop-and-zoom.md para uma lista de verificação.

Transição para a Gravação do Produto

  • Comece a partir do quadro final da cena anterior.
  • Use movimento de câmera (arrastar ou empurrar) em vez de um corte seco se houver solicitação de continuidade.
  • Termine no primeiro quadro atual da gravação do produto.
  • Se a gravação começar com tempo ocioso, corte apenas se isso não quebrar a sincronia.
  • Se um momento do produto deve se alinhar com a narração, reajuste o tempo do segmento antes desse momento, em vez de alterar toda a sincronia posterior.

Transição de Saída

  • Preserve o último estado significativo do produto por tempo suficiente para o espectador registrá-lo.
  • Crie um movimento de câmera para a próxima cena se solicitado.
  • Evite quadros em branco acidentais no final das gravações de tela.
  • Extraia um quadro de prova no limite da transição.

QA (Garantia de Qualidade)

  • Verifique o primeiro quadro do produto.
  • Verifique cada pico de zoom.
  • Verifique cada estado necessário do produto.
  • Verifique a transição de entrada e saída.
  • Confirme que as legendas não cobrem a UI do produto.

Saída

Retorne:

  • Gravação de origem usada.
  • Decisão de corte/sem corte.
  • Segmentos de corte/reajuste.
  • Caminho de renderização.
  • Quadros de prova para o corte mais restrito e momentos chave do produto.

Mapa de Momentos do Produto

Crie um mapa de momentos antes da edição:

  • Timestamp da gravação.
  • O que está visível.
  • Frase de narração.
  • Timestamp global desejado.
  • Se o cursor é relevante.
  • Se a posição de rolagem é relevante.
  • Se as legendas se sobrepõem.
  • Se o corte é seguro.

Use este mapa para decidir cortes e reajustes.

Matriz de Decisão de Corte

Escolha sem corte quando:

  • O usuário aceita a tela/fundo.
  • Os zooms se movem pela tela.
  • Texto principal é cortado por um corte restrito.
  • O estado do produto é mais importante que o polimento.

Escolha corte leve quando:

  • A tela é distrativa, mas a UI permanece centralizada.
  • As legendas precisam de mais espaço.
  • A janela do navegador ou margens mortas podem ser removidas com segurança.

Escolha corte dinâmico apenas quando:

  • Cada retângulo de corte está mapeado.
  • O movimento parece intencional.
  • Todos os estados chave do produto têm quadros de prova.

Sincronização de Narração

Sincronize estados do produto com frases faladas:

  • Inicie a transição antes da frase se o produto precisar estar visível na frase.
  • Deixe o quadro final do produto segurar após a frase se a compreensão for importante.
  • Desacelere a gravação pré-momento em vez de acelerar uma rolagem do produto de forma não natural.
  • Não corte no meio de uma palavra da narração para alcançar um estado do produto.

Limpeza da Gravação de Tela

Verifique:

  • Visibilidade do cursor.
  • UI do navegador.
  • Pop-ups de notificação.
  • Tempo ocioso.
  • Telas de carregamento em branco.
  • Bordas acidentais da área de trabalho.
  • Velocidade de rolagem.
  • Foco do zoom.

Remova ou oculte apenas se isso não prejudicar a clareza do produto.

Segurança de Legendas

Se as legendas estão queimadas:

  • Verifique barras de navegação inferior.
  • Verifique tabelas do produto.
  • Verifique botões modais.
  • Verifique controles de timeline.
  • Mova a margem da legenda ou escolha outro quadro de prova, se necessário.

Pontos de Aprovação do Usuário

Pergunte antes de:

  • Cortar a tela visível.
  • Remover o cursor.
  • Acelerar drasticamente a gravação.
  • Desfocar ou mascarar detalhes do produto.
  • Substituir gravação real por UI recriada.

Formato de Entrega

Relate:

  • Clipe do produto usado.
  • Estratégia de corte.
  • Pontos de corte.
  • Taxas de reajuste.
  • Quadros de prova chave.
  • Qualquer UI que permaneça imperfeita por design.

Habilidades Relacionadas