Communitygithub.com

Motion

Erstellt Motion Graphics als Code und liefert das fertige MP4 – Reel 9:16, Video 16:9, Kurzanzeige, Vorspann, LP-Animation. Schreibt die Animation in HTML/Canvas mit einer einzigen Uhr, rendert Frame für Frame auf dem Rechner (Playwright + ffmpeg) und prüft vor der Auslieferung anhand eines Frame-Blattes.

Was ist Motion?

Diese Skill ermöglicht es, Motion-Graphics-Videos vollständig über Code zu erstellen, ohne auf generative KI-Tools angewiesen zu sein. Der Kern ist ein HTML/Canvas-Programm, das jeden Frame basierend auf einer globalen Zeitvariablen `t` zeichnet. Dies garantiert pixelgenaue Farben, exakte Schriftarten und konsistente Ergebnisse – Änderungen wie "30 % langsamer" oder "auf 9:16 umstellen" erfordern nur eine Codezeile. Die Skill unterstützt die Plattformen Claude Code, Cursor und Codex. Der Workflow umfasst die Erstellung eines Marken-Kits, eine sechskomponentige Prüfung, ein Drehbuch mit Zeitangaben und fünf weitere Schritte bis zur finalen MP4-Ausgabe. Die Render-Pipeline nutzt Playwright für die Browser-Automation und ffmpeg für die Videokodierung. Ein besonderer Fokus liegt auf der Reproduzierbarkeit durch feste Seeds und deterministische Funktionen – so stimmen exportiertes Video und Vorschau im Player immer überein. Die Skill enthält 39 Animationstechniken in 7 Gruppen, Vorlagen und ein Prüfsystem mit sechs Ebenen, um Qualität und Markentreue sicherzustellen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/arthurmkt/arthur-portfolio-mkt/tree/main/design/motion

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Motion em código

O vídeo nasce de código. Eu escrevo um programa que desenha cada quadro a partir de um relógio t, renderizo quadro a quadro e monto o MP4. Por isso cor em hex, fonte da marca e números saem exatos: estão escritos, não interpretados por um gerador. E por isso pedir "30% mais lento" ou "passa para 9:16" muda uma linha, sem refazer a peça.

O que não faz: filmar pessoa, lugar ou produto; imagem fotorrealista do zero; adivinhar a marca. Foto, vídeo e tela reais da marca entram como arquivo, e o código anima o que for fornecido.

Vídeo real de base entra como sequência de quadros, nunca como <video>: ffmpeg -i base.mp4 -q:v 3 frames/f%04d.jpg e, no draw, a imagem do quadro floor(t × fps) + 1, carregada sob demanda. Com <video> o servidor do render não atende Range (o seek não anda) e a conexão de mídia nunca fecha (o networkidle estoura).

Requisitos: Python 3.10+, pip install playwright + playwright install chromium (o script usa o canal chrome; troque para o Chromium padrão em abrir() se não tiver o Chrome instalado), ffmpeg e ffprobe no PATH.

Arquivos desta skill:

  • assets/template.html: motor com relógio único, semente fixa, easings, stagger, player com barra de tempo e nome da cena, área segura.
  • scripts/render.py: renderiza o MP4 quadro a quadro, a versão curta por trechos e a folha de revisão.
  • tecnicas.md: as 39 técnicas em 7 grupos, com os parâmetros de cada uma e as combinações por objetivo.
  • exemplos/reel-resultado-8s.html: peça pronta de 8 s (número embaralhado → barras → CTA com confete), com dados de exemplo.

Pasta de trabalho: uma pasta por peça (ex.: motion/<marca>/<peça>/). O HTML, os assets (logo, fotos, fonte), o MP4 e as folhas de revisão ficam juntos.


Passo 0 — Kit da marca

Monte o kit uma vez por marca, a partir do manual, do site ou do que a pessoa mandar:

ItemComo entra
Paletahex com papel: fundo, texto, destaque, número. 3 a 4 cores; 7 cores é sobra de cor e falta de contraste
Fontesnome exato. Google Fonts → <link>; fonte própria → arquivo na pasta + @font-face
Logoarquivo (SVG ou PNG transparente). Nunca desenhar o logo do zero nem descrever em palavras: sem arquivo, pedir
Tom de movimento2 a 3 adjetivos (calmo, energético, premium, popular) → define easing e corte
Númerosos reais, com período e fonte. Sem número conferido → ou peço, ou ele aparece na tela rotulado "dados de exemplo"
Oferta, CTA, @/sitedo briefing. Urgência só com prazo real
Trilhaarquivo licenciado da marca ou de banco + BPM e segundo do drop

Salve o kit em motion.md na pasta da marca. Da segunda peça em diante, ele é lido, não remontado.

Passo 1 — Triagem: os 6 componentes

Checklist reimpresso, uma pergunta por turno, item preenchido nunca reaberto, e o que o briefing já responde entra preenchido. Faltou um componente, eu decido sozinho, e quase sempre diferente do que a pessoa queria.

1. Formato — proporção + resolução + duração + fps
2. Cena — o que aparece, em que ordem, quantos segundos cada
3. Textos — as frases exatas, entre aspas (lista fechada, literal)
4. Técnica — pelo nome (tecnicas.md)
5. Ritmo e som — easing, stagger, BPM / trilha
6. Entrega — MP4 · versão curta de 6 s · player para revisão · HTML em loop (LP) · fundo transparente

Formato pela plataforma:

ProporçãoResoluçãoOnde rodaDuração típica
9:161080×1920Reels, Stories, TikTok, Shorts8–15 s, gancho no 1º quadro
4:51080×1350feed IG/FB6–15 s
1:11080×1080feed, alguns posicionamentos6–15 s
16:91920×1080YouTube, apresentação, telão, site5 s (vinheta) a explicativos longos
LPlargura da página (ex.: 1440)hero e seçõesloop leve de 5–10 s, entregue como HTML

30 fps cobre quase tudo. 60 fps só em zoom, partículas rápidas e movimento de câmera. Peça de anúncio: sempre uma versão de 6 s com a mesma assinatura, para teste.

Passo 2 — Roteiro com minutagem (portão)

Antes de escrever código, mostre o roteiro e espere aprovação:

Formato: 9:16 · 1080×1920 · 15 s · 30 fps · trilha 120 BPM (cortes em 3 / 7 / 11 s)
Kit: fundo #050505 · destaque #E50914 · número #FFDD00 · Morganite / IBM Plex Sans · logo.svg

| Cena | Tempo | Técnica | O que acontece | Texto (literal) | Entra / sai |

Regras do roteiro:

  • Uma ideia por cena. Se a cena precisa de duas frases, são duas cenas.
  • 2 a 4 s por cena. Abaixo de 2 s, o texto não dá tempo de ler.
  • Tempo de leitura: 1 s para cada 3 palavras + 1 s de margem. Número sozinho: 1,5 s · 3 palavras: 2 s · 6 palavras: 3 s · 9 palavras: 4 s. Frase que pede mais de 4 s é longa demais para uma cena: divide ou corta palavra (cortar palavra de copy aprovada é decisão de quem aprovou).
  • Diga como entra e como sai. A saída liga uma cena à próxima.
  • Gancho nos 3 primeiros segundos em 9:16 e 4:5. A mensagem principal nunca fica para o fim.
  • Corte na batida: batida = 60 ÷ BPM segundos; compasso = 4 batidas. Cena com duração em múltiplos do compasso fecha redonda (120 BPM: batida 0,5 s, compasso 2 s · 128: 0,47 / 1,88 · 100: 0,6 / 2,4 · 90: 0,67 / 2,67).

Passo 3 — Construção

Copie assets/template.html para a pasta de trabalho e preencha CFG, BRAND e SCENES. Leis do código, porque é delas que depende o MP4 sair igual ao que foi aprovado no player:

  1. Tudo é função de t. Nada de setTimeout, Date.now(), CSS transition/animation ou estado acumulado entre quadros. A letra 3 no instante 1,4 s está sempre no mesmo lugar.
  2. Semente fixa (rng(CFG.SEED + i)) em todo valor aleatório. Sem ela, o exportado sai diferente do aprovado.
  3. Simulação (física, boids, tecido): fórmula analítica em t, ou pré-cálculo no carregamento a passo fixo (1/240 s), guardado por quadro e lido pelo índice. Nunca integrar dentro do draw.
  4. Fontes em CFG.FONTS e assets em CFG.ASSETS: o motor espera carregar antes do primeiro quadro. Fonte que não carregou cai em genérica sem avisar, e é o erro mais comum.
  5. Área segura no 9:16: texto, número e logo dentro de 250 px do topo, 350 px da base, 120 px da direita e 60 px da esquerda (valores aproximados; mudam com os apps).
  6. Easing com intenção: inOut é o padrão; back (overshoot) nas entradas de texto, pinos e números; linear só em rotação contínua e rolagem; bounce só em objeto que cai. Stagger de 0,07 s entre letras e 0,15 s entre cards.
  7. Hierarquia: o número principal é o maior elemento da cena.
  8. Comentário no topo de cada cena com o tempo e a técnica.

Peça longa ou com técnica pesada (shader, simulação): uma cena por vez. Construa, revise e aprove a cena antes de juntar. Peça curta (até ~15 s, 4 cenas leves) pode nascer inteira, mas a revisão continua cena a cena.

Passo 4 — Revisão antes de mostrar

python ~/.claude/skills/motion/scripts/render.py peca.html --sheet auto --safe

Gera a folha com o meio e o fim de cada cena, com a área segura pintada. Leia a folha pelo método VER → AMPLIAR → CONFIRMAR (recorte ampliado em texto pequeno, número e logo) e passe as 6 camadas:

CamadaConfere
1. Técnicaduração, resolução e fps iguais ao pedido; sem quadro preto no começo ou no fim
2. Marcahex certos; fonte da marca carregada, não genérica; logo sem distorção, giro ou cor trocada; tom do movimento combina
3. Leiturauma ideia por cena; cada texto fica o tempo da regra; contraste do texto contra o fundo; número principal é o maior
4. Plataformaproporção certa; nada fora da área segura; gancho nos 3 primeiros segundos; funciona sem som
5. Dadosnúmeros iguais aos fornecidos, sem arredondar; período e fonte; exemplo rotulado na tela; nenhum número inventado
6. Direitostrilha licenciada, da marca ou gerada; fotos e telas autorizadas; marca de terceiro só com permissão; promessa da oferta validada

Para conferir um instante específico: --sheet 1.5,2.9,3.1. Problema achado eu corrijo antes de mostrar, sem perguntar.

A 3ª passada do material, assistir no celular e sem som, é de quem aprova. Eu confiro quadros, não a sensação do vídeo rodando. Na entrega, peça explicitamente essa passada.

Passo 5 — Render e entrega

python ~/.claude/skills/motion/scripts/render.py peca.html                                   # MP4 inteiro
python ~/.claude/skills/motion/scripts/render.py peca.html --segments 0-3,11-15 -o peca_6s.mp4   # versão curta
python ~/.claude/skills/motion/scripts/render.py peca.html --audio trilha.mp3                # com trilha

Depois do render: ffprobe para confirmar resolução, fps, nº de quadros e duração. Entregue:

  • o MP4 (H.264, yuv420p, +faststart), pronto para subir;
  • a versão de 6 s, se for anúncio;
  • o HTML com player (abre no navegador: play, pausa, barra de tempo, nome da cena, área segura). É nele que quem aprova aponta o segundo exato do ajuste.

LP: a entrega é o próprio HTML em loop, sem MP4. Leveza primeiro: não pode pesar a página.

Trilha: a skill mixa um arquivo (--audio) e alinha os cortes ao BPM informado. Trilha gerada em código não está implementada; se pedirem, diga isso em vez de improvisar. Música de terceiros sem licença derruba o anúncio: nunca usar.

Passo 6 — Ajuste

A primeira versão é rascunho. Ajuste bom aponta a cena ou o segundo, diz o quanto e diz o que manter: "Na cena 1 (0–3 s), segure o +248% travado 1,5 s antes de trocar. Não mexa no resto." Eu mudo só o trecho afetado e re-renderizo.

SintomaCausa provávelCorreção
Movimento robóticoeasing linearinOut, e back nas entradas
Tudo entra juntosem stagger0,07 s entre letras, 0,15 s entre cards
Fonte diferente da marcafonte não carregouconferir CFG.FONTS / @font-face e o arquivo na pasta
Texto cortado no 9:16layout pensado em 16:9refazer na grade 1080×1920 respeitando a área segura
Player travandopartículas ou shader demaismenos elementos no player, contagem cheia só no render
Exportado diferente do playeraleatório sem semente ou estado acumuladoleis 1 a 3 do Passo 3
Corte fora da batidacenas sem relação com o BPMdurações em múltiplos da batida
Número erradodado não veiousar exatamente a lista fornecida, sem arredondar

Depois de publicado: se a queda de retenção é nos 3 primeiros segundos, troque só a cena 1; se é numa cena do meio, encurte ou troque só aquela; se o clique não vem, teste encerramentos diferentes (confete, selo girando, QR) mantendo o resto igual. Uma variável por vez.

Biblioteca da conta

Peça aprovada → no motion.md da marca, registre: o roteiro aprovado, as técnicas usadas, o caminho do HTML e, quando houver, a métrica dos primeiros 7 dias. A próxima peça começa do que já performou, e o encerramento padrão da marca (assinatura final com logo + CTA) é reaproveitado, não refeito.

Individual skills in this repo

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

Verwandte Skills