Communitygithub.com

videolu-siteler

Mostra ao agente como planejar, construir ou editar 'videolu siteler' para que o resultado concreto seja um plano, briefing ou checklist. O procedimento passa por Videolu siteler, 1. Tasarım görüşmesi, Tasarım yönü: üretilmiş değil, tasarlanmış görünsün. Use quando uma nova tarefa exigir essa habilidade.

O que é videolu-siteler?

O skill 'videolu-siteler' instrui o agente a projetar e produzir vídeos integrados a sites, indo além de simplesmente inserir um vídeo promocional. Ele guia o agente por um processo de design que começa com uma entrevista de design para definir o tema, a atmosfera, a paleta de cores e o nível de criatividade do vídeo, e depois produz o vídeo usando a ferramenta flow-video MCP. O skill enfatiza que o vídeo deve parecer projetado, não produzido, seguindo um conjunto detalhado de regras de design, como iniciar a partir do próprio contexto do assunto, usar o vídeo como portador da história e evitar padrões prontos. Ele também cobre a preparação técnica do vídeo para a web, incluindo compactação, verificação de qualidade e integração com layout responsivo, acessibilidade e rolagem. O resultado final é um plano ou protótipo de site estático que demonstra a integração do vídeo ao design geral.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Cemilcanoz/videolu-siteler/tree/HEAD/skills/videolu-siteler

Perguntar na sua IA favorita

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

Documentação

Videolu siteler

Objetivo: Que o vídeo faça parte do mundo visual do site; colocar um vídeo de apresentação na página não atende a esta tarefa. Primeiro, a composição da página e o movimento são projetados juntos; depois, o vídeo é produzido para aquela composição.

O usuário fornece apenas as decisões de design. A produção, download, compressão, integração e controle são executados por você; não delegue etapas técnicas rotineiras ao usuário.

1. Entrevista de design

Faça as perguntas em uma única mensagem, numeradas e com opções; escreva ao lado de cada pergunta o padrão sugerido para que o usuário possa responder resumidamente como "tudo padrão" ou "2: impactante, 5: direto". Pule perguntas já respondidas no pedido do usuário; não pergunte novamente sobre uma preferência já expressa (ex.: "não quero teste") em vídeos futuros. Use a ferramenta de pergunta, se disponível (caixa de pergunta com opções).

  1. Tema e objetivo — Para que serve o site, quem vai visitá-lo? (uma frase é suficiente)
  2. Caráter do vídeo (nível de criatividade)
    • Sutil: imperceptível, atmosfera calma (vapor, deslocamento de luz, leve movimento de folhas); o texto está sempre em primeiro plano. Padrão.
    • Equilibrado: movimento perceptível, mas suave; câmera lenta, jogo de textura e luz.
    • Impactante: cinematográfico; luz forte, movimento de câmera nítido, transformação dramática. Mais escurecimento/máscara necessários para legibilidade do texto.
  3. Localização do vídeo (pode selecionar mais de um)
    • Apenas plano de fundo da seção principal (hero). Padrão.
    • Planos de fundo de seções: ex.: cenas separadas para as seções sobre, produto, contato.
    • Transições entre seções: pequenos vídeos de transição de uma cena para outra ao rolar.
    • Pequenos loops em cartões/galeria: movimentos pequenos e silenciosos em cartões de produto ou serviço.
  4. Atmosfera e paleta — ex.: luz quente da manhã, néon escuro, tons terrosos naturais, cores da marca. Se não souber, sugira com base no tema.
  5. Método de produção
    • Teste primeiro: cada cena é produzida primeiro como um teste curto e barato em 360p; após aprovação, qualidade final. Seguro, um pouco mais de crédito no total. Padrão.
    • Qualidade final direta: pula o teste, produz diretamente em 720p. Rápido; se não for aprovado, a reprodução custa o valor total.
  6. Qualidade e orientação — 720p (padrão) ou download com upscale de 720p para 1080p (pode exigir assinatura); horizontal 16:9 (padrão), também é necessário vertical 9:16 para dispositivos móveis?
  7. Itens obrigatórios — logotipo, textos, lista de seções, idioma, destino de publicação (se não houver, site estático).

Após as respostas, mostre um único plano curto; se o usuário aprovar ou disser "continuar", vá para a produção:

  • Ideia de design (um parágrafo).
  • Lista de cenas: para cada cena, local, breve descrição, duração, resolução, créditos estimados.
  • Total estimado de créditos e comparação com a cota gratuita diária (50 créditos/dia). Se exceder a cota total, ofereça opções: reduzir o número de cenas, fazer algumas em 360p/curtas, distribuir a produção ao longo dos dias ou usar créditos de assinatura.

Direção de design: pareça projetado, não produzido

Regras detalhadas e mensuráveis estão no arquivo references/tasarim-kurallari.md: leia as seções 1–6 antes de escrever o plano de tokens, e as seções 7–9 ao escrever o código; antes de entregar, aplique a lista de verificação final com capturas de tela. As "regras básicas" não são negociáveis, a menos que o usuário explicitamente peça o contrário.

Determine a direção da página antes do vídeo; o vídeo serve a essa direção. Apresente ao usuário 2–3 direções com paleta (4–6 hexadecimais nomeados), família tipográfica, estrutura da página e plano de vídeo (número de cenas + créditos); recomende uma e deixe-o escolher. Se o usuário já escolheu uma direção, não pergunte novamente.

  • Comece pelo próprio mundo do tema. Materiais, processo, local, as próprias palavras do assunto. Para uma oficina de cerâmica, algo como "rosa do tufo, cinza da argila molhada, brasa do forno"; adjetivos vagos como "quente e natural" que servem para qualquer assunto não são uma direção.
  • Faça do vídeo o portador da história, não um adereço. As montagens mais fortes:
    • Filme de rolagem: a página é a narrativa de um processo (matéria-prima → produção → resultado); cada seção é uma cena, o vídeo avança com a rolagem. Primeira opção para qualquer assunto com processo (artesanato, culinária, produção, viagem).
    • Parede de amostras vivas: variedades de produtos/materiais são mostradas em pequenos loops (esmalte, tecido, grão de café).
    • Montagem de tempo/lugar: as seções seguem as horas do dia ou os lugares do espaço; a luz do vídeo muda de acordo.
    • Atmosfera única: apenas para um pedido realmente simples.
  • Um único elemento ousado. Gaste sua ousadia em um lugar (filme de rolagem, um título enorme, um momento de cor); o resto deve permanecer calmo e disciplinado. Use a cor de destaque apenas onde fizer sentido (ex.: laranja brasa apenas na cena do forno).
  • Padrões prontos a evitar (a menos que o usuário explicitamente os peça): fundo creme + serifa grossa + destaque tijolo/terracota; fundo preto + único destaque verde ácido/vermelho; sequências idênticas de cartões redondos com a mesma sombra cinza; etiqueta pequena em maiúsculas com espaçamento acima do título ("eyebrow"); linhas de metadados unidas por ponto como "A · B · C"; seta "→" colada no texto do link; tornar uma única palavra em itálico/colorida no título; faixa de estatística inventada ("100% · 1000 °C · 6 rodas"), comentário inventado, parede de logotipos; gradiente roxo-azul, cartão dentro de cartão, emoji no lugar de ícone; animações que deslizam para cada seção. Numeração (01/02/03) apenas se o conteúdo for realmente sequencial.
  • Texto: Uma família de títulos escolhida especificamente para o assunto (não alcançar as mesmas fontes em todo projeto), no máximo duas famílias; comprimento de linha de 45–75 caracteres (ideal ~65); corpo ≥16px, entrelinha 1.5–1.65. Texto em formato de frase, simples, no idioma do usuário final; o botão deve dizer o que faz ("Inscreva-se no curso", não "Enviar").
  • Não coloque informações falsas. Preço, telefone, comentário, número de clientes não fornecidos: invente; use domínio de exemplo (.example) ou "fale conosco", avise no rodapé que é um site de exemplo.
  • Primeiro o plano, depois o teste. Antes de escrever o código, faça um breve plano de tokens (cor, fonte, layout, princípios) e pergunte: "Este plano seria o mesmo para outro site semelhante?" Se sim, mude essa parte. Durante a construção, tire capturas de tela e critique-se; antes de terminar, remova um enfeite.

Determine o número de cenas com base no layout: apenas hero → 1; planos de fundo de seção → 1 por seção (no máximo 4–5); transições → clipes curtos de 3–5 seg; loops de cartão → 3–4 seg, 360p geralmente é suficiente (exibido pequeno).

2. Produção de vídeo (flow-video MCP)

  1. Chame flow_status. Se loggedIn=false, repita a message retornada exatamente para o usuário (é o primeiro login, verificação de senha solicitada ocasionalmente pelo Google, confirmação por telefone?), depois chame flow_login: traz a janela do Flow para frente e aguarda o usuário terminar. Nunca insira a senha, código ou confirmação você mesmo; não tente abrir a aba do Flow com sua própria ferramenta de navegador (a sessão existe apenas no perfil Chrome da ferramenta).
  2. Escreva o prompt em inglês; descreva separadamente: cena/sujeito, câmera, luz, paleta, área a ser deixada vazia para texto (como empty left third for headline), movimento, no text, no logos. De acordo com o caráter selecionado:
    • Sutil: static camera, subtle, slow, continuous, loop-friendly motion, baixo contraste, luz calma.
    • Equilibrado: slow dolly/pan, movimento perceptível mas suave, mudança de luz e textura.
    • Impactante: cinematic, dramatic lighting, movimento de câmera nítido ou transformação (ex.: camera pushes through, light sweeps across); ainda assim, peça área de texto e início/fim adequados para loop.
    • Transição de seção: o quadro inicial deve combinar com a paleta da seção anterior, o quadro final com a da próxima.
    • Cenas do mesmo site: repita a paleta comum, direção da luz e frase de estilo em cada prompt para que a série pareça consistente.
  3. De acordo com o método de produção escolhido pelo usuário:
    • Teste primeiro: resolution: "360p", seconds: 4. Analise o resultado você mesmo (verifique abaixo); corrija no prompt o que não gostou. Se estiver bom, produza com o mesmo prompt em 720p e a duração necessária (geralmente 8 seg). Não precisa mostrar o teste ao usuário; pergunte apenas se for necessária uma mudança de direção evidente.
    • Qualidade final direta: produza diretamente em 720p e com a duração planejada. Se o resultado tiver defeitos claros na verificação (área de texto preenchida, texto/logotipo indesejado, assunto errado), reproduza uma vez com o prompt corrigido e informe o usuário; se o crédito da segunda produção exceder o plano, pergunte primeiro.
    • Se houver várias cenas, produza e verifique primeiro a cena hero; se o estilo funcionar, produza as outras com a mesma frase de estilo.
    • Para filme de rolagem, comece os prompts com "Scene N of a short film about …" e repita exatamente o local, direção da luz, paleta e frase da câmera em cada cena; as cenas parecerão ocorrer no mesmo lugar. Cenas de 3–5 seg são suficientes.
  4. Se ocorrer TIMEOUT ou erro de download, não reproduza o mesmo prompt: na maioria das vezes, o vídeo já foi produzido no Flow; reproduzir gastaria o crédito duas vezes. Chame flow_download com a URL do projeto da mensagem de erro (não gasta crédito); se retornar NOT_READY, aguarde um pouco e tente novamente. Apenas se não houver vídeo no projeto, reproduza.
  5. Após a entrega, meça cada arquivo com ffprobe e monte a edição com base na duração real. A ferramenta define e verifica a duração no Flow; se uma duração inválida for solicitada, retorna OPTION_UNAVAILABLE (a faixa geralmente é de 3 a 15 seg).
  6. Sempre forneça outDir (pasta media/src do site; o arquivo bruto permanece lá como mestre); se não fornecido, os arquivos caem na pasta onde o agente está trabalhando no momento.
  7. Consciência de crédito: a conta gratuita recebe 50 créditos por dia; 720p ≈ 3 créditos/seg, 360p ≈ 1 crédito/seg. Se você exceder o limite maxCredits, informe o custo ao usuário e obtenha aprovação. Se o crédito diário acabar, diga isso claramente; não mude silenciosamente para outro serviço pago.
  8. Códigos de erro: LOGIN_REQUIRED → solicite login do usuário; OVER_BUDGET → aprovação; GENERATION_FAILED → suavize o prompt (geralmente conteúdo de pessoa/marca real ou violência) e tente novamente uma vez; TIMEOUT → item 4 acima.

3. Verifique e prepare o vídeo para a web

  • Meça a duração/tamanho real com ffprobe; não confunda a duração desejada com a duração produzida.
  • Extraia alguns quadros e examine (ffmpeg -ss 1 -i in.mp4 -frames:v 1 f1.jpg): a área de texto está vazia? Há texto/logotipo indesejado? A paleta está adequada?
  • Cópia de entrega: MP4 silencioso, compactado para web (H.264, -an -crf 26 -preset slow -movflags +faststart), WebM se necessário; pôster como o quadro de início da reprodução (se o primeiro quadro começar escuro, pegue alguns quadros depois); vídeo hero para ~10 seg deve ter ≤2 MB.
  • Loop: se o início e o fim não se assemelham, apenas adicionar loop não é perfeito; faça um crossfade curto ou um loop de avanço/recuo (ping-pong: [0]reverse com concat) ou informe o usuário sobre isso.
  • Faixa preta embutida: algumas produções têm bordas pretas. Meça com ffmpeg -i in.mp4 -vf cropdetect=24:2:0 -f null - e limpe com crop=…,scale=1280:720.
  • Vídeo para ser enrolado com rolagem requer quadros-chave frequentes, senão trava ao retroceder: -c:v libx264 -crf 26 -g 6 -keyint_min 6 -sc_threshold 0 -an -movflags +faststart. Uma cena de 5 seg em 720p com essa configuração fica em cerca de 0,5–1,2 MB.
  • Se o ffmpeg não estiver disponível, sugira ao usuário o comando de instalação (Windows: winget install Gyan.FFmpeg, macOS: brew install ffmpeg).

4. Integre ao site

  • Textos, botões e interação permanecem na camada web; o quadro do vídeo deixa espaço para eles. Considere o quadro móvel separadamente (object-position, se necessário, vídeo 9:16 separado).
  • <video autoplay muted loop playsinline preload="metadata" poster="..." width height>. Em caso de erro de mídia, o pôster deve permanecer visível. Pré-carregue o pôster hero com <link rel="preload" as="image" fetchpriority="high">; o hero geralmente é o maior elemento da página (LCP).
  • Para qualquer vídeo em reprodução automática com mais de 5 segundos ou em loop, coloque um botão de pausar/reproduzir visível para todos e acessível por teclado (WCAG 2.2.2); isso não é apenas para usuários com redução de movimento.
  • Interrompa quando estiver fora da tela e em aba oculta (IntersectionObserver + visibilitychange).
  • Se prefers-reduced-motion estiver ativo, mostre o pôster estático e ofereça um controle visível "Ativar movimento"; esse controle deve gerenciar tanto o vídeo quanto as animações CSS.
  • Não coloque o vídeo em uma moldura de player visível; posicione-o na superfície com máscara, corte e harmonia de cores. Movimentos CSS/SVG de suporte devem servir ao propósito.
  • Orçamento de movimento: que haja um único momento de foco na página; apenas um vídeo toca por vez, não há animação de entrada ou parallax adicional na seção do vídeo. Se o usuário escolheu vários locais de vídeo, eles devem ser visíveis sequencialmente, não simultaneamente.
  • Se houver vários vídeos: apenas o vídeo da seção visível deve tocar por vez; os outros não devem ser carregados com preload="none", e carregados quando se tornarem visíveis. Os vídeos de transição de seção podem ser vinculados à rolagem (reproduzir uma vez quando visível ou vincular currentTime à porcentagem de rolagem); se for pesado no celular, reduza para pôster + transição CSS curta. Os loops de cartão devem ser pequenos e em 360p, tocando apenas quando visíveis.
  • Configuração do filme de rolagem: dentro de <section class="film">, uma cena com position: sticky; top: 0; height: 100svh; margin-bottom: -100svh (todos os vídeos empilhados, apenas o ativo visível) e, em seguida, uma seção de ~150–160vh de altura para cada cena. Dê ao filme overflow: clip; caso contrário, a margem negativa fará com que a cena permaneça sobre a próxima seção após o término do filme. Calcule qual seção está no centro da tela durante a rolagem e o progresso dentro da seção, faça video.currentTime = progresso × duração; não execute play() nos vídeos. Faça a atualização com requestAnimationFrame e, como ele para em segundo plano, adicione um breve backup setTimeout. Com movimento desativado (prefers-reduced-motion ou botão), as cenas devem permanecer estáticas no primeiro quadro/pôster, mas a mudança de seção ainda deve funcionar. Os textos não são incorporados ao vídeo; o texto de cada seção fica na camada web como um título fixo + uma frase, apenas o canto onde o texto está é escurecido.
  • Entrega padrão: site estático sem dependências (index.html + css + js + media). Se o usuário informou um framework ou destino de publicação, use-o.

5. Verificação final

  • Legibilidade do texto, enquadramento, transbordamento e carregamento de mídia nas larguras desktop e móvel.
  • Verifique se o vídeo realmente está sendo reproduzido (currentTime está avançando?); captura de tela não é prova de reprodução.
  • Teste o caminho de redução de movimento e o controle "Ativar movimento".
  • Para o usuário: caminho/link do site, créditos usados, arquivos de vídeo e limitações conhecidas (ex.: composição de loop). Não substitua o sucesso técnico pela aprovação estética; pergunte o que ele não gostou.

Limitações

  • flow-video automatiza a interface do Flow no perfil do navegador do usuário; se a interface do Google mudar, a ferramenta pode apresentar erro. Nesse caso, relate o erro claramente.
  • O Google do usuário

…

[truncado para tradução]

Habilidades Relacionadas