Communitygithub.com

motion-build

Monta UMA inserção animada para vídeos usando HyperFrames + GSAP no estilo do canal. Por padrão, estilo v4 'apresentação com imagens' (aprovado pelo autor como referência, com dois exemplos em russo no YouTube).

O que é motion-build?

Este skill é especializado em construir uma única inserção animada (4 a 10 segundos) para vídeos, utilizando HyperFrames e GSAP, seguindo o estilo v4 do canal — uma 'apresentação com imagens' que o autor considera ideal. Ele lida com a criação, reparo ou ajuste de animações individuais, cenas ou inserções de movimento com base em especificações prontas, geralmente vindas de um plano de movimento (`/motion-plan`). O skill não é para planejar ou orquestrar o vídeo inteiro; essas tarefas são delegadas a outros skills (`/motion-plan` e `/motion-run`). Ele descreve um fluxo de trabalho passo a passo: preparar o projeto HyperFrames, copiar os assets de estilo (incluindo tokens e fontes), construir a composição seguindo regras rígidas de timing e easing, verificar com `npm run check`, inspecionar visualmente através de snapshots, e finalmente renderizar o MP4. O skill impõe o uso de um conjunto de referências (`style-v4.md`, `gotchas.md`, `design-system.md`) e técnicas documentadas, garantindo que cada inserção seja visualmente consistente, determinística e alinhada com o estilo do canal. É particularmente útil quando um subagente recebe a tarefa de construir uma cena específica de um plano de movimento, ou quando se está lidando com uma composição HyperFrames para um vídeo nesse estilo. O resultado é um MP4 semi-acabado que será montado no vídeo final pelo orquestrador.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/sstani-bgv/montage-skills/tree/HEAD/motion-build

Perguntar na sua IA favorita

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

Prévia

Do README da skill

Documentação

Construção de uma Inserção Animada

Você monta uma animação completa de 4 a 10 segundos, que é editada no vídeo como uma inserção ou aplicada como sobreposição sobre o quadro. Ela deve mostrar visualmente o pensamento que o autor está expressando em voz — não ilustrar de forma genérica, mas mostrar especificamente essa ideia.

Estilo Padrão — v4 "Apresentação com Imagens"

Se o usuário não pedir outro — monte no estilo v4. O autor o chamou de "absolutamente ideal" e pediu que os próximos vídeos fossem exatamente iguais. Tudo sobre ele — references/style-v4.md: referências (descrições no references/style-v4.md), layouts kinetic / full / split-cam / split-screen / lower com geometria precisa, constantes, áudio, aceitação.

  • Estilos e helpers gerais: assets/style-v4/common.css, common.js (heroIn, rise, chipIn, countUp).
  • Cenas de referência (fragmentos + .sfx.json): references/recipes/v4/ — comece pela mais próxima em layout.
  • Montagem: escreve o fragmento W/scenes/NN.html → python3 scripts/mk_scene.py W NN → check → render. Imagens: scripts/gen_images.sh + scripts/alpha.py; clipes webcam/tela: scripts/cut_clips.py.
  • Sons de carimbo e "resultado ruim" — assets/style-v4/sfx/, o restante é do pacote media-use.

Camada antiga (abaixo): técnicas copiadas da edição de Austin Marchese e adaptadas ao sistema de design do canal — PiP-morph, zoom-through, carrossel de capítulos, etc. No v4, são usados como acentos dentro da cena, não como base. As técnicas são copiadas exatamente — timings, curvas, ordem das camadas; paleta e tipografia apenas do próprio sistema.

O que Ler e em Qual Ordem

  1. references/style-v4.md — como deve parecer.
  2. references/gotchas.md — antes de escrever código. Lá estão as proibições do motor, armadilhas do tema claro e regras de emendas. Cada item já custou uma iteração.
  3. references/style-rules.md — leis de estilo: como o texto aparece e desaparece, o que define o ritmo, o que está sempre em movimento. Siga-as independentemente da técnica que estiver montando — são elas que tornam a edição reconhecível.
  4. references/design-system.md — paleta, escala, componentes, regras da marca. Não pode violar.
  5. Mecânica da sua técnica — leia apenas sua seção:
    • references/techniques.md — técnicas com implementação verificada;
    • references/techniques-observed.md — técnicas extraídas de análise, mas ainda não montadas; construa conforme a descrição.
  6. references/recipes/<technique>.html — implementação funcional de techniques.md. Não é um modelo para copiar inteiro, mas um exemplo de como resolver partes complexas. Consulte quando a mecânica não for óbvia.

A especificação para a cena específica vem do /motion-plan ou diretamente do usuário.

Ordem de Trabalho

1. Prepare o Projeto

Se o projeto ainda não existe:

./node_modules/.bin/hyperframes init <nome> --example blank --non-interactive --resolution landscape --skill motion-graphics

Um npx hyperframes simples na raiz do repositório falha com "Missing script" — o CLI não é global. Dentro de um projeto já criado, funcionam npm run check e npm run render; de fora, use o caminho para o binário acima.

Copie a pasta assets/ deste skill para o projeto inteira, não arquivo por arquivo: tokens.css importa fontes via @import "./fonts/fonts.css", e a estrutura de diretórios deve coincidir.

cp -R <caminho-para-o-skill>/assets/. <projeto>/assets/

As fontes Onest e Unbounded estão localmente (cirílico e latim), então o texto renderiza igual em qualquer máquina. O GSAP, o modelo inicial e todas as receitas carregam do CDN — a rede ainda é necessária na renderização. Se não houver rede, coloque gsap.min.js ao lado e corrija <script src>.

Conexão de tokens na composição — uma linha:

<link rel="stylesheet" href="./assets/tokens.css" />

2. Monte a Composição

Contrato do HyperFrames: timeline única paused em window.__timelines["main"], cada elemento timed com class="clip", data-start e data-duration. Detalhes — em /hyperframes-core, carregue-o se tiver dúvidas sobre a estrutura.

Três coisas que determinam se a técnica vai funcionar:

Copie timings e curvas literalmente. A diferença entre power2.inOut e power2.out no crescimento de um PiP é a diferença entre um movimento de câmera e um zoom de imagem. Entre power3.inOut e power4.inOut em uma emenda push — entre um deslizamento e um puxão.

Mantenha a técnica, não a letra da especificação. Se a descrição quadro a quadro da especificação diverge do easing declarado (as porcentagens de crescimento não correspondem à curva), a prioridade é o easing: ele define como o movimento é percebido. Se a especificação dá uma amplitude em que o objeto não sai do quadro no momento do corte do clipe — recalcule a amplitude para a geometria real de 1920×1080 e avise.

Uma técnica que não é percebida deve ser reforçada. Uma implementação formalmente correta que não é visível não é trabalho feito. A transição de preenchimento em um fundo claro é quase invisível até que você adicione um marcador de frente. Uma emenda em que ambos os lados estão vazios no meio não tem o que mostrar.

Se a técnica não estiver nem em techniques.md nem em techniques-observed.md — construa a partir da descrição quadro a quadro da especificação, mas primeiro encontre nela o ponto de inflexão: a decisão da qual depende o sucesso do quadro. Geralmente não é uma curva, mas a geometria — quanto deslocar, onde está o centro do grupo, o que sai da borda. A especificação é escrita por quem não viu os quadros; ele provavelmente não notou o ponto de inflexão. Tome a decisão você mesmo, verifique com os quadros e obrigatoriamente nomeie-a no relatório — ela irá para o skill do próximo.

3. Verifique

npm run check

Zero erros e zero warnings. A auditoria de contraste e layout reclamará das próprias técnicas — fundo desfocado, sobreposição de cenas na emenda, vizinhos atenuados. Diferencie a técnica de um problema real: arrume os achados reais, marque as técnicas com opt-outs padrão. Cada opt-out desativa apenas sua verificação específica — tabela em gotchas.md, não pode colocar aleatoriamente: data-layout-ignore também remove o contraste, e o texto abaixo dele silenciosamente sai do relatório.

Coloque também um sidecar *.motion.json ao lado — o check o pegará automaticamente e verificará a intenção de movimento na mesma timeline rebobinada usada pelo render. É o análogo automático mais próximo de "renderize e veja": captura uma entrada que o rebobinado perdeu, uma ordem quebrada de stagger e um plano congelado. Formato — em gotchas.md.

4. Veja com os Olhos — Este Passo é Obrigatório

../node_modules/.bin/hyperframes snapshot . --frames 8 -o snapshots

Abra snapshots/contact-sheet.jpg via Read — é uma imagem, você a vê. O check não dirá que o quadro está vazio, o texto pequeno ou os blocos estão mal posicionados.

Olhe o quadro 0 separadamente — é a falha mais comum. Pelas regras de estilo, a cena começa já em movimento, não de forma estática ou vazia; se no quadro zero estiver vazio ou tudo já montado, a técnica está quebrada no lugar mais visível.

Faça também snapshots pontuais nos pontos mais complexos:

../node_modules/.bin/hyperframes snapshot . --at 1.45,1.55,1.675,1.8 --no-end -o snapshots-detail

Quais pontos escolher: se a técnica tiver uma emenda — o meio da emenda e um quadro de cada lado. Se não houver emenda, capture os momentos de recálculo da composição: compressão de lista, rearranjo de bloco, mudança de elemento ativo. É aí que o layout quebra, e em oito quadros uniformes isso não é visível.

Locais polêmicos (gradientes, tamanho pequeno de fonte) veja em PNG em tamanho real: o JPEG contact-sheet mente tanto em tamanho quanto em banding.

Itere até a imagem ficar boa. A primeira versão quase sempre sai pequena — este é o erro mais comum, o quadro 1920×1080 é maior do que parece.

5. Renderize

npm run render

Onde Colocar o MP4

Em renders/ do seu projeto e em nenhum outro lugar. Nomeie o caminho no relatório — quem vai distribuir as inserções prontas pelas pastas comuns é quem monta o vídeo inteiro: ele sabe como elas se chamam na timeline e quais foram aceitas.

Isso não é formalidade. Em um vídeo, nove montadores distribuíram resultados em três lugares diferentes, dois deletaram renders/ completamente, um duplicou o arquivo em duas pastas "para o orquestrador encontrar de qualquer jeito" — e o orquestrador teve que procurar renders com find por todo o disco. A regra sobre "vídeos finais em output/" do CLAUDE.md se refere a vídeos prontos, não a inserções para montagem: a inserção é um semi-acabado.

Também não delete a pasta de trabalho do projeto. O orquestrador a removerá quando a cena for aceita; até lá, ela pode ser necessária para correções.

Sobreposição Sobre o Quadro: Insira um Fundo na Composição

Uma sobreposição — painel de vidro, título, glossário — é calculada para um quadro específico abaixo dela, e tem uma consequência técnica não óbvia: backdrop-filter não vê o que não está na composição. Se você renderizar a sobreposição com fundo transparente e sobrepô-la no programa de edição, o vidro desfocará o vazio, ou seja, não desfocará nada, e o painel ficará como um filme plano.

Portanto, a composição da sobreposição é construída de forma diferente da inserção:

# pedaço do original exatamente no timecode da cena — em assets do projeto
ffmpeg -ss 20.0 -i <original> -t 4.0 -vf "scale=1920:1080,fps=30" -an \
  -c:v libx264 -crf 16 -preset veryfast -pix_fmt yuv420p -y assets/plate.mp4
<video id="plate" class="clip" data-start="0" data-duration="4" data-track-index="0"
       src="./assets/plate.mp4" muted data-layout-ignore></video>

O fundo vai na trilha zero e é marcado com data-layout-ignore — ele não é auditado. O vidro sobre ele funciona de verdade. Na saída, um MP4 normal que, na edição, é colocado no lugar do seu trecho, não sobre ele; o áudio do fundo foi removido, a trilha sonora vem do original.

Alternativa — --format mov com transparência — é necessária apenas quando o editor pede alfa explicitamente e está disposto a colocar a camada ele mesmo.

O Que Relatar

Resumidamente, 10–15 linhas: o que foi feito, caminho para o MP4, quais partes foram complexas e como foram resolvidas, o que ficou imperfeito. Não re conte o código — ele está no arquivo.

Nomeie separadamente as divergências da especificação. Se você recalculou a amplitude, mudou a curva ou adicionou um elemento que não estava na especificação, diga e explique por quê. A especificação é escrita por quem não viu os quadros; você viu. Uma divergência que é relatada é uma descoberta; uma que é omitida é uma surpresa na edição.

O Que É Considerado Pronto

  • check limpo, MP4 renderizado;
  • técnica é perceptível nos quadros a olho, não apenas "formalmente implementada";
  • paleta, escala e regras do sistema de design seguidas;
  • determinismo: dois snapshots do mesmo timecode dão o mesmo SHA-256, se a cena tiver pseudoaleatoriedade.

Individual skills in this repo

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

sstani-bgv/montage-skills

Разметить motion-план для ролика (по умолчанию в стиле v4 «презентация с картинками»: kinetic-интро, спикер + достраивающаяся панель, картинки-метафоры, звук) — посмотреть транскрипт, скрипт или само видео и решить, в каких местах и какими приёмами визуально показать то, что автор проговаривает голосом. На выходе MOTION.md с таймкодами, выбранными приёмами и покадровыми спеками на каждую сцену. Используй этот скилл всегда, когда нужно понять, где в ролике нужны анимации, какие именно и почему, когда пользователь даёт транскрипт или ссылку на своё видео и спрашивает, что тут анимировать, а также когда надо переразметить уже существующий план. Сборкой занимается /motion-build, оркестрацией — /motion-run.

sstani-bgv/montage-skills

Сделать все анимационные вставки для ролика от начала до конца (по умолчанию в стиле v4 «презентация с картинками» — эталон, одобренный автором) — посмотреть видео или транскрипт, разметить motion-план, раздать сцены сабагентам, принять работу, собрать черновой монтаж со вставками поверх исходника и отдать его вместе с MP4 по таймкодам. Используй этот скилл всегда, когда пользователь просит сделать анимации для своего ролика, оживить видео вставками, «сделать как у такого-то блогера», собрать графику под уже записанный материал или довести ранее размеченный motion-план до готовых файлов. Это точка входа: сам зовёт /motion-plan для разметки и раздаёт сборку по /motion-build. Для одной отдельной анимации бери /motion-build напрямую.

Habilidades Relacionadas