Communitygithub.com

SingleGrain-Team/video-skills

Constrói uma abertura de logo de 6 a 8 segundos onde a marca gráfica viaja dentro de uma gota líquida refratada (distorcida além da legibilidade), a gota incha, para por um instante, então se rompe em gotículas e deixa o conjunto de logo (marca mais logotipo) nítido e vertical na tela. Entregue como MP4 H.264 1920x1080 mais o projeto HyperFrames editável, sem modelo 3D, filmagem de estoque ou modelo generativo. Use para introduções e encerramentos de marca, aberturas de lançamentos de produtos, vinhetas de canal e qualquer momento de 'revelar nosso logo', a partir de um SVG ou PNG do logo (incluindo logos apenas raster), uma string de logotipo e uma paleta.

O que é video-skills?

Este skill cria uma animação de revelação de logo com uma gota de vidro líquido realista, utilizando Three.js para renderização WebGL. Ele recebe como entrada o símbolo do logo (SVG ou PNG), um logotipo de texto e uma paleta de três cores. A animação segue fases determinísticas (estabelecimento, acúmulo de pressão, congelamento, ruptura com gotículas, e encaixe final) sem usar números aleatórios ou temporização baseada em frames de animação, garantindo renders idênticos em cada execução. Suporta plataformas que executam o HyperFrames (um executor headless de animações WebGL) e é ideal para abrir vídeos de marca, canais ou produtos. O skill também lida com logos apenas raster (PNG com fundo opaco) instruindo a remoção automática de fundo, redimensionamento e posicionamento correto na cena. A saída final é um MP4 H.264 em 1920x1080 a 30 FPS, além do projeto editável. O fluxo de trabalho inclui scaffolding do projeto, vendedorização das bibliotecas Three.js e GSAP, configuração dos atributos de dados no HTML, linting, verificação e renderização final. O skill enfatiza a legibilidade controlada do logo dentro da gota: antes da ruptura, o logo deve estar distorcido e ilegível; após a ruptura, o logo e o logotipo aparecem nítidos e centralizados. Parâmetros como espessura da gota, amplitude de deslocamento, dispersão e duração são ajustáveis via constantes no código JavaScript. A entrega inclui tanto o vídeo renderizado quanto o projeto completo para rebranding futuro.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SingleGrain-Team/video-skills/tree/HEAD/skills/liquid-logo-reveal

Perguntar na sua IA favorita

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

Documentação

Revelação líquida do logo

Uma conta de vidro WebGL (Three.js) com transmissão física, superfície deslocada por ruído e dispersão fica na frente do logo. O logo é refratado tão intensamente que não pode ser lido. A pressão aumenta, tudo congela por um instante, a conta estoura, 15 gotículas voam para fora, e a marca desliza para a esquerda enquanto o logotipo se revela por trás dela. Os quadros são funções puras do tempo de busca, portanto os renders são determinísticos.

Entradas

EntradaNotas
Marca do logoSVG ou PNG. Marca apenas (símbolo), formato quadrado, fundo transparente.
LogotipoUma string de texto tipografada em Inter por padrão. Se a marca tiver um logotipo gráfico real, veja "Logotipo como arte".
PaletaTrês cores: um acento forte, um tom suave, um neutro opaco. Elas se tornam campos de cor desfocados atrás do vidro; o vidro é incolor e mostra apenas o que está atrás dele. Cor da tinta para o logotipo.
DuraçãoPadrão 7s. A pausa após o encaixe do conjunto é a única parte que você deve esticar.

Use apenas ativos fornecidos pelo usuário ou que estejam no kit da marca. Nunca busque logos da web.

Logos apenas raster

  • O modelo espera um PNG com alfa. Se o logo tiver um fundo opaco (JPG, caixa branca), remova-o primeiro (npx hyperframes remove-background, ou peça ao usuário um arquivo transparente). Não entregue um quadrado branco sendo refratado dentro da conta.
  • Um PNG pequeno (abaixo de ~600px) é aceitável porque a marca é exibida com cerca de 250px em repouso, mas é ampliada para ~360px dentro da conta. Mantenha a fonte com pelo menos 512px no lado maior.
  • Corte o preenchimento transparente para que a marca visível preencha a imagem; o código dimensiona a caixa da imagem, não a tinta.
  • SVG: rasterize para um PNG com cerca de 1720px no lado maior (captura de tela do Chrome headless, ou rsvg-convert -w 1720), mantenha alfa e aponte data-logo-src para ele. Não redesenhe ou recolorir o logo.
  • Se o logo da marca for uma imagem de conjunto combinada (marca e texto fundidos), você não pode separá-los limpidamente. Use o conjunto inteiro como a marca, defina data-wordmark="" e pule a revelação do logotipo (defina o clipe do logotipo como sempre oculto). A marca então se ancora ao centro, não à esquerda.

Fluxo de construção

  1. Scaffolding: npx --yes hyperframes init <dir> -e blank --non-interactive --skip-skills, depois substitua seu index.html pelo template/index.html deste skill e copie template/js/, template/assets/logo.png (sobrescreva com a marca da marca).
  2. Vendedorize o runtime para que a renderização nunca toque a rede. Em um diretório temporário (NÃO dentro de outro projeto, npm i sobe até o package.json mais próximo) execute npm i [email protected] [email protected] @fontsource-variable/inter, depois copie para o projeto:
    • gsap/dist/gsap.min.js para vendor/gsap.min.js
    • three/build/three.module.js e three/build/three.core.js para vendor/three/build/
    • three/examples/jsm/environments/RoomEnvironment.js para vendor/three/examples/jsm/environments/
    • @fontsource-variable/inter/files/inter-latin-wght-normal.woff2 para assets/fonts/
  3. Personalize com os atributos de dados em #root no index.html: data-logo-src, data-wordmark, data-ink, data-fields (três cores hexadecimais). Mantenha os campos saturados no acento e suaves nas outras cores; nunca deixe o campo atrás do centro da conta escuro e plano.
  4. Linting e verificação: npx --yes hyperframes lint depois npx --yes hyperframes check. Ambos devem estar limpos.
  5. Revisão de quadros (abaixo). Ajuste. Repita.
  6. Renderização: npx --yes hyperframes render --workers 2 --output final.mp4. Analise: ffprobe deve relatar h264, 1920x1080, 30fps, a duração esperada.

Regras de movimento (o que faz o formato funcionar)

  • Ilegível, não invisível. Antes do estouro, o espectador deve ver cor e formas distorcidas da marca, nunca lê-la. Se um quadro mostrar o logo reconhecível, aumente thickness / amplitude de deslocamento / rotação; se a conta for uma mancha plana sem vestígio da marca, reduza-os.
  • Marca atrás do vidro, na passagem opaca. O plano pré-estouro usa alphaTest (fila opaca) para que a passagem de transmissão do Three.js possa refratá-lo. Um plano simples transparent: true não seria refratado. A cópia "revelada" é transparente e trocada apenas após o colapso da casca.
  • Fases, em ordem (todas constantes em T no topo de js/liquid-reveal.js): estabelecimento (corte próximo à conta cheia, 0,7s) depois performance líquida, acúmulo de pressão (conta fica mais larga e achatada, marca incha de 1,00 para 1,06), vírgula (0,4s de imobilidade total: câmera, marca, conta e relógio do shader congelados), ruptura (casca colapsa em 0,2s com facilidade power-4, gotículas lançam radialmente), encaixe (marca recua e desliza para sua posição final enquanto o logotipo se revela por trás), pausa.
  • A imobilidade é o ponto. O congelamento de 0,4s antes do estouro é o que vende a ruptura. Nenhuma respiração ociosa, flutuação ou brilho em loop em nenhum lugar.
  • Relógio do shader é controlado. O tempo de ruído avança apenas em janelas autorizadas e congela na vírgula e após o encaixe.
  • Logotipo emerge da marca, nunca aparece de repente. Sua borda esquerda do clipe segue a borda direita da marca, então o texto nunca é sobreposto pela marca durante o encaixe.
  • Gotículas: layout fixo de ângulo dourado (sem Math.random), lançamento radial, um termo de gravidade, depois encolhem até nada para que o quadro final esteja limpo.
  • Termine com um conjunto parado. Marca e logotipo verticais, centralizados como um par, sem desaparecimento. Se a peça for uma introdução que será cortada em um vídeo mais longo, encurte a pausa em vez de desvanecer.
  • Determinismo: tudo é calculado a partir do tempo hf-seek. Sem requestAnimationFrame, Date.now, Math.random. A única medição de DOM é a largura do logotipo, feita uma vez no carregamento (measureText com a fonte fornecida).

Parâmetros de ajuste

DesejoMudança
Mais longo ou mais curtoConstantes T e data-duration em #root e em ambos os elementos .clip (mantenha-os iguais)
Conta mais abstrataaumentar thickness (3.2) ou a amplitude de deslocamento (0.15); diminuir para legibilidade
Aparência gelatinosa vs. gotículadispersion, attenuationColor em liquidMaterial()
Conjunto maior ou menorL.markPx, L.fontPx, L.gap
Fundo mais calmoreduzir os três pesos de campo * 0.50 / 0.80 / 0.35 no shader de fundo

Logotipo como arte

Se a marca fornecer um SVG/PNG do logotipo, substitua o texto #wordmark por uma <img> com a mesma lógica de posição e largura: meça sua proporção, defina sua altura para L.fontPx * 0.8 e mantenha a mesma lógica de clip-path. Nunca redigite um logotipo estilizado em uma fonte substituta.

Validação

  • lint e check limpos (um erro de lint desabilita silenciosamente as auditorias de layout).
  • Extraia quadros e observe-os: npx --yes hyperframes snapshot --at 0.3,1.5,3.3,3.55,3.9,6.5 e abra snapshots/contact-sheet.jpg, ou ffmpeg -ss <t> -i final.mp4 -frames:v 1 f.png no render. Verifique: (1) quadros iniciais mostram uma conta onde a marca não pode ser lida, (2) o quadro logo após o estouro não tem texto do logotipo sobrepondo a marca, (3) texto durante o encaixe é cortado pela borda da marca, (4) quadro final tem marca mais logotipo nítidos, centralizados, sem gotículas, sem glifos cortados.
  • Falhas comuns: tela em branco (caminho do importmap errado, ou three.core.js não copiado), logotipo descentralizado (fonte não carregada antes da medição), logo com caixa branca (PNG opaco).

Entrega

Entregue final.mp4 e a pasta do projeto (index.html, js/, assets/, vendor/) para que possa ser personalizado novamente editando os atributos data-*. O áudio é opcional; um efeito sonoro curto de estouro no momento da ruptura T.pop é o único som que a peça precisa. Obtenha qualquer som através do skill media-use com um resultado licenciado comercialmente, caso contrário, entregue sem áudio.

Individual skills in this repo

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

SingleGrain-Team/video-skills

Make a 30-45 second launch film for a product by staging it inside one persistent, neutral chat window. A user types a request, the assistant answers and calls the product as a connected tool, a progress card runs, a follow-up triggers a second tool action, and the result lands as a count-up headline number before closing on the logo, tagline and call to action. Use when you need a launch, feature or integration announcement video for something that plugs into AI assistants (a skill, MCP server, plugin, connector, CLI). Delivers a rendered 1920x1080 MP4 plus an editable single-file HyperFrames project.

SingleGrain-Team/video-skills

Build a motion graphic where a screen recording plays in a large frame beside a checklist, and each checklist item ticks off at the exact moment that step happens in the recording, ending with every item checked and a short hold. Use when someone has a screen recording (product walkthrough, tutorial, onboarding, install demo) plus a list of steps with timestamps and wants a "watch the steps get done" film. Input is a recording, step labels with timestamps, a title and an optional palette; output is a 1920x1080 H.264 MP4 and the editable HyperFrames project.

SingleGrain-Team/video-skills

Build a 15-20 second product launch film that shows the product's real screen on a laptop built from plain CSS (no 3D model, no generation model) in a dark studio, scrolls the page, zooms into the interface for one key action such as typing a search, and resolves to the logo lockup. Use when someone has a full-page screenshot or screen recording of their product, one action worth showing, and a logo, and wants a short silent-friendly launch teaser rendered as a 1920x1080 MP4 with an editable HyperFrames project.

SingleGrain-Team/video-skills

Make a 20-30 second launch film for a product that is not tied to one interface, such as a CLI, package, plugin or agent skill. The identical prompt or command is typed into four visually different surfaces in turn (a wide terminal, a tall chat card, a floating palette, an editor cell), the film then hard-cuts into a fast reel of real outputs on a beat or fixed tempo grid, and it closes on the command in a large pill. Delivered as a rendered 1920x1080 MP4 plus the editable HyperFrames project. Music is optional - with a track the cuts land on detected beats, without one they land on a 120 bpm grid.

SingleGrain-Team/video-skills

Make a roughly 30-second film that explains a code change (a pull request, release or uncommitted diff) to people who will never read the diff. It opens by showing the real diff scrolling past too fast to follow, cuts to a plain-language summary, fires four capability beats each pinned to a real code snippet, and closes on how to get it (install command and URL). Delivered as a 1920x1080 H.264 MP4 plus the editable HyperFrames project. Use when asked to turn a PR, changelog or release into a launch or explainer video.

SingleGrain-Team/video-skills

Render a 5-6 second motion graphic in which an oversized condensed headline (2-4 words) punches in behind a presenter, using a background-removed cutout of the presenter layered on top of the lettering. A hard cut then removes the presenter while the same headline holds the exact same size and position, and a short supporting line appears for a reading hold. Use it for talking-head intros, chapter openers, launch announcements and social hooks when you have one presenter clip, a headline, a supporting line and a palette. Built on HyperFrames; delivers a 1920x1080 H.264 MP4 plus the editable project.

SingleGrain-Team/video-skills

Builds a 10-14 second product sting out of a short run of UI moments (an entry screen, a single counting metric, a navigation list, one click that opens a menu, then an endcard) cut together so every cut carries the previous motion forward and the piece reads as one continuous camera move. Delivered as a 1920x1080 H.264 MP4 plus an editable single-file HyperFrames project. Use it for app launches, feature teasers, social bumpers and site intros when you have a product's logo, a couple of screenshots, one headline number and its real nav labels, and want polished UI motion without narration.

Habilidades Relacionadas