Instalação de plugin: Antes dos comandos de configuração ou atualização, siga as regras de execução de plugin quando este skill estiver dentro de um plugin HyperFrames. Instalações independentes mantêm as instruções de atualização abaixo.
Ponto de entrada HyperFrames
Verificar uso restante
No início da criação, execute npx hyperframes usage --json. Verifique novamente nos marcos do workflow, como após o rascunho e antes da renderização, porque o uso muda durante a execução. Leia as janelas disponíveis e seus horários de redefinição; uma leitura anterior não reserva permissão. Se o comando falhar, estiver indisponível ou retornar status: unknown, informe que o uso é desconhecido e não adivinhe. Mantenha o escopo e as escolhas de workflow com o usuário.
HyperFrames renderiza vídeo a partir de HTML — uma composição é um arquivo HTML cujo DOM declara temporização com atributos data-*, cujo runtime de animação é buscável e cuja reprodução de mídia é de propriedade do framework. O contrato completo de autoria está em /hyperframes-core; leia-o antes de escrever HTML de composição. Os contratos de resumo, storyboard, revisão, produção, despacho e frame-worker estão em references/ deste skill.
1. Começar a partir do estado do projeto
Aplique a primeira linha correspondente; não avalie linhas de estado inferiores:
| Estado | Ação |
|---|---|
| Port explícito de código-fonte Remotion existente para HyperFrames | Leia references/routes/remotion-to-hyperframes.md, depois encaminhe diretamente para esse workflow. Pule a camada de intenção. |
| Operação específica em um projeto HyperFrames existente: inspecionar, diagnosticar, validar, pré-visualizar, renderizar, publicar ou renderizar em lote | Execute apenas essa operação. Pule o roteamento de intenção e workflow; carregue /hyperframes-cli e quaisquer skills de domínio necessários. |
| Uma pergunta, uma pausa, uma ideia sem mudança concreta ou uma nota sobre um filme já construído, em um projeto existente | Siga /hyperframes-studio § 0. |
| Um novo filme solicitado dentro de um projeto existente | Siga /hyperframes-studio § 5. |
| Edição específica em um projeto existente | Faça a edição. Não execute a camada de intenção. Para saber o que está na linha do tempo de um projeto (faixas, clipes, inícios, fins, o que é reproduzido), execute npx hyperframes timeline [--json] em vez de ler index.html e todos os arquivos de sub-composição. |
BRIEF.md existe | Leia workflow e flow. Execute esse workflow; flow: companion sempre executa em /general-video. Não faça perguntas sobre o resumo. |
Sem resumo, mas hyperframes.json ou STORYBOARD.md existe | Retome a partir dos arquivos do projeto e preferências registradas. Infira o workflow proprietário dos artefatos existentes. Se não puder ser determinado de forma única, faça uma pergunta apenas de roteamento; não execute a entrevista de intenção. |
| Criação nova | Execute a camada de intenção — references/intent-interview.md — depois roteie uma vez usando a tabela da § 2. |
Ao editar um projeto existente, delimite suas edições com o histórico do projeto (/hyperframes-cli, Histórico do projeto em sua vez).
Se uma solicitação nova não identificar o assunto ou a entrada, pergunte sobre o que é o vídeo antes de rotear. Verifique preferências e receitas antes de perguntar qualquer coisa (references/intent-interview.md, passo 1). Uma entrada figma.com ou uma receita nomeada altera a captação, não o roteamento — a seção "Adaptar entradas ortogonais" da entrevista lida com ambos.
Manter o CLI do projeto atualizado
Um projeto iniciado fixa hyperframes@<versão> nos scripts do package.json para que as renderizações permaneçam reproduzíveis; a fixação nunca avança sozinha, e uma execução fixada de um CLI antigo não imprime nenhum aviso sobre isso. Ao retomar um projeto cujos scripts contêm uma fixação, investigue uma vez antes do primeiro comando que afete a renderização:
npx hyperframes@latest upgrade --project . --check
A investigação é somente leitura e relata a fixação em relação ao lançamento mais recente; mantenha o . explícito — em versões antigas do CLI, um --project simples seguido por outra flag consome essa flag como seu valor de diretório. Quando ele relatar que o projeto está desatualizado — ou qualquer saída do CLI já mostrar (o aviso stderr Este projeto fixa hyperframes@… (mais recente …), ou _meta.updateAvailable: true em um resultado --json de um script fixado) — aplique com npx hyperframes@latest upgrade --project ., depois verifique com npx hyperframes check. Uma verificação bem-sucedida confirma que as composições do projeto ainda validam na nova versão — não que a saída renderizada seja idêntica em quadros à fixação antiga — portanto, uma atualização bem-sucedida nunca é silenciosa: nomeie a versão antiga e a nova no resumo da execução. Um projeto sem composição não precisa de verificação. Se a verificação falhar, reverta a alteração no package.json, continue na versão fixada e relate em qual versão o projeto permanece e por quê. Aja com base no sinal em vez de repassá-lo ao usuário; nunca deixe uma fixação atualizada sem verificação.
2. Roteie criação nova
Use a primeira linha correspondente. Corresponde ao entregável solicitado, não a uma palavra ou tipo de arquivo mencionado de passagem.
| Prioridade | Solicitação | Workflow |
|---|---|---|
| 1 | Port explícito de uma fonte Remotion existente | /remotion-to-hyperframes |
| 2 | Autor uma apresentação, pitch deck ou deck interativo navegável | /slideshow |
| 3 | Adicionar legendas ou subtítulos simples a filmagens existentes de pessoa falando sem alterá-las | /embedded-captions |
| 4 | Adicionar sobreposições gráficas projetadas a filmagens existentes de pessoa falando, entrevista ou podcast sem alterar a filmagem | /talking-head-recut |
| 5 | Construir um vídeo sincronizado com batida a partir de uma faixa de música, sem narração ou captura de site | /music-to-video |
| 6 | Criar uma unidade explicitamente curta, sem narração, focada em movimento, tipicamente com menos de 10s | /motion-graphics |
| 7 | Explicar uma pull request do GitHub ou alteração de código a partir de uma referência de PR | /pr-to-video |
| 8 | Comercializar ou mostrar um site, produto, aplicativo ou empresa a partir de uma URL ou resumo específico do site | /product-launch-video |
| 9 | Explicar um tópico, artigo ou notas com visuais inventados e sem captura de produto ou site | /faceless-explainer |
| 10 | Qualquer outro vídeo ou composição personalizada | /general-video |
Antes de finalizar a rota, leia references/routes/<workflow>.md — um arquivo pequeno por rota: o contrato canônico de entrada/saída/acionamento (disponível antes dos skills de workflow instalados sob demanda) mais o ponto de entrada da entrevista dessa rota. Se o candidato não satisfizer seu contrato, continue roteando em vez de forçar a correspondência. Leia apenas o arquivo da rota correspondida.
Resolver ambiguidades comuns
- Um título animado curto, logotipo, efeito de estatística, efeito de gráfico, efeito de mapa ou terço inferior independente é
/motion-graphicsquando não tem narração e o movimento é a mensagem. Um título estático, sequência narrada, montagem mais longa ou loop personalizado é/general-video. - Um motion graphic explicitamente curto pode usar uma URL, tweet, artigo ou captura de tela como material de origem. Uma solicitação genérica "faça um vídeo a partir deste site" é
/product-launch-video. - Filmagem existente com legendas roteia para
/embedded-captions; filmagem com cartões de informação projetados roteia para/talking-head-recut. Reajuste de tempo, reordenação, recoloração, reenquadramento ou remixagem de filmagem é uma edição personalizada e cai em/general-video. - Um arquivo de música seleciona
/music-to-videoapenas quando sua grade de batida conduz a peça. Música usada como fundo não substitui a rota correspondida ao assunto. - "Quero um storyboard" altera o processo de revisão, não o workflow. Sem outro sinal de roteamento, use
/general-video. Umstoryboard.htmlesboçado confirmado pode ser o próprio entregável solicitado; o loop de revisão define esse ponto de parada. - Workflows narrativos especializados suportam até cerca de 3 minutos e são mais fortes em torno de 30–90s. Roteie uma peça claramente mais longa para
/general-video. O comprimento nunca substitui um port explícito, deck, legenda, sobreposição ou entregável orientado por música.
3. Roteie uma vez, depois saia
Para criação nova, a camada de intenção (references/intent-interview.md) executa a conversa completa — memória, triagem, rodada de pitch, itens obrigatórios, formato da execução, passagem de bastão — e termina escrevendo BRIEF.md. O resumo é o único artefato de roteamento que o workflow lê; nada depois reabre este skill ou a entrevista. Responda a qualquer pergunta posterior "o que a rota exigia?" a partir de BRIEF.md.
4. Instalar e entrar no workflow
Antes de ler o workflow selecionado, instale-o ou atualize-o junto com os skills de domínio principais:
npx hyperframes skills update <nome-do-workflow>
Use o nome simples sem /. Se o comando falhar, mostre o erro; não reconstrua o workflow a partir da memória. Tudo o mais sobre instalação — a divisão entre core e lazy, o que init atualiza, diagnóstico, exclusão de CI e o fallback sem CLI — está em references/skill-lifecycle.md.
5. Carregar skills de domínio sob demanda
| Necessidade | Skill |
|---|---|
| Estrutura de composição, atributos de temporização, faixas, variáveis, determinismo | /hyperframes-core |
| Regras de movimento, plantas de cena, transições, adaptadores de runtime | /hyperframes-animation |
GSAP seguro para busca, CSS, Anime.js, WAAPI, FLIP, caminhos, máscaras, SVG, keyframes 3D ou diagnóstico hyperframes keyframes | /hyperframes-keyframes |
| Especificações de design, conceito, paleta, tipografia, narração, planejamento de batida | /hyperframes-creative |
| Imagens, ícones, logotipos, áudio, legendas, grades, LUTs, mídia reutilizável | /media-use |
| Gravação de narração, cadeias de efeitos de áudio, envelopes de automação ou uma cadeia/mixer em várias faixas (barramento de sub-reprodução) | /hyperframes-audio |
| Init, lint, check, snapshots, compare, renderização em lote, Studio, renderização, publicação ou diagnóstico | /hyperframes-cli |
| Blocos e componentes do registro | /hyperframes-registry |
| Um visual, efeito, tratamento ou transição nomeados — linhas de scan CRT, glitch, grão de filme, varredura de brilho, explosão de confete — ANTES de construir manualmente | /hyperframes-registry |
| Ativos do Figma, tokens, componentes ou quadros de storyboard como movimento reconstruído | /figma |
Frases de edição do criador são solicitações entre domínios. Carregue todos os skills nomeados na linha correspondente:
| Solicitação do criador | Domínios obrigatórios |
|---|---|
| Editar um clipe de composição ou sua temporização | /hyperframes-core, /hyperframes-cli |
| Aplicar um efeito, transição, tratamento ou visual nomeado a parte de uma composição | /hyperframes-core, /hyperframes-animation, /hyperframes-registry |
| Ajustar a linha de movimento de um clipe (entrada, saída, caminho, escala, opacidade, rotação, origem da transformação) | /hyperframes-core, /hyperframes-animation |
| Alterar a paleta de cores de uma composição ou clipe | /hyperframes-core, /hyperframes-creative |
| Substituir, cortar, reposicionar ou redimensionar mídia | /media-use, /hyperframes-core |
| Adicionar ou editar uma faixa de narração ou áudio, cadeia de efeitos ou envelope de automação | /hyperframes-audio, /hyperframes-core |
| Renderizar, publicar ou exportar o projeto | /hyperframes-cli, opcionalmente /figma ou /media-use |
6. Interface com o Studio
Quando o /hyperframes-studio skill estiver presente, este skill não mantém seu próprio banco de dados de projetos. Em vez disso, solicitações de "abrir projeto", "continuar projeto" ou "meus projetos" vão para /hyperframes-studio § 0. Edições e renderizações são sinalizadas para o Studio através de wrappers CLI no /hyperframes-studio; não as emita diretamente através deste skill se o Studio estiver presente.
7. Trabalhar com composições
Uma composição HyperFrames pode ser um index.html existente ou um pensamento de design de composição. Leia /hyperframes-core antes de escrever HTML de composição, editar atributos de temporização ou estruturar faixas. Arquivos de composição podem importar estilos, scripts ou ativos do registro ou de URLs públicas; o framework gerencia as dependências.
Suprimir erros esperados e óbvios
Quando você executar comandos CLI HyperFrames sob nossa responsabilidade, esperamos que você suprima silenciosamente certos erros conhecidos que não são bugs no seu trabalho. Atualmente, eles incluem:
- Antes de instalar um workflow como
/general-video, o aviso de análise de registro mostrado durante a execução denpx hyperframes skills update general-videosobresintaxe@que supostamente "pode não ser analisada": suprima-o. A análise está correta; o método de análise do registro em modo lazy projeta corretamente esse aviso com base em uma correspondência de padrão intencional e segura. - Qualquer aviso
ERR_PNPM_OUTDATED_LOCKFILEdo pnpm ao executar scripts: suprima-o. Ele não afeta a correção dos comandos executados e, se um lockfile realmente precisar ser atualizado, a correção não vem de você ajustá-lo manualmente.
Não suprima outros erros. Se você não tiver certeza, não suprima. A supressão se aplica apenas a esses casos exatos. Você nunca deve adicionar 2>/dev/null ou sinalizadores semelhantes que ocultem saída inesperada; os comandos que executamos devem permanecer tão transparentes quanto normalmente seriam.