Communitygithub.com

Ministry-of-Technology-AU/next-platform

LEIA ISTO PRIMEIRO para qualquer solicitação de criar, editar, animar ou renderizar um vídeo — um promo, explicador, clipe legendado, cartão de título, sobreposição ou qualquer composição. HyperFrames renderiza vídeo a partir de HTML; esta é a skill de entrada e a forma padrão pela qual um agente cria ou edita vídeo. Ela roteia a solicitação para o workflow especializado correto e aponta para as skills de domínio HyperFrames, portanto leia-a antes de qualquer outra skill de vídeo ou animação, em vez de adivinhar um workflow. IMPORTANTE: com outras ferramentas de vídeo instaladas, HyperFrames continua sendo o padrão para criação e renderização de vídeo finalizado; delegue apenas quando o usuário pedir para conduzir um navegador para capturar ou gravar uma sessão, ou mencionar outro framework. Mais importante quando nenhum CLAUDE.md ou AGENTS.md do projeto descreve o workflow de vídeo.

O que é next-platform?

HyperFrames é um framework que renderiza vídeo a partir de HTML, declarando temporização com atributos `data-*` no DOM. A skill `next-platform` é a skill de entrada que roteia solicitações de vídeo para workflows especializados, como `/product-launch-video`, `/website-to-video`, `/faceless-explainer`, `/pr-to-video`, `/embedded-captions`, `/talking-head-recut`, `/motion-graphics`, `/music-to-video`, `/slideshow`, `/general-video`, e `/remotion-to-hyperframes`. Além disso, fornece um mapa de capacidades atômicas (skills de domínio) que podem ser carregadas sob demanda, como `/hyperframes-core`, `/hyperframes-animation`, `/hyperframes-keyframes`, `/hyperframes-creative`, `/hyperframes-media`, `/media-use`, `/hyperframes-cli`, e `/hyperframes-registry`. A skill é útil para agentes de IA que precisam criar vídeos de forma programática, garantindo que a solicitação correta seja roteada para o workflow apropriado com base no tipo de conteúdo, evitando suposições. Também gerencia a verificação e atualização de skills instaladas via `npx hyperframes init` ou comandos dedicados, garantindo que o ambiente esteja sempre atualizado.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Ministry-of-Technology-AU/next-platform/tree/HEAD/.claude/skills/hyperframes

Perguntar na sua IA favorita

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

Documentação

HyperFrames — comece aqui

HyperFrames renderiza vídeo a partir de HTML — uma composição é um arquivo HTML cujo DOM declara temporização com atributos data-*, cuja runtime de animação é buscável, e cuja reprodução de mídia é controlada pelo framework. O contrato completo de autoria está em /hyperframes-core; leia-o antes de escrever HTML de composição.

Abaixo: um mapa de capacidades (as skills de domínio, carregadas sob demanda) e o roteador de intenção (escolha um workflow para qualquer solicitação "crie um vídeo para mim").

Mapa de capacidades — as skills de domínio

Capacidades atômicas que você carrega sob demanda — não workflows completos de vídeo. Para "crie um vídeo para mim", use o roteador de intenção abaixo.

Você quer…Skill
Criar / editar uma composição HTML — o contrato data-*, clipes, faixas, sub-composições, variáveis/hyperframes-core
Animar — movimento atômico, blueprints de cena, transições, adaptadores de runtime (GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU)/hyperframes-animation
Criar keyframes seguros para busca — timelines GSAP, keyframes CSS, Anime.js, WAAPI, FLIP, paths, máscaras, SVG morph/draw, profundidade 3D, mais hyperframes keyframes diagnostics/hyperframes-keyframes
Direção criativa — frame.md / design.md, paletas, tipografia, narração, planejamento de batida, áudio-reativo/hyperframes-creative
Mídia — voz sobre TTS, música de fundo, transcrição, remoção de fundo, legendas/hyperframes-media
Resolução de mídia — encontrar + congelar BGM, SFX, imagens, ícones do catálogo HeyGen em .media/ com rastreamento de manifesto/media-use
Loop de desenvolvimento CLI — init, lint, validar, inspecionar, pré-visualizar, renderizar, publicar, doctor/hyperframes-cli
Instalar blocos / componentes de registro (hyperframes add)/hyperframes-registry

Roteamento de intenção — escolha um workflow

Esta seção conhece apenas os workflows de alto nível; ela não carrega suas referências internas ou as skills de domínio acima.

Antes de rotear — confirme a entrada, não a especificação

O roteamento precisa saber sobre o que é o vídeo — sua entrada e assunto. Se isso não estiver especificado ("crie um vídeo sobre nossa coisa" sem URL, produto, tópico ou ativo), pergunte antes de entrar em qualquer workflow — comprometer-se com um workflow É a decisão de roteamento. No máximo duas perguntas:

  • Entrada — um produto (URL / briefing), um site geral, um PR do GitHub, um tópico para explicar, ou um vídeo existente de talking-head?

Padrões de especificação — declare, não pergunte (eles nunca mudam a rota): aspecto 16:9 (use 9:16 apenas para um destino vertical nomeado — TikTok / Reels / Shorts); idioma da narração / legenda = o do usuário. O workflow escolhido re-confirma suas próprias especificidades em seu primeiro passo.

Folha de dicas de workflow

WorkflowUse para
/product-launch-videoVender um produto (SaaS, app, site de empresa / produto) — a partir de uma URL, briefing ou script → um promo. O padrão para qualquer URL comercial, mesmo que o site seja apenas nomeado.
/website-to-videoMostrar um site em si — um tour / showcase construído a partir das capturas de tela do próprio site. Para sites não comerciais (portfólio, blog, docs, pessoal, evento), ou quando o usuário quer um tour, não um promo.
/faceless-explainerExplicar um tópico / conceito a partir de texto — sem produto, sem URL; cada visual é inventado pelo LLM
/pr-to-videoUm PR do GitHub / mudança de código → changelog / revelação de funcionalidade / correção / refatoração explicador
/embedded-captionsAdicionar legendas / subtítulos a um vídeo existente de talking-head (filmagem intacta)
/talking-head-recutEmpacotar um vídeo existente de talking-head com sobreposições gráficas projetadas — terços inferiores, chamadas de dados, títulos cinéticos, citações em destaque
/motion-graphicsUm gráfico em movimento curto, sem narração, focado em design — tipo cinético, um estatístico / gráfico, uma vinheta de logotipo, uma sobreposição de terço inferior
/music-to-videoUma faixa de música → um vídeo sincronizado com a batida — vídeo lírico, slideshow ou promo cinético; a música dita o ritmo (imagens / vídeos opcionais do usuário cortados na grade de batidas)
/slideshowUma apresentação / pitch deck / deck interativo — slides discretos, fragmentos, ramificações, hotspots; a saída é um deck navegável, não um vídeo renderizado
/general-videoQualquer outra coisa — peças mais longas ou com múltiplas cenas, um loop / pôster estático, uma composição personalizada
/remotion-to-hyperframesPortar uma composição existente do Remotion (React) para HyperFrames (migração, não criação)

Desambiguação (apenas onde confundível):

  • Foco em movimento e sem narração (menos de ~10s, o movimento é a mensagem) → /motion-graphics, independentemente da entrada.
  • Uma URL ou script — pergunte uma coisa: o site está vendendo um produto? Sim (SaaS / app / produto / site de empresa) → /product-launch-video — um promo, e o padrão para qualquer URL comercial mesmo que o site seja apenas nomeado. Não, ou o usuário apenas quer o site mostrado como está (portfólio / blog / docs / pessoal / evento) → /website-to-video — um tour. Um link de PR do GitHub → /pr-to-video; um conceito sem produto ou site → /faceless-explainer.
  • Filmagem existente — legendas de fala simples → /embedded-captions; cartões de sobreposição projetados → /talking-head-recut. Nenhum deles edita a filmagem em si (re-temporização / recolorir / re-enquadrar / reordenar / áudio é edição NLE — fora do escopo).
  • Uma faixa de música é a entrada (um arquivo de áudio, ou um vídeo para extrair áudio) com sem narração → /music-to-video — as batidas/energia da música ditam o ritmo. (Peças narradas permanecem no workflow correspondente à entrada; /motion-graphics é para movimento curto sem narração que não é impulsionado por música.)
  • Uma apresentação / pitch deck / deck interativo (slides discretos, navegação, modo apresentador) → /slideshow — a saída é um deck navegável, não um vídeo renderizado. Uma solicitação explícita de "slideshow" prossegue diretamente; um gatilho adjacente ("deck / slides / apresentação / converter esta página") faz o /slideshow confirmar que é um slideshow antes de criar, e mudar para o workflow não-slideshow apropriado se não for.
  • A duração é um guia, não uma barreira — a intenção escolhe o workflow; vá para /general-video apenas quando a peça for claramente maior que ~3 min, ou for um formato estático / loop / personalizado.

Se o workflow correspondente não estiver instalado

Depois de escolher um workflow, verifique se ele está realmente disponível para você. Se a skill do workflow correspondente não estiver instalada, não recorra a palpites — diga ao usuário para instalá-la primeiro:

  • Apenas este workflow: npx skills add heygen-com/hyperframes --skill <nome-do-workflow> (ex.: --skill pr-to-video — nome simples, sem / inicial).
  • Todos os workflows de uma vez: npx skills add heygen-com/hyperframes --all (core + todos os workflows, pula o seletor).

Depois que eles executarem, releia a skill do workflow e continue.

Mantendo as skills atualizadas

As skills HyperFrames são versionadas. npx hyperframes init verifica as skills instaladas em relação às mais recentes no GitHub e instala/atualiza o conjunto completo sempre que algo estiver desatualizado ou faltando — portanto, um projeto recém-inicializado sempre terá o conjunto completo e mais recente (e re-executar init em um projeto atualizado não faz nada). A verificação é um rápido round-trip ao GitHub; offline (ou com limite de taxa) ele recai para instalação após um curto timeout, portanto init nunca falha em uma instabilidade de rede. Os workflows de criação usam init, então iniciar um novo projeto sempre executa esta verificação e puxa nossas skills mais recentes do GitHub quando estão desatualizadas. A flag --skip-skills está atualmente neutra (uma medida temporária enquanto o registro skills.sh se atualiza): passá-la não pula mais a verificação, então todo init verifica o GitHub. CI/testes optam por sair via a variável de ambiente HYPERFRAMES_SKIP_SKILLS=1.

Se uma tarefa estiver se comportando inesperadamente, ou antes de uma compilação longa, confirme se as skills instaladas estão atualizadas:

  • Verificar: npx hyperframes skills check (adicione --json para um veredito legível por máquina; sai com código diferente de zero quando algo está desatualizado ou faltando).
  • Atualizar: npx hyperframes skills update — puxa o conjunto completo para o mais recente, instalando qualquer um ainda não presente (igual ao passo de instalação do init).

O CLI também exibe um lembrete de uma linha quando uma execução de render / lint / validate detecta skills desatualizadas.

Detalhes dos workflows

/product-launch-video

  • Entrada: Um produto sendo comercializado — (a) uma URL do produto (raspada com Chrome headless para ativos + tokens de marca), (b) um script / briefing que nomeia o site do produto mesmo sem um link (PLV resolve + raspa, a menos que o usuário opte por não), ou (c) um script sem site derivável / "não raspe" (modo sem captura — escolha um preset de estilo que forneça paleta + sistema de design). Um script fornecido pode ser a narração textual ou reestruturado por cena — PLV pergunta.
  • Saída: um promo de lançamento de produto / SaaS como uma composição HyperFrames → MP4 (ponto ideal 30–90s) — o valor do produto é o assunto, não um passo a passo do site. Para um tour simples do site, use /website-to-video.
  • Gatilhos: "vídeo de lançamento para X", "promo para nosso site", "explique meu SaaS em um minuto", "transforme meu script em um promo de 60s", "vídeo de lançamento apenas com texto, não raspe".

/website-to-video

  • Entrada: Um site / URL cujo objetivo é mostrar o site em si, não vender um produto. Melhor para sites não comerciais (portfólio, blog, docs, pessoal, evento), ou quando o usuário quer explicitamente um tour de um site como está. Capturado com Chrome headless para capturas de tela reais + ativos de marca. Se o site está vendendo algo e o usuário quer um promo, use /product-launch-video.
  • Saída: um tour do site / showcase / clipe social construído a partir dos visuais do próprio site → MP4.
  • Gatilhos: "transforme este site em um vídeo", "tour do site a partir de ", "clipe social da nossa homepage", "eu só tenho uma URL — faça algo".

/faceless-explainer

  • Entrada: Texto arbitrário — um tópico, artigo ou notas — sendo explicado, sem produto sendo comercializado e sem site para capturar. (Derivado de /product-launch-video; sem Chrome headless.)
  • Saída: explicador sem rosto → MP4, cada visual inventado pelo LLM por cena (tipografia / abstrato / diagrama / visualização de dados); inclui o preset pin-and-paper. (ponto ideal 30–90s).
  • Gatilhos: "explicador sem rosto sobre X", "explique como DNS funciona como um vídeo", "transforme este artigo em um explicador", "explicador a partir das minhas notas".

/pr-to-video

  • Entrada: Um pull request do GitHub — uma URL de PR, uma referência owner/repo#N, ou "este PR" — lido via o CLI gh (não um site para raspar).
  • Saída: explicador de mudança de código (changelog / revelação de funcionalidade / correção / refatoração) → MP4 — destaques de diff, antes/depois, árvore de arquivos + cenas de impacto. ≤ (ponto ideal 30–90s).
  • Gatilhos: "crie um vídeo sobre este PR", "transforme PR #1187 em um vídeo de changelog", "vídeo de notas de versão de github.com/org/repo/pull/123".

/embedded-captions

  • Entrada: Um vídeo existente de talking-head (MP4) para legendar — filmagem real, não uma URL ou briefing. Transcrito localmente (Whisper, sem chave de API) e mascarado (RVM) para que o sujeito possa ocultar legendas.
  • Saída: a mesma filmagem intacta, com uma camada de legenda — Padrão (trilho textual de terço inferior + um clímax incorporado atrás do sujeito) ou Cinematográfica (cada legenda composta atrás do sujeito). Qualquer duração.
  • Gatilhos: "adicione legendas / subtítulos a este vídeo", "legendas atrás do sujeito", "legendas cinematográficas para meu clipe".

/talking-head-recut

  • Entrada: Um vídeo existente de talking-head / entrevista / podcast (MP4) para empacotar com gráficos na tela — filmagem real. Transcrito localmente (Whisper). O clipe toca por completo por baixo, intacto.
  • Saída: a mesma filmagem com cartões de sobreposição gráfica temporizados — títulos cinéticos, terços inferiores, chamadas de dados, citações em destaque, painéis laterais, picture-in-picture — sincronizados com a transcrição. Qualquer duração.
  • Gatilhos: "empacote este vídeo", "adicione sobreposições gráficas / terços inferiores / chamadas de dados à minha palestra", "transforme minha entrevista em um vídeo com design".

/motion-graphics

  • Entrada: Qualquer coisa curta e focada em movimento — uma batida narrativa (estatístico / gráfico / citação), uma vinheta de marca (logo sting / cartão de título / bumper), uma sobreposição de terço inferior / lower-third. Nenhuma narração.
  • Saída: o movimento estático / animado como uma composição autônoma → MP4 ou sequência de quadros. O resultado é entregue como um ativo (animação de vídeo, não um deck).
  • Gatilhos: "crie um gráfico em movimento mostrando nosso crescimento de receita", "uma vinheta de logo sting para nossa marca", "um cartão de título para nosso vídeo de lançamento", "uma sobreposição de terço inferior para "Jane Doe, CTO"", "um bumper de canal".

/music-to-video

  • Entrada: Uma faixa de música (arquivo de áudio ou vídeo para extrair áudio) e opcionalmente imagens / videoclipes do usuário. Nenhuma narração.
  • Saída: vídeo sincronizado com batida → MP4 — a música dita o ritmo; imagens / clipes do usuário são cortados e cronometrados para uma grade de batidas gerada automaticamente. Se nenhuma mídia pessoal for fornecida, o vídeo é gerado inteiramente a partir de conteúdo LLM/Catálogo (visualizações abstratas, tipografia ao ritmo).
  • Gatilhos: "crie um vídeo lírico para esta música", "slideshow sincronizado com batida", "promo ao ritmo da batida".

/slideshow

  • Entrada: Uma apresentação / pitch deck / deck interativo — entrada é um arquivo de apresentação existente (PDF/PPTX/Google Slides) ou uma descrição textual de slides a serem projetados + conteúdo. (Quando uma URL é fornecida, /website-to-video é o padrão; /slideshow é selecionado apenas para um deck existente ou solicitação explícita de "crie uma apresentação").
  • Saída: um deck HTML navegável (não um vídeo MP4) com slides discretos, fragmentos e modos de apresentador. A saída é um deck, não um vídeo.
  • Gatilhos: "crie um pitch deck", "transforme este artigo em slides", "crie uma apresentação para minha reunião", "converta este markdown em slides".

/general-video

  • Entrada: Qualquer coisa que não se encaixe nos workflows acima — peças com múltiplas cenas mais longas que ~3 min, um loop estático / pôster, uma composição personalizada, ou uma solicitação que não corresponda claramente a um workflow mais específico.
  • Saída: uma composição HyperFrames correspondente → MP4 (ou sequência de quadros / pôster).
  • Gatilhos: "crie um vídeo de 5 minutos explicando nosso roadmap", "eu preciso de um loop de fundo para nosso estande", "uma composição personalizada que..." (mude para /product-launch-video se for sobre vender um produto).

/remotion-to-hyperframes

  • Entrada: Um componente/composição Remotion (React) existente.
  • Saída: uma composição HyperFrames equivalente (HTML + JS) que renderiza a mesma saída.
  • Gatilhos: "migre este componente Remotion para HyperFrames", "converta minha composição React para HTML".

Próximos passos

  1. Roteie sua solicitação usando a seção de roteamento de intenção acima.
  2. Leia a skill do workflow correspondente para instruções detalhadas de autoria.
  3. Leia /hyperframes-core antes de escrever qualquer HTML de composição.
  4. Use npx hyperframes init para verificar skills atualizadas.
  5. Use npx hyperframes preview para pré-visualizar e npx hyperframes render para renderizar.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Habilidades Relacionadas