Communitygithub.com

SingleGrain-Team/video-skills

Cria um filme de aproximadamente 30 segundos que explica uma mudança de código (um pull request, release ou diff não commitado) para pessoas que nunca lerão o diff. Ele começa mostrando o diff real passando rápido demais para acompanhar, corta para um resumo em linguagem simples, exibe quatro capacidades cada uma ancorada a um trecho de código real e termina com como obter (comando de instalação e URL). Entregue como um MP4 H.264 1920x1080 mais o projeto HyperFrames editável. Use quando solicitado a transformar um PR, changelog ou release em um vídeo de lançamento ou explicação.

O que é video-skills?

Este skill cria um vídeo explicativo silencioso por padrão, com cerca de 30 segundos, dividido em cinco movimentos, projetado para comunicar mudanças de código para não desenvolvedores. Ele funciona em qualquer repositório Git, aceitando como entrada um PR do GitHub, uma release ou um diff local. A execução envolve ler a mudança real, extrair estatísticas e trechos de código, e gerar um filme estruturado: um gancho inicial com o número de arquivos alterados, um borrão do diff real para transmitir a sensação de sobrecarga de informação, um resumo em linguagem simples, quatro 'batidas de capacidade' cada uma mostrando um benefício ao lado do código real, e um fechamento com o comando de instalação e URL exatos. Toda a composição é determinística, sem aleatoriedade, garantindo reprodução exata. As regras são rigorosas para manter a autenticidade: o diff deve ser real, as contagens precisas, e nenhum código inventado. O resultado é entregue como um arquivo MP4 H.264 1920x1080 e o projeto HyperFrames completo, permitindo re-renderização e personalização editando apenas o arquivo `film.config.js`.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SingleGrain-Team/video-skills/tree/HEAD/skills/pr-explainer-film

Perguntar na sua IA favorita

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

Documentação

pr-explainer-film

Um filme silencioso por padrão, de ~30s em cinco movimentos. A forma é o ponto: o espectador sente que o diff é ilegível, depois obtém a resposta em palavras simples, então vê a prova e, por fim, sabe o que digitar.

TempoMovimentoPropósito
0-2sGanchoNomear o tamanho da mudança ("15 arquivos alterados.")
2-8sBorrão do diffPedaços reais passam rapidamente; contadores sobem
8-13sPalavras simplesManchete de uma frase mais três pontos curtos
13-23sQuatro batidasUma capacidade cada, mostrada ao lado das linhas reais por trás
23-30sFechamentoComando de instalação digitado, depois a URL

Entradas

Colete estas antes de construir. Pergunte apenas pelo que estiver faltando.

  1. Fonte da mudança: um PR ou release do GitHub (gh pr diff, gh pr view --json title,body,files), ou uma árvore de trabalho local (git diff mais arquivos não rastreados). Somente leitura; nunca modifique o repositório.
  2. Público-alvo: quem não lerá o diff (clientes, colegas de equipe, seguidores). Isso decide o vocabulário no resumo e nas batidas.
  3. CTA: o comando de instalação e/ou URL exatos. Use-o textualmente. Se o produto tiver um comando canônico, mostre apenas esse comando e nenhum nome de outra ferramenta.
  4. Marca: paleta, logotipo (seu próprio arquivo), fonte. Os padrões no template são neutros e escuros.

Fluxo de trabalho

  1. Leia a mudança. Obtenha a lista de arquivos com contagens de adições/remoções e os pedaços reais. Escreva a mudança em uma frase que um não engenheiro entenderia; se não conseguir, você ainda não entendeu a mudança.
  2. Escolha o conteúdo (veja references/content-rules.md): número do gancho, 5-8 pedaços de diff para o borrão, 3 pontos de resumo, exatamente 4 batidas de capacidade, CTA.
  3. Estrutura inicial. npx --yes hyperframes init <dir> --non-interactive --example=blank, depois copie template/index.html e template/film.config.js sobre os arquivos gerados. Coloque seu logotipo em assets/logo.png se tiver um.
  4. Preencha film.config.js. Todas as palavras, trechos e números ficam lá. Edite index.html apenas para alterar variáveis de marca em :root, tempos ou layout.
  5. Valide: npx --yes hyperframes lint depois npx --yes hyperframes check. Corrija todos os erros. Avisos aceitáveis conhecidos: nested_structure_needs_subcomposition (o filme é intencionalmente um arquivo para facilitar a re-marca).
  6. Veja-o. npx --yes hyperframes snapshot --at 1,4,6,8.3,11,14,17,19.5,22,26,29 e abra snapshots/contact-sheet-*.jpg. Verifique a lista abaixo; corrija e faça novos snapshots até estar limpo.
  7. Renderize. npx --yes hyperframes render --quality high --workers 2 --output final.mp4. Confirme com ffprobe que é 1920x1080, H.264 e 28-34s.
  8. Revise 4-6 quadros extraídos do MP4 (ffmpeg -ss T -i final.mp4 -frames:v 1 f.png), não apenas os snapshots.

Regras que fazem o formato funcionar

  • O diff deve ser real. Copie linhas reais do diff real. Nunca invente código ou contagens. Calcule contagens a partir de git diff --shortstat mais wc -l de novos arquivos.
  • Ilegível de propósito. A rolagem acelera (power2.in) e borra. Não a desacelere para que as pessoas possam ler; o cartão "muita coisa para ler" compensa isso.
  • Palavras antes da prova. O resumo vem antes de qualquer batida de capacidade. Cada título de batida é um benefício em 2-4 palavras; a descrição é uma frase sem jargão; o trecho tem 1-5 linhas reais com a linha-chave destacada.
  • Exatamente quatro batidas, uma ideia cada, cerca de 2,6s cada. Corte as mais fracas em vez de encolher o texto.
  • Superfícies alternadas. Escuro para o diff e batidas, uma cena clara para o resumo. A mudança de fundo sinaliza "agora é simples".
  • Feche com o comando. Digite o comando real caractere por caractere, depois mostre a URL. Sem segundo CTA.
  • Higiene de cópia. Remova comentários de código que mencionem concorrentes ou ferramentas não relacionadas antes de chegarem a um trecho. Nunca mostre uma CLI diferente daquela no CTA.
  • Possua seus ativos. Use seu próprio logotipo, fontes que a máquina já possui e nenhuma mídia de terceiros ou estoque. Música é opcional; se usada, apenas faixas licenciadas para uso comercial (resolva via media-use) e mantenha o filme totalmente legível sem som.
  • Determinismo. Sem Math.random, Date.now ou chamadas de rede na composição; anime texto digitado e contadores a partir de um valor de progresso de interpolação para que a busca seja exata.

Lista de verificação de quadros (etapas 6 e 8)

  • Número e texto do gancho correspondem à mudança real.
  • Janela do diff recorta dentro de seu quadro; cabeçalhos de arquivo e linhas verdes/vermelhas são legíveis em repouso, borradas quando em movimento.
  • Contadores terminam nos números verdadeiros.
  • Slide de resumo mostra todos os três pontos antes de desaparecer.
  • Cada batida tem título, frase e trecho visíveis juntos, nada cortado.
  • Quadro final mostra o comando completo e a URL, escritos exatamente.

Entrega

Entregue final.mp4 e a pasta do projeto (index.html, film.config.js, assets/, meta.json). Informe o caminho, a duração e quaisquer avisos de validação que foram aceitos. A pasta re-renderiza com o mesmo comando; para re-marcar ou reutilizar para o próximo lançamento, edite apenas film.config.js.

Veja references/content-rules.md para limites de tamanho e redaçã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 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

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