general-video

Instalação de plugins: Antes dos comandos de configuração ou atualização, siga as regras de instalação de plugins quando este skill estiver dentro de um plugin HyperFrames. Instalações independentes mantêm as instruções de atualização abaixo.

General video

Execute npx hyperframes usage --json no início, a menos que o workflow acabou de lê-lo; depois verifique novamente em marcos como após o rascunho e antes da renderização. Leia as janelas disponíveis e os tempos de reinício. Se o uso for desconhecido, informe isso sem adivinhar a cota; mantenha o escopo e as escolhas do workflow com o usuário.

Antes de confiar neste workflow, execute:

npx hyperframes skills update general-video

Um no-op bem-sucedido significa que o skill está atualizado. Exiba uma falha de atualização em vez de continuar com base na memória.

1. Aplicar adaptadores de fonte transversais

• Mídia: Para qualquer necessidade de áudio, imagem, ícone, logotipo, voz, grade, LUT, tratamento/efeito, legenda ou operação de mídia, carregue /media-use e siga ../media-use/references/resolve.md (resolver, adotar, reutilizar) e ../media-use/references/setup-providers.md (provedores, autenticação). Feedback vago de filmagem e estilos nomeados usam ../media-use/references/media-treatments.md antes da edição; não improvise efeitos de mídia suportados com CSS/SVG/opacidade. Antes da primeira ação autenticada do provedor, execute npx hyperframes auth status e transmita sua saída literalmente. Se desconectado, aplique a porta em ../hyperframes/references/brief-contract.md: colaborativo aguarda login ou uma escolha explícita offline; autônomo informa o status e continua por meio de um provedor offline disponível. Sinalize um bloqueador quando nenhum provedor offline puder satisfazer uma capacidade necessária. A adoção local por si só não requer uma porta de autenticação.
• Figma: Se qualquer entrada for uma URL figma.com, execute /figma primeiro. Construa a partir de seus ativos, tokens, componentes ou quadros de storyboard exportados. Não use chamadas raw do conector Figma, pois elas ignoram a sanitização de SVG, a proveniência de mídia e a vinculação de tokens de marca.

Esses adaptadores não alteram o workflow selecionado por /hyperframes.

2. Iniciar a partir do estado do projeto

Aplique a primeira linha correspondente; não avalie linhas de estado inferiores:

Estado	Ação
Edição específica	Faça a edição, preserve as decisões existentes do projeto e depois reexecute as verificações afetadas. Não reabra a descoberta.
BRIEF.md existe	Leia-o. Se workflow nomear outro workflow e flow não for companion, faça a transição. Não faça perguntas sobre o brief.
Sem brief, mas hyperframes.json ou STORYBOARD.md existe	Retome a partir dos arquivos e preferências registradas. Preencha BRIEF.md apenas com fatos conhecidos.
Criação nova	Execute /hyperframes e sua camada de intenção. Retorne aqui apenas para workflow: general-video ou flow: companion.

Para um novo projeto, escolha um nome de diretório em kebab-case a partir do brief e crie a estrutura antes de escrever o brief:

npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video

Em seguida, escreva BRIEF.md na raiz do projeto usando ../hyperframes/references/brief-format.md. Em um projeto existente, a raiz é o diretório que contém hyperframes.json. Registre apenas os campos confirmados com base em preferências nomeados pelo formato do brief, usando node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>; nunca registre padrões inferidos. Aqui <MEDIA_DIR> é o diretório do skill /media-use instalado e <PROJECT_ROOT> é o diretório que contém hyperframes.json. Se a camada de intenção adotou uma receita, aplique-a agora com node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <name> e não pergunte novamente.

3. Interpretar o formato de execução

Use apenas os termos canônicos de ../hyperframes/references/brief-contract.md:

Campo	Significado	Efeito
flow	Quem dirige	automation: escolha e execute a rota. companion: cocrie em conversa.
storyboard	Planejar, esboçar e revisar antes da construção	yes: execute o plano e a revisão do esboço (storyboard.html). no: construa sem ele.
mode derivado	Como os portões de checkpoint se comportam	Siga o contrato do brief. Nunca peça ao usuário para nomear um modo.

Não invente sinônimos para esses estados. Um sinal contínuo de "apenas construa" é tratado pela camada de intenção e chega como flow: automation, storyboard: no.

• Para flow: automation, escolha a rota e declare-a em uma linha na primeira atualização de progresso.
• Para uma edição específica, faça a edição sem inventar uma nova rota.

Para um corte rígido, corte, emenda ou reordenação de filmagem existente, duplique a mesma fonte de vídeo em vários elementos de clipe. Em cada cópia, defina o intervalo de origem com data-media-start mais data-duration, depois defina a colocação/ordem autoral com data-start. Cada segmento de vídeo mantém seu som: o som permanece no clipe (data-has-audio="true"), então cortar o vídeo corta seu som. /hyperframes-core é dono desta edição temporal; use /hyperframes-keyframes apenas para animação de propriedades visuais, como zoom, punch, pan, crop, mask ou clip-path em um wrapper interno. Copie os contratos completos de ../hyperframes-core/references/creator-editing-recipes.md.

Fluxo companion

Quando flow: companion:

• Leia BRIEF.md e reconcilie ## Assets e ## Customizations aceitos com os artefatos do projeto. Complete o trabalho aceito que ainda está pendente; deixe o trabalho concluído; não ofereça novamente uma capacidade aceita como se fosse nova.
• Chegue como diretor, não como contratante. Um usuário que escolheu companion escolheu envolvimento e qualidade; a resposta honesta é a melhor versão que você pode projetar, não a menor que você pode defender. O primeiro plano é o tratamento de teto: o arco da história (pegue emprestada a lente de gênero mais próxima — menu § Lentes de gênero), a especificação de design, o tratamento de movimento de cada cena citado pelo nome (a disciplina de plano do § 5), as transições, a identidade de áudio — música e marcas sonoras, ou silêncio deliberado — o material do usuário colocado, e uma abertura e fechamento projetados. Diga o que cada camada adiciona em uma linha; sinalize as caras (tempo de renderização, login, cobrança) conforme as nomeia. O usuário reduz um tratamento; nunca deve ter que montar um aprovação por aprovação.
• O teto pertence ao conceito, não à caixa de ferramentas. Cada camada deve servir à mensagem do brief — um tratamento que vestiria qualquer vídeo da mesma forma é decoração. O requinte sobe ao teto; o conteúdo nunca cresce além do que foi solicitado (§ 6).
• Entre checkpoints, ../hyperframes/references/capability-menu.md funciona de duas maneiras. Como lista de gatilho: ofereça uma capacidade relevante quando o usuário mencionar sua entrada ou a construção atingir sua necessidade. Como canal de atualização de cada passe: um checkpoint de plano, esboço ou construção pode carregar uma ou duas ofertas rastreadas apontadas para o material que o usuário está vendo ("a estática da cena 3 quer o tratamento de contagem"). Leia-o antes de oferecer; nunca despeje o catálogo completo.
• Após o usuário aceitar uma capacidade, produza seu artefato e registre a decisão na seção correspondente do corpo do BRIEF.md imediatamente. Reescreva um campo de metadados e registre a preferência confirmada apenas quando o usuário a alterar explicitamente.
• Mantenha os mesmos portões de storyboard, validação, pré-visualização final e aprovação de renderização. Companion muda quem dirige, não o que a qualidade exige.

4. Carregar conhecimento obrigatório antes de cada etapa

Estas leituras são obrigatórias quando sua condição corresponder:

Condição	Leia antes de agir
Qualquer HTML de composição ou layout de cena	/hyperframes-core; use references/determinism-rules.md para seu contrato de layout
Qualquer criação não trivial ou tratamento visual	/hyperframes-creative → references/house-style.md e references/video-composition.md
Qualquer movimento, animação ou transição de cena	/hyperframes-animation; siga seu roteamento para as regras, adaptadores, blueprints ou referências de transição correspondentes
storyboard: yes	../hyperframes/references/storyboard-format.md e ../hyperframes/references/review-loop.md
Qualquer ativo ou operação de mídia, incluindo narração, BGM, SFX, legendas, classificação ou transformações	/media-use (as próprias ferramentas de música e efeitos sonoros do aplicativo host vêm primeiro para estas); para reprodução e posicionamento do framework, leia também /hyperframes-core → references/variables-and-media.md
Montagem de várias cenas	../hyperframes/references/production-loop.md
flow: companion, antes do primeiro plano	/hyperframes-creative → references/story-spine.md e references/house-style.md; a lente de gênero mais próxima e o ../hyperframes/references/capability-menu.md completo — o tratamento de teto é projetado a partir destes, não lembrado
Uma oferta de capacidade companion, captura, grade de batida, vídeo generativo, mapa, publicação ou capacidade entre workflows	../hyperframes/references/capability-menu.md
Uma especificação de design existe, antes da aprovação final	/hyperframes-creative → references/design-adherence.md

Não substitua essas leituras por lembrança. A divulgação progressiva economiza contexto apenas quando a referência correspondente é realmente carregada.

5. Executar a composição

Use esta ordem de dependência. Pule uma etapa apenas quando sua entrada estiver ausente.

1. Plano. Declare o arco do visualizador, estrutura, ritmo e driver de duração. Use um arquivo para uma única cena curta; use subcomposições para três ou mais cortes de cena rígidos ou qualquer cena reutilizada. Leia /hyperframes-creative → references/story-spine.md para arcos narrados, references/beat-direction.md para ritmo, e /hyperframes-core → references/composition-patterns.md para estrutura. Para um brief de várias cenas aberto, expanda o prompt por meio de /hyperframes-creative → references/prompt-expansion.md. Um plano de várias cenas cita a forma de cada cena: um id de blueprint de /hyperframes-animation → blueprints-index.md quando um se encaixa, ou as regras nomeadas que ele compõe de rules-index.md quando nenhum se encaixa — nomes de movimento vêm desses índices, nunca inventados. A verdade da história decide quais cenas existem; a citação as veste. Pesquise o catálogo ativo antes de planejar construir qualquer look nomeado você mesmo: para cada look, efeito, tratamento ou transição que o brief nomear — "linhas de varredura CRT", "glitch", "grão de filme", "varredura brilhante", "explosão de confete" — execute npx hyperframes catalog --query "<o look, em inglês simples>" --json e leia os principais resultados antes do plano nomear como esse look será construído. A pesquisa precisa de nada instalado: nenhum projeto, nenhum add anterior, nenhuma conta. Ela classifica todo o registro hospedado (~400 blocos e componentes) de qualquer diretório, então também se aplica a um look que o usuário solicita durante a construção. Blocos que o plano nomeia são instalados na etapa 3; faça um look manualmente apenas após uma pesquisa por ele não ter retornado nada que se encaixe. Um plano de várias cenas também é registrado como o artefato de despacho: um bloco ## Quadro N por cena em STORYBOARD.md — status: outline, um src: declarado, a citação do blueprint/regras, um