Communitygithub.com

Sherlock-126/video_ai

Habilidade de entrada para o HyperFrames. Comece AQUI para qualquer solicitação de criação, geração, edição, animação ou renderização de vídeo, animação, motion graphics, vídeo explicativo, placa de título, sobreposição, vídeo legendado, promoção de produto, vídeo para site, PR ou changelog em vídeo, montagem de dados, pôster animado ou composição HTML do HyperFrames.

O que é video_ai?

O `sharlock-126/video_ai` é a habilidade de entrada essencial para o ecossistema HyperFrames, projetada para agentes de IA como Claude Code, Cursor e Codex. Ela atua como um roteador de vídeo e mapa de capacidades, garantindo que qualquer solicitação de criação de vídeo seja direcionada ao fluxo de trabalho correto. A habilidade analisa a intenção do usuário com base no tipo de entrada (URL, texto, PR do GitHub, vídeo existente) e na duração alvo, encaminhando para workflows especializados como `/product-launch-video`, `/faceless-explainer`, `/website-to-video` e `/motion-graphics`. Ela também fornece uma visão geral abrangente do que o HyperFrames pode e não pode fazer, como a renderização determinística e a impossibilidade de editar vídeos existentes. Ao centralizar o roteamento, o `sharlock-126/video_ai` evita que o agente execute o fluxo de trabalho errado e garante que as solicitações de vídeo sejam tratadas de forma eficiente. A habilidade é crucial para qualquer projeto que use HyperFrames, especialmente quando não há um arquivo de configuração de agente (CLAUDE.md ou AGENTS.md) definindo o pipeline de vídeo. Ela suporta todos os workflows principais do HyperFrames, desde animações curtas até vídeos explicativos longos, e inclui regras claras para desambiguação de entradas conflitantes.

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

Perguntar na sua IA favorita

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

Documentação

HyperFrames — leia isso primeiro

Comece aqui para qualquer tarefa do HyperFrames — especialmente quando não houver configuração de agente de projeto (CLAUDE.md / AGENTS.md / .cursorrules). Mapa de capacidades + roteador de vídeo abaixo.

Mapa de capacidades — qual habilidade para qual intenção

Você quer...Vá para
Criar um vídeo (a partir de uma URL, briefing, tópico, PR do GitHub, filmagem existente ou um único elemento para animar)o roteador de vídeo abaixo (§ Roteamento de vídeo)
Criar / editar uma composição HTML — o contrato data-*, clipes, trilhas, subcomposições, variáveis/hyperframes-core
Animar — regras de movimento atômicas, blueprints de cena, transições, adaptadores de tempo de execução (GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU)/hyperframes-animation
Direção criativa — design.md, paletas, tipografia, narração, planejamento de batidas, áudio-reativo/hyperframes-creative
Pré-processamento de mídia — narração TTS, música de fundo, transcrição, remoção de fundo, legendas/hyperframes-media
Loop de desenvolvimento CLI — init, lint, validar, inspecionar, pré-visualizar, renderizar, publicar, doctor/hyperframes-cli
Instalar blocos / componentes do registro (hyperframes add)/hyperframes-registry

O contrato de criação de composição (cada elemento temporizado precisa de data-start / data-duration / data-track-index; elementos temporizados precisam de class="clip"; as linhas do tempo do GSAP são pausadas e registradas em window.__timelines; apenas lógica determinística — sem Date.now() / Math.random() / rede) não está duplicado aqui — ele está em /hyperframes-core. Leia isso antes de escrever HTML de composição.

O que o HyperFrames não pode fazer — verifique isso primeiro

O HyperFrames cria uma composição HTML e a renderiza para MP4 a partir do código. Esse modelo tem limites externos rígidos. Uma solicitação que ultrapasse um deles não é uma escolha de roteamento — está fora do escopo, portanto recuse (ou aponte para a ferramenta correta) em vez de tentar um workflow. Estes decorrem da arquitetura, não de uma solicitação única:

  • A renderização é determinística e autocontida. Cada valor, ativo e texto é gravado na criação; a renderização não faz chamadas de rede e nenhuma captura de dados ao vivo / em tempo de renderização (regra central: sem Date.now() / Math.random() / rede). "Atualizar os números ao vivo no momento da renderização" está fora — obtenha os dados uma vez no momento da criação e grave-os, ou recuse.
  • O vídeo existente é sobreposto, nunca editado. O HyperFrames compõe quadros sobre um clipe de origem — /embedded-captions adiciona uma camada de legenda, /graphic-overlays adiciona cartões gráficos projetados (terços inferiores, chamadas de dados, títulos) — e o clipe é reproduzido inalterado por baixo, mas nenhum dos dois pós-processa o fluxo de vídeo codificado. Alterar a filmagem em si (sua duração, cor, enquadramento, ordem ou áudio) é edição estilo NLE e está fora do escopo.
  • A importação do Remotion é unidirecional. /remotion-to-hyperframes traduz o código-fonte do framework Remotion para HyperFrames. Não há reverso (HyperFrames → Remotion, ou → qualquer outro framework — fora do escopo), e uma fonte de animação web / React que não seja Remotion não tem fonte Remotion para traduzir — recrie-a via /general-video.
  • Não pode produzir entradas que não possui. Sem gravação de tela/sessão, sem captura de câmera, sem geração de avatar com IA de fala/sincronização labial. Se a filmagem ou o ativo ainda não existir, o HyperFrames não pode criá-lo do nada — peça ao usuário para fornecê-lo (ou use a ferramenta de captura correta) primeiro.

Todo o resto — um vídeo a partir de uma URL, briefing, tópico, PR, filmagem para anotar ou um único elemento para animar — está no escopo; roteie abaixo.


Roteamento de vídeo

Esta seção conhece APENAS workflows de nível superior. Ela não carrega fases internas de workflow, habilidades de domínio (hyperframes-* — veja o mapa de capacidades acima) ou referências técnicas.

Tabela de decisão

O tipo de ENTRADA (intenção) é o eixo principal; a duração da SAÍDA é apenas um teto, não uma barreira. Para uma entrada correspondente, os workflows especializados lidam com qualquer coisa até ~3 min — qual workflow você entra é decidido pela intenção (o tipo de entrada e, para texto, o assunto), não pela duração. A duração importa apenas no extremo superior: uma peça genuinamente mais longa (um tutorial de 3-5 min, um mergulho profundo de 5 min+) é um registro diferente e é roteada para /general-video. Dentro da faixa de ≤~3 min, um terceiro eixo divide os dois workflows alimentados por texto — o assunto: um produto sendo comercializado vs um tópico sendo explicado (veja a regra de desambiguação na etapa 3 abaixo).

Duração / EntradaLançamento de produto (URL / briefing / roteiro)Site geral / URLPR do GitHub / alteração de códigoTópico / artigo / anotações (sem produto, sem URL)Vídeo existente (talking-head) †
≤ ~3 min/product-launch-video/website-to-video/pr-to-video/faceless-explainer/embedded-captions · /graphic-overlays †
3-5min tutorial/general-video/general-video/general-video/general-video/embedded-captions · /graphic-overlays †
5min+ mergulho profundo/general-video/general-video/general-video/general-video/embedded-captions · /graphic-overlays †
Estático / loop/general-video/general-video/general-video/general-video/general-video

Cobertura atual: a faixa ≤ ~3 min tem workflows dedicados para entradas de lançamento de produto / site geral / PR do GitHub / tópico (uma URL se divide por tipo depois intenção — veja a etapa 3), e a coluna vídeo existente é coberta em qualquer duração — por /embedded-captions (legendas / subtítulos) ou /graphic-overlays (sobreposições gráficas projetadas), divididas por intenção (veja a etapa 2). Todas as outras células são /general-video — o fluxo geral de criação de composição HTML (independente de entrada e duração): tudo mais longo que ~3 min (as linhas de 3-5 min / 5 min+) e todo formato estático / loop. O roteador nunca termina em um beco sem saída para um vídeo criável; a única resposta verdadeira "geral / nenhum" é uma solicitação fora do próprio HyperFrames (por exemplo, edição estilo NLE de um arquivo de vídeo finalizado — reajuste de tempo, recolorir, reenquadrar, reordenar, áudio).

† Filmagem existente se divide por intenção, não por duração. Legendas / subtítulos → /embedded-captions; sobreposições gráficas projetadas / empacotamento — terços inferiores, chamadas de dados, cartões com títulos, citações em destaque — → /graphic-overlays. Ambos sobrepõem o clipe, que é reproduzido inalterado por baixo; nenhum edita a filmagem em si.

Curto-circuito de gênero (precede a tabela). Um motion graphic curto (~abaixo de 10s), sem narração, focado em design — tipo cinético, um destaque de estatística/gráfico, uma vinheta de logotipo, um terço inferior / sobreposição, ou um tweet animado / manchete / destaque de página capturada — é roteado para /motion-graphics independentemente da entrada. É um gênero de SAÍDA, não um tipo de entrada, portanto tem precedência sobre a tabela de tipo de entrada acima quando o pedido é claramente motion-first sem narração (veja a etapa 2). Um tratamento mais longo ou narrado é roteado por tipo de entrada, ou /general-video.

Migrando uma composição existente (caso especial)

A tabela acima é para criar um vídeo a partir de uma entrada. Um workflow está fora dela: se o usuário pedir explicitamente para portar / converter / migrar uma composição existente do Remotion (React) para HyperFrames → /remotion-to-hyperframes. Isso é tradução de código-fonte, não criação a partir de entrada, portanto não tem célula ENTRADA × DURAÇÃO. Roteie aqui APENAS em linguagem explícita de migração ("portar meu projeto Remotion", "converter esta composição Remotion", "reescrever isto como HyperFrames") — uma menção passageira ao Remotion não é um gatilho; use por padrão a tabela de criação ou /hyperframes-core.

Procedimento de roteamento

  1. Determine o tipo de ENTRADA + duração alvo. O roteamento precisa saber sobre o que é o vídeo — seu assunto e entrada. Se o assunto em si não for especificado (por exemplo, "faça um vídeo sobre nossa coisa" sem URL, produto nomeado, tópico ou ativo para trabalhar), ou o tipo de entrada for desconhecido, pergunte antes de entrar em qualquer workflow — esclareça primeiro; não invoque um Workflow Skill e então pergunte, já que se comprometer com um workflow é em si a decisão de roteamento. Faça no máximo 2 perguntas de esclarecimento:
    • "Qual é sua entrada — um produto (URL ou briefing), um site geral / URL, um PR do GitHub / alteração de código, um tópico ou artigo para explicar, ou um vídeo existente de pessoa falando para legendar?"
    • "Duração alvo — cerca de 3 minutos ou menos, ou mais longa (um tutorial de 3-5 min / mergulho profundo de 5 min+)?"
    • Padrões de especificação — declare, não pergunte (estes NÃO afetam a rota, portanto nunca bloqueie o roteamento neles): proporção 16:9 (o mecanismo também suporta 9:16 vertical — mude apenas se o usuário nomear um destino vertical como TikTok / Reels / Shorts); idioma da narração / legenda = o do usuário. Confirme apenas se o usuário contestar; o workflow escolhido reconfirma suas próprias especificidades na Etapa 0.
  2. Escolha pelo tipo de ENTRADA (intenção) primeiro; duração é apenas um teto, não uma barreira.
    • Motion graphic curto focado em design (curto-circuito de gênero, precede a tabela de entrada) — o motion em si é a mensagem: tipo cinético, uma contagem de estatística/número, um destaque de gráfico, uma vinheta de logotipo, um terço inferior / sobreposição, ou uma animação de tweet / manchete / destaque de página capturada; tipicamente abaixo de ~10s, sem narração / voz over → /motion-graphics. Isso é um gênero de SAÍDA, não um tipo de entrada — quando o pedido é claramente uma peça motion rápida, sem narração e focada em design, roteie aqui independentemente da entrada. Um tratamento mais longo ou narrado do mesmo material NÃO é isso (roteie por tipo de entrada, ou /general-video).
    • Vídeo existente de pessoa falando (o usuário tem um clipe e quer algo adicionado sobre ele) → divida por intenção, em qualquer duração (tipo de entrada vence sobre duração): legendas / subtítulos (as palavras faladas como texto legível) → /embedded-captions; sobreposições gráficas projetadas — terços inferiores, chamadas de dados, cartões de informação com título, citações em destaque, uma edição com pacote gráfico → /graphic-overlays. (Editar a filmagem em si — reajustar tempo, recolorir, reenquadrar, reordenar, áudio — é estilo NLE e está fora do escopo; veja § O que o HyperFrames não pode fazer.)
    • PR do GitHub / alteração de código (um link github.com/<dono>/<repo>/pull/<N>, uma referência dono/repo#N, ou "este PR") → /pr-to-video (até ~3 min).
    • Caso contrário (URL / briefing / texto de tópico de produto): a intenção escolhe o workflow via etapa 3, e ele lida com qualquer coisa até ~3 min — um promo curto de 15-30 s e um explicador de ~100 s ambos roteiam por intenção, não por duração. Roteie para /general-video (o fallback independente de duração — veja a etapa 4) apenas quando o alvo estiver claramente mais longo que ~3 min (um tutorial de 3-5 min, um mergulho profundo de 5 min+). Nunca force uma peça genuinamente longa em um workflow de ≤~3 min — a intenção decide dentro da faixa, /general-video cobre o resto.
  3. Desambigue as entradas de URL / texto para ≤~3 min (a divisão de intenção). Duas divisões:
    • Tipo de URL + intenção — uma URL não vence mais automaticamente para PLV; seu tipo depois intenção decide: um link de PR do GitHub (.../pull/<N>, dono/repo#N, "este PR") → /pr-to-video; caso contrário, uma URL de site se divide por intenção — marketing / lançamento / promoção de um produto ou SaaS específico → /product-launch-video; um site geral → vídeo (tour do site, showcase de portfólio / blog / landing page, um clipe social dos próprios visuais do site, ou apenas "transforme este site em um vídeo") → /website-to-video. Ambos rastreiam com Chrome headless; URLs de PR são lidas via gh. Quando não estiver claro se uma URL de site é um lançamento de produto ou um vídeo de site geral, faça uma pergunta.
    • Produto vs tópico (texto, sem URL) — a pergunta decisiva é sobre o que é o vídeo, não o formato de entrada:
      • Um produto / empresa / SaaS / aplicativo / site específico sendo comercializado, lançado ou promovido → /product-launch-video.
      • Um conceito / tópico / artigo / como-algo-funciona sendo explicado, sem produto e sem URL → /faceless-explainer.
      • Desempates: Redação "Promover / lançar / vender / nosso produto" → PLV. "Explicar / ensinar / como X funciona / o que é X" sem produto → faceless. O estilo final para faceless é sempre pin-and-paper.
      • Um site nomeado sem URL colada ainda é PLV. Um roteiro que menciona um produto ou seu site ("nosso site é acme.io", "promover ") roteia para PLV mesmo sem um link clicável — PLV pode pesquisar o site na web e rastreá-lo para ativos da marca (a menos que o usuário opte por não participar, → modo de predefinição sem captura). Não colar a URL não torna isso um trabalho faceless / sem captura. A escolha verbatim-vs-reestruturação para um roteiro fornecido é interna ao PLV e nunca muda a rota.
      • Pistas conflitantes → pergunte, não adivinhe. Se a fonte fornecida é o próprio marketing de um produto (sua landing page, um blog promocional sobre a plataforma deles) mas o usuário pede explicitamente para remover a promoção — um explicador neutro do conceito subjacente, não um anúncio — trate como genuinamente ambíguo (o vídeo é...

...

[truncado para tradução]

Habilidades Relacionadas