Communitygithub.com

scroll-video-website

Construa ou refine um site onde a rolagem nativa controla um vídeo aprovado e coordena transições de objetos para o conteúdo da página. Use para entradas cinemáticas conduzidas pela rolagem e movimento fotográfico de objetos, em vez de incorporações comuns de vídeo em reprodução automática.

O que é scroll-video-website?

Esta skill permite que um agente de IA crie ou refine uma experiência de site onde a rolagem do usuário controla diretamente a reprodução de um vídeo, sem necessidade de bibliotecas de animação específicas. É útil para criar entradas cinematográficas, revelações de produtos, movimentos de objetos fotográficos e transições suaves de elementos visuais para o conteúdo da página, como um item que se move para sua seção de detalhes. A skill suporta plataformas de desenvolvimento web em geral e funciona mapeando o progresso da rolagem nativa (scroll) para a linha do tempo do vídeo e transformações de objetos em CSS/JavaScript, utilizando requestAnimationFrame para atualizações suaves. O workflow garante que a interação seja responsiva, reversível e acessível, com tratamento de estados como redução de movimento, falha de carregamento de mídia e preservação da navegação do site.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/itsmanuelarx/creative-web-animation-skills/tree/HEAD/skills/scroll-video-website

Perguntar na sua IA favorita

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

Documentação

Site de vídeo com rolagem

Transforme uma sequência visual aprovada em uma interação responsiva e reversível no site. Reutilize a pilha tecnológica existente e os assets aprovados; a técnica não exige uma biblioteca de animação específica. O assunto, o percurso e o destino são entradas do projeto. Aplique o workflow em giros de produto, revelações de interiores, obras de arte ou outras histórias visuais. Um disco caindo e um toca-discos são exemplos, não uma cena obrigatória.

Estabelecer a interação

Inspecione a implementação atual, a versão aprovada e o feedback mais recente do usuário antes de editar. Resolva a partir desse contexto:

  • Qual movimento está no vídeo e quais objetos são animados separadamente em código?
  • A rolagem controla o clipe completo ou um segmento com tempo definido precede a rolagem? Siga o comportamento selecionado. Uma solicitação de rolagem desde o início deve funcionar no primeiro movimento da roda ou toque sem uma barreira de clique.
  • Onde a cena final se torna conteúdo comum da página? Como os visitantes podem acessar o conteúdo principal diretamente?
  • Quais tamanhos e plataformas importam e qual visualização deve permanecer disponível?

Se apenas alterações de temporização ou controle forem solicitadas, não regenere a mídia. Salve a versão funcional atual e crie uma alternativa isolada quando a comparação for solicitada.

Preparar a mídia

Use o vídeo exato e os fotogramas estáticos inicial/final decodificados correspondentes. Preserve a interpretação de cores, a proporção de aspecto e o arquivo original. Se a própria emenda estiver errada, corrija a transferência da mídia antes de ocultá-la com efeitos de interação.

Inspecione a duração, taxa de quadros, dimensões e comportamento de busca. Intervalos menores entre quadros-chave podem ajudar na varredura; uma cópia com todos os quadros-chave pode ser útil para um protótipo local, mas pode se tornar muito grande para implantação. Avalie o derivado no navegador real e otimize a entrega separadamente. Não prescreva uma configuração de codificação para cada clipe.

Mantenha um pôster enquanto os metadados e os quadros carregam. Retenha o último horário solicitado e aplique-o quando o vídeo estiver pronto. Um vídeo ausente ou rejeitado deve deixar uma rota estática utilizável para o conteúdo.

Mapear a rolagem para uma linha do tempo

  1. Use uma trilha de rolagem nativa e um palco visual fixo (sticky) quando eles se adequarem ao layout existente. Mantenha o documento rolável imediatamente se a rolagem for o controle de entrada. Evite interceptar a roda e capturar o toque apenas para simular uma barra de rolagem.
  2. Divida a história selecionada em intervalos intencionais, como movimento do assunto, revelação da câmera, uma cena estabilizada, transferência de objeto e conteúdo. Use apenas as fases que servem ao projeto; um giro de produto não precisa incluir uma queda ou revelação do ambiente. Aloque distância suficiente para eventos breves, mas importantes. Mapeie cada intervalo para seu progresso de mídia ou transformação; os segundos do clipe não precisam mapear uniformemente para pixels de rolagem.
  3. Atualize a partir de um requestAnimationFrame agendado por eventos de rolagem. Leia o layout ao medir, não repetidamente dentro de toda atualização de animação.
  4. Mantenha o vídeo pausado para varredura (scrubbing). Unifique as buscas: armazene o último alvo, não inicie uma busca concorrente enquanto uma estiver pendente e aplique o último alvo após o evento seeked. Não construa um acúmulo de quadros obsoletos.
  5. Limite os pontos finais, com uma pequena tolerância de pixel para cálculos fracionários de viewport. Teste o primeiro e o último quadro usando posições reais de rolagem do navegador.
  6. Faça com que a rolagem parada mantenha o estado atual. Inverta cada fase de acordo com a interação escolhida, incluindo a ação de abertura quando todo o clipe for controlado por rolagem.
  7. Cancele o deslocamento programático quando o visitante fornecer entrada de roda, toque ou tecla de navegação. Evite que o redimensionamento e posições de rolagem restauradas pulem inesperadamente o estado de abertura.

Para uma entrada híbrida, defina explicitamente qual segmento é temporizado e onde a rolagem reversa para. Não introduza silenciosamente um segmento temporizado em uma experiência totalmente controlada por rolagem.

Manter objetos fotográficos contínuos

Use um objeto visível durante o movimento escolhido e a transferência, quando prático, como um produto que se move para sua visualização de detalhes ou uma obra de arte que se transfere para uma galeria. Se for necessário reparentalizá-lo em um destino, combine sua posição e projeção antes e depois dessa mudança.

Uma rotação completa de ponta a ponta precisa de uma rotação 3D que exponha a borda. Uma rotação plana no plano é um movimento diferente. Um plano texturizado pode ser adequado para um objeto plano, como uma impressão ou disco; não o descreva como uma cena 3D totalmente modelada. Um produto sólido cuja silhueta muda durante a rotação precisa de vistas filmadas/geradas adequadas ou um asset 3D.

Mantenha as medições de origem e destino em um sistema de coordenadas consistente. Não misture coordenadas de viewport e documento quando o palco for fixo (sticky). Remeça no redimensionamento e preserve o progresso significativo. Sequencie ações dependentes por sua causa física. Por exemplo, se o destino for um toca-discos, mantenha a agulha levantada até o disco pousar, depois abaixe-a antes do estado de reprodução começar.

Mescle os limites de cena usando iluminação e geometria de cena correspondentes. Mantenha títulos e links de conteúdo legíveis, em vez de colocá-los sobre imagens visualmente carregadas. Em uma viewport estreita, deixe o conteúdo abaixo do objeto quando não houver espaço suficiente ao lado.

Preservar o acesso ao site

Revele a navegação no ponto escolhido da história, não apenas após um longo filme terminar. Mantenha acesso direto às categorias, pular, repetir e um caminho de volta à cena. Se as mudanças de categoria devem trocar o objeto, coordene isso com o conteúdo selecionado e qualquer movimento dependente; seleções rápidas devem se estabilizar na última solicitação.

Não foque um alvo enquanto ele ou um ancestral estiver inerte. Torne-o interativo primeiro, depois foque sem um salto extra de rolagem. Restaure o foco após os diálogos do projeto fecharem.

Um caminho com movimento reduzido deve mostrar cenas estáticas utilizáveis sem varredura ou rotação, inclusive ao rolar para trás. Mantenha o estado de mídia com falha persistente para que a rolagem reversa não possa restaurar uma sobreposição quebrada.

Verificar e entregar

Use as ferramentas do navegador suportado para testar a entrada real, não apenas chamadas para funções de animação internas:

  • A partir de um carregamento limpo, role sem clicar. Pare no meio do caminho, continue, depois inverta até a abertura.
  • Inspecione visualmente a transição vídeo/fotograma e a junção objeto-destino.
  • Alcançe o conteúdo principal com o objeto animado no lugar correto, quando uma transição de objeto fizer parte do design. Execute mudança de categoria, pular, repetir e foco do teclado.
  • Verifique layouts de desktop e celular, redimensione durante o percurso, movimento reduzido e um vídeo deliberadamente indisponível.
  • Verifique transbordamento horizontal, carregamento de mídia e erros no console. Diferencie emulação de navegador de um teste físico em telefone.

Entregue a URL de revisão, uma captura de tela útil, a linha de base preservada e quaisquer limites materiais de desempenho ou teste em dispositivos. Mantenha um manifesto conciso identificando a mídia de origem e a temporização. Implementar uma revisão local não autoriza a publicação por si só.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas