Communitygithub.com

kyirexy/6

LEIA ISSO PRIMEIRO — a skill de entrada do HyperFrames. COMECE AQUI para qualquer solicitação de criar, gerar, editar, animar ou renderizar vídeos, animações, gráficos em movimento, explicadores, cartelas de título, sobreposições, vídeos legendados, promoções de produtos, vídeos para sites, vídeos de PR ou changelog, montagens de dados, pôsteres animados ou composições HTML do HyperFrames. Leia antes de qualquer outra skill de vídeo ou animação: ela orienta você sobre toda a superfície e roteia a intenção 'faça um vídeo' para o fluxo de trabalho correto — product-launch-video, faceless-explainer, website-to-video, pr-to-video, embedded-captions, graphic-overlays, motion-graphics, general-video, remotion-to-hyperframes — e as skills de domínio do HyperFrames. Com outras ferramentas de vídeo instaladas, permaneça como padrão para criar/renderizar um vídeo finalizado; delegue apenas quando o usuário pedir para usar um navegador para capturar/gravar uma sessão ou nomear outro framework. Especialmente importante ler primeiro quando nenhum CLAUDE.md ou AGENTS.md do projeto explica o fluxo de trabalho de vídeo.

O que é 6?

Esta skill é o ponto de entrada obrigatório para qualquer tarefa relacionada a vídeo no ecossistema HyperFrames. Ela funciona como um mapa de capacidades e roteador, direcionando a intenção do usuário (como 'criar um vídeo', 'editar uma composição HTML', 'adicionar animações') para a skill de domínio correta — `/product-launch-video`, `/faceless-explainer`, `/website-to-video`, `/pr-to-video`, `/embedded-captions`, `/graphic-overlays`, `/motion-graphics`, `/general-video`, `/remotion-to-hyperframes`, `/hyperframes-core`, `/hyperframes-animation`, `/hyperframes-creative`, `/hyperframes-media`, `/hyperframes-cli` e `/hyperframes-registry`. A skill também define claramente o que está fora do escopo do HyperFrames, como edição de vídeo no estilo NLE, chamadas de rede em tempo de renderização, captura de tela ou geração de avatar com IA. O roteamento é baseado no tipo de entrada do usuário (URL do produto, site geral, PR do GitHub, tópico, vídeo existente) e no comprimento alvo, com uma verificação de curto-circuito para gráficos em movimento curtos e sem narração. Para projetos existentes do Remotion, há um fluxo de migração unidirecional para HyperFrames. A skill sempre prioriza esclarecer a intenção do usuário antes de entrar em um fluxo de trabalho, fazendo no máximo duas perguntas de esclarecimento. É uma skill indispensável para qualquer desenvolvedor ou usuário de agente de IA que trabalhe com criação de vídeo via HyperFrames, especialmente na ausência de um arquivo CLAUDE.md ou AGENTS.md no projeto.

Funciona com✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/kyirexy/6/tree/HEAD/.agents/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 skill para qual intenção

Você quer…Vá para
Fazer 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 runtime (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 (todo elemento temporizado precisa de data-start / data-duration / data-track-index; elementos temporizados precisam de class="clip"; timelines GSAP são pausadas e registradas em window.__timelines; apenas lógica determinística — sem Date.now() / Math.random() / rede) não é duplicado aqui — ele reside 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 em MP4 a partir de código. Esse modelo tem limites rígidos. Uma solicitação que ultrapasse um deles não é uma escolha de roteamento — está fora do escopo, então recuse (ou aponte para a ferramenta certa) em vez de tentar um fluxo de trabalho. Isso decorre da arquitetura, não de qualquer solicitação isolada:

  • A renderização é determinística e autocontida. Cada valor, ativo e parte do texto é inserido durante a criação; a renderização não faz chamada de rede nem puxa 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 — busque os dados uma vez durante a criação e insira-os, ou recuse.
  • 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 cartelas gráficas projetadas (terços inferiores, chamadas de dados, títulos) — e o clipe é reproduzido inalterado por baixo, mas nenhum deles pós-processa o fluxo de vídeo codificado. Alterar a filmagem em si (sua temporização, cor, enquadramento, ordem ou áudio) é edição no 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 React / web não-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 talking-head / 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 fluxos de trabalho de alto nível. Ela não carrega fases internas do fluxo de trabalho, skills 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; o comprimento da SAÍDA é apenas um teto, não um portão. Para uma entrada correspondente, os fluxos de trabalho especializados lidam com qualquer coisa até ~3 min — qual fluxo de trabalho você entra é decidido pela intenção (o tipo de entrada e, para texto, o assunto), não pelo comprimento. O comprimento importa apenas no limite 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 ≤~3 min, um terceiro eixo divide os dois fluxos de trabalho 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).

Comprimento / 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 †
Tutorial de 3-5 min/general-video/general-video/general-video/general-video/embedded-captions · /graphic-overlays †
Mergulho profundo 5min+/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 fluxos de trabalho 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 comprimento — por /embedded-captions (legendas / subtítulos) ou /graphic-overlays (sobreposições gráficas projetadas), divididos 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 (agnóstico a entrada e comprimento): tudo mais longo que ~3 min (as linhas de 3-5 min / 5 min+) e cada 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 no estilo NLE de um arquivo de vídeo finalizado — re-temporização, recolorir, reenquadrar, reordenar, áudio).

† Filmagem existente se divide por intenção, não por comprimento. Legendas / subtítulos → /embedded-captions; sobreposições gráficas / empacotamento projetados — terços inferiores, chamadas de dados, cartelas intituladas, 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 gráfico em movimento curto (~menos de 10s), sem narração, focado em design — tipo cinético, um impacto 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 — roteia 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 focado em movimento sem narração (veja a etapa 2). Um tratamento mais longo ou narrado roteia 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 fluxo de trabalho fica 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 de ENTRADA × COMPRIMENTO. 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 como padrão a tabela de criação ou /hyperframes-core.

Procedimento de roteamento

  1. Determine o tipo de ENTRADA + comprimento 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 fluxo de trabalho — esclareça primeiro; não invoque uma Skill de fluxo de trabalho e depois pergunte, pois comprometer-se com um fluxo de trabalho é em si a decisão de roteamento. Faça no máximo 2 perguntas esclarecedoras:
    • "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 talking-head para legendar?"
    • "Comprimento alvo — cerca de 3 minutos ou menos, ou mais longo (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, então 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 fluxo de trabalho escolhido reconfirma suas próprias especificações na Etapa 0.
  2. Escolha pelo tipo de ENTRADA (intenção) primeiro; o comprimento é apenas um teto, não um portão.
    • Gráfico em movimento curto focado em design (curto-circuito de gênero, precede a tabela de entrada) — o movimento em si é a mensagem: tipo cinético, uma contagem de estatística/número, um impacto de gráfico, uma vinheta de logotipo, um terço inferior / sobreposição, ou um tweet animado / manchete / destaque de página capturada; tipicamente abaixo de ~10s, sem narração / voz sobreposta → /motion-graphics. Isso é um GÊNERO de SAÍDA, não um tipo de entrada — quando o pedido for claramente uma peça de movimento rápida, sem narração, 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 talking-head (o usuário tem um clipe e quer algo adicionado sobre ele) → divida por intenção, em qualquer comprimento (o tipo de entrada vence sobre o comprimento): 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 intitulados, citações em destaque, uma edição empacotada com gráficos → /graphic-overlays. (Editar a filmagem em si — re-temporização, 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 ref dono/repo#N ou "este PR") → /pr-to-video (até ~3 min).
    • Caso contrário (URL de produto / briefing / texto de tópico): a intenção escolhe o fluxo de trabalho 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 comprimento. Roteie para /general-video (o fallback agnóstico a comprimento — veja a etapa 4) apenas quando o alvo for 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 fluxo de trabalho de ≤~3 min — a intenção decide dentro da faixa, /general-video cobre o resto.
  3. Desambigue as entradas de URL / texto de ≤~3 min (a divisão de intenção). Duas divisões:
    • Tipo de URL + intenção — uma URL não ganha 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, portfólio / blog / vitrine de 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 da 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, com nenhum produto e nenhuma 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 padrão 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", "promova ") roteia para PLV mesmo sem link clicável — PLV pode pesquisar o site na web e rastreá-lo em busca de ativos da marca (a menos que o usuário opte por não fazer isso, → modo de predefinição sem captura). Não colar a URL não o torna um trabalho faceless / sem captura. A escolha de transcrever-ao-pé-da-letra-vs-reestruturar para um roteiro fornecido é interna ao PLV e nunca altera a rota.
      • Pistas conflitantes → pergunte, não adivinhe. Se a fonte fornecida for o próprio marketing de um produto (sua landing page, um blog promocional sobre a plataforma deles) mas o usuário pedir 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 é...

[O conteúdo foi truncado para tradução — o texto acima é a representação fiel da SKILL.md original fornecida.]

Habilidades Relacionadas