Communitygithub.com

SingleGrain-Team/video-skills

Cria um vídeo de lançamento de 20 a 30 segundos para um produto que não está vinculado a uma única interface, como uma CLI, pacote, plugin ou skill de agente. O mesmo prompt ou comando é digitado em quatro superfícies visualmente diferentes (um terminal largo, um cartão de chat alto, uma paleta flutuante, uma célula de editor). O vídeo então corta bruscamente para uma sequência rápida de resultados reais em uma grade de batida ou tempo fixo, e termina com o comando em um grande comprimido (pill). Entregue como um MP4 1920x1080 renderizado mais o projeto HyperFrames editável. Música é opcional — com uma faixa, os cortes caem nas batidas detectadas; sem ela, caem em uma grade de 120 bpm.

O que é video-skills?

Esta skill cria um vídeo de lançamento rápido (20-30 segundos) que demonstra a portabilidade de um comando ou prompt em diferentes interfaces. O processo é orquestrado pelo framework HyperFrames, que gerencia a estrutura baseada em grades de batida (música ou tempo fixo). O usuário fornece o prompt, imagens de resultados reais, informações da marca e, opcionalmente, uma faixa de música licenciada. A skill automatiza a sincronização das digitações, cortes e animações, garantindo que cada transição ocorra precisamente no tempo. O projeto final é entregue como um arquivo MP4 e o projeto editável, permitindo ajustes finos. Ela depende da CLI `npx hyperframes` para verificações de lint, layout e contraste, além de renderização acelerada por GPU. As regras de design enfatizam a abstração visual: as quatro superfícies devem ter silhuetas distintas e usar HTML/CSS genérico, sem imitar interfaces de produtos existentes. A skill é ideal para engenheiros e desenvolvedores que desejam criar demonstrações visuais de ferramentas de linha de comando, plugins ou agentes de IA.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SingleGrain-Team/video-skills/tree/HEAD/skills/one-prompt-reel

Perguntar na sua IA favorita

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

Documentação

one-prompt-reel

A declaração que este filme faz: "funciona da mesma forma onde quer que você digite." A prova é a repetição. Uma string, quatro superfícies aparentemente diferentes, depois uma explosão do que foi produzido e, novamente, a string.

Entradas

EntradaObrigatórioNotas
promptsimO comando ou frase exata. Com menos de cerca de 50 caracteres funciona melhor; é digitado quatro vezes mais uma vez no fechamento.
imagens reelsim16 a 24 resultados reais: capturas de tela, telas de produto, imagens estáticas extraídas de renderizações anteriores. Apenas material próprio.
nome da marca, slogan, urlsimUsado no cartão de fechamento.
logotiponãoPNG quadrado com alpha. Omita para um fechamento apenas com texto.
músicanãoUma faixa que você tem licença para usar comercialmente. Se não tiver certeza da licença, envie sem áudio.

Fluxo de trabalho

  1. Estrutura. Crie uma pasta de projeto, copie template/ para dentro dela (index.html mais assets/gsap.min.js) e coloque as imagens do reel em assets/reel/. Depois: npx --yes hyperframes check
  2. Preencha o bloco CONFIG no topo da <script> em index.html. Tudo específico do projeto está lá: prompt, bpm, lista de arquivos reel, brand, tagline, url, logo. Não reestruturar o resto, a menos que uma regra abaixo force.
  3. Escolha a grade de corte.
    • Sem música: mantenha cuts: null. Os cortes vêm de bpm e reelPattern (padrão: 8 cortes de uma batida, depois 16 cortes de meia batida, a 120 bpm = 4 s + 4 s). As superfícies duram surfaceBeats batidas cada, então todo o filme permanece na grade.
    • Com música: adicione a faixa como <audio id="music" data-timeline-role="music" src="assets/music.mp3" data-start="0" data-duration="24" data-track-index="5">, execute npx hyperframes beats, abra beats/assets/music.mp3.json e copie os tempos das batidas (em segundos) que caem após ou no início do reel para CONFIG.cuts (uma entrada extra marca o fim do último corte, que é quando o fechamento começa). Defina bpm para o andamento da faixa para que a seção de digitação também se alinhe. Se as batidas forem mais densas que 0,2 s, pegue cada segunda batida. Desvaneça a música no último segundo (/hyperframes-audio).
  4. Pré-visualize antes de renderizar. npx --yes hyperframes snapshot --at 1.8,4.3,6.8,9.2,11,15,20,23 e abra os PNGs. Verifique cada superfície no meio da digitação, um corte do reel e o fechamento.
  5. Renderize. npx --yes hyperframes render --workers 2 -o final.mp4.
  6. Extraia 4-6 quadros do MP4 com ffmpeg (um por superfície, um corte do reel, o fechamento) e analise-os. Corrija e renderize novamente se algo estiver cortado, ilegível ou vazio.

Formato do filme (24 s nos padrões)

TempoBatida
0-10 sQuatro superfícies, 2,5 s cada. Deslizam da direita, digitam por aproximadamente 1,5 s, pressionam ENTER, deslizam para a esquerda. Um pequeno rótulo nomeia a superfície e sua posição (1/4).
10-18 sCorte brusco com um flash branco. 24 imagens de saída de página inteira, cada uma com um zoom lento. O comando fica em um comprimido (pill) no canto inferior esquerdo durante todo o reel; um contador fica no canto inferior direito.
18-24 sFechamento escuro: logotipo, nome, slogan, o comando digitado mais uma vez dentro de um comprimido com borda de brasa, url, um único pulso de brilho.

Regras que fazem funcionar

  • As quatro superfícies devem diferir na silhueta, não apenas na cor. Larga e baixa, alta e estreita, flutuando sobre um gradiente, escura com uma árvore lateral. Se você consegue apertar os olhos e confundir duas, redesenhe uma. Construa-as com HTML e CSS simples; nunca imite o chrome, logotipo ou paleta de nenhum produto real.
  • Mesma string, mesma velocidade de digitação. Cada superfície digita o prompt idêntico na mesma duração. Essa mesmice é o ponto.
  • Digite com um tween de timeline, não com um temporizador. Um tween sobre um contador {n} cujo onUpdate fatia a string é seguro para busca; setInterval não é.
  • Faça o cursor piscar com tl.set em um loop de meia batida, nunca com animação CSS ou repeat: -1.
  • Corte na grade. Cada limite de superfície, corte e entrada de fechamento cai em uma batida, seja a grade musical ou um andamento simples. Edições fora da grade são a primeira coisa que parece desleixada.
  • Acelere uma vez. Cortes lentos primeiro, depois cortes de metade da duração. Não acelere repetidamente.
  • Imagens do reel são evidência. Resultado real, não decoração. Prefira imagens estáticas 1920x1080; dimensione tamanhos ímpares com object-fit: cover. Alterne vizinhos escuros e claros para que cada corte seja percebido.
  • Sem mídia de terceiros. Sem logotipos, capturas de tela de outros produtos, imagens de stock ou fontes que você não pode distribuir. Fontes: nomeie uma família explicitamente (para monoespaçada use "JetBrains Mono", que a CLI resolve sozinha); a pilha genérica ui-monospace foi renderizada proporcionalmente nos testes.
  • Mantenha as legendas legíveis. Verifique o contraste; hyperframes check aplica WCAG AA em texto, então os rótulos precisam de uma tinta média-escura sobre o fundo creme.
  • Silêncio é aceitável. Não adicione música de licença desconhecida; faixas geradas por IA com termos não comerciais estão descartadas.
  • Mantenha o flash tween immediateRender: false, caso contrário a auditoria de layout vê uma sobreposição branca em t=0.

Validação

  • npx --yes hyperframes check deve terminar com "Check passed" (lint, layout, contraste).
  • Os quadros de snapshot mostram todas as quatro superfícies totalmente digitadas antes de sua saída, nenhum rótulo sobrepondo uma superfície, nenhuma imagem de reel vazia ou parcialmente carregada.
  • ffprobe relata 1920x1080, h264, duração dentro da janela de 20 a 30 s.

Entrega

Coloque final.mp4 ao lado do projeto (index.html, assets/). Se a convenção do repositório pedir uma nota curta, liste: prompt, andamento ou fonte da batida, fontes das imagens do reel, licença da música (ou "silencioso") e o comando de renderização. Mencione que o Studio (npx hyperframes preview) pode reajustar qualquer coisa.

Veja references/surfaces.md para as especificações das quatro superfícies e references/grid.md para a aritmética de temporização.

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

Builds a 6-8 second logo sting in which the brand mark rides inside a refracting liquid bead (distorted past legibility), the bead swells, holds still for a beat, then ruptures into droplets and leaves the logo lockup (mark plus wordmark) crisp and upright on screen. Delivered as a 1920x1080 H.264 MP4 plus the editable HyperFrames project, with no 3D model, stock footage or generation model. Use it for brand intros and outros, product-launch openers, channel stings and any "reveal our logo" moment, from an SVG or PNG logo (including raster-only logos), a wordmark string and a palette.

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