Communitygithub.com

motion-qa

Verifica os stills de um rolo de papercut contra o Style DNA e o storyboard. Gera folhas de contato em alguns timestamps, executa a lista de verificação completa e escreve o resumo de entrega. Use para "Fazer QA do rolo", "verificar se minhas cenas parecem com o papel", "isto está pronto para postar".

O que é motion-qa?

Este skill, motion-qa, é uma ferramenta de garantia de qualidade para animações em estilo papercut, projetada para ser usada com assistentes de IA como Claude Code ou Cursor. Ele permite verificar se os stills de um rolo animado estão consistentes com o 'Style DNA' (guia de estilo visual) e o storyboard, focando no estilo e não no conteúdo. O skill automatiza a geração de folhas de contato a partir de timestamps específicos, executa uma checklist abrangente (como verificar se todos os objetos parecem de papel, se a câmera se move suavemente, se as legendas estão corretas, etc.) e produz um resumo de entrega. Suporta projetos que utilizam Remotion e Python, e também se integra com o ecossistema 'kyfram'. É útil para desenvolvedores e animadores que desejam garantir a qualidade visual e a aderência ao guia de estilo antes da renderização final, economizando tempo e evitando retrabalho. O processo envolve renderizar stills, compará-los com o storyboard, executar a checklist, e entregar um relatório com o status de cada item e indicação de placeholders.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/boytegar/motion-skills/tree/HEAD/skills/motion-qa

Perguntar na sua IA favorita

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

Documentação

Papercut QA (Garantia de Qualidade Papercut)

Compara stills quanto ao estilo, não ao conteúdo, contra o Style DNA e o storyboard. Execute por cena durante a construção e uma vez no rolo inteiro antes da renderização final.

Pré-voo

  • Instalação: Padrão ou Completa. Os stills precisam de um projeto estruturado com Remotion, e as folhas de contato precisam de Python com numpy e Pillow ($MOTION_PY). Peças faltando: ./install.sh --doctor, depois motion-setup.
  • Um projeto kyfram não precisa de Remotion: invoque o skill kyfram antes de inspecionar ou corrigir a saída de uma cena Kyfram. O qa.sh extrai seus stills dos segmentos de cena em cache (core/tools/kyfram_qa.py), então renderize uma vez com core/tools/render.sh antes do QA. Tudo abaixo se aplica sem alterações.
  • Biblioteca: $MOTION_LIB, ou a linha MOTION_LIB= em ~/.config/motion-explainer/config.env, ou pergunte uma vez.
  • Leia primeiro: Style DNA em $MOTION_LIB/style/$MOTION_STYLE/docs/style-guide.md seção 2, e a folha de fundo style/$MOTION_STYLE/remotion/public/bg/backdrops/_sheet.jpg. Cada imagem custa cerca de 0,7-1,5k tokens, então abra apenas o que a etapa precisa.
  • Para densidade, $MOTION_LIB/style/$MOTION_STYLE/docs/frame-breakdown.md ("Estatísticas de ritmo" no final): as cenas duram em média 2,8 s, 2-4 eventos visuais discretos por cena, um a cada 0,4-0,8 s em uma palavra tônica, uma nova página de legenda a cada 0,6 s. Copie a densidade, não o conteúdo.

1. Renderizar stills

A partir da pasta video/ do projeto:

$MOTION_LIB/core/tools/qa.sh NOME DE-ATE ENESIMO [ESCALA=0.3] [COLUNAS=9]
  • Use 4-6 timestamps por verificação. Para uma cena, ENESIMO é aproximadamente sua duração em quadros dividida por 4. Deixe DE-ATE de fora para o rolo inteiro e aumente ENESIMO.
  • A saída é out/qa/NOME_0.jpg (e _1, _2 para intervalos mais longos), no máximo 45 quadros por folha. Leia a folha; mantenha as folhas pequenas.
  • Um comando de QA por cena e nunca duas renderizações ao mesmo tempo. Mantenha as correções em duas rodadas por cena.
  • Verifique contra o storyboard: o quadro 0 da cena, seus eventos-chave em suas palavras, nada cortado, nada cobrindo o banner ou as faixas de legenda.

2. Lista de Verificação

  • Cada objeto parece de papel: granulação, borda irregular, sombra projetada, sombreamento de peças empilhadas, sem contornos ou gradientes.
  • A câmera do mundo se move suavemente. Apenas o banner e os rótulos tremem (gradual, sutil).
  • O banner está fixo em posição e colado, 3-7 palavras, um fato cada, nunca repete o narrador. Os banners sozinhos se leem como uma ficha de fatos.
  • Cada cenário ilustra uma palavra concreta em sua linha de narrador, números são adereços físicos, e há um cenário de retorno antes do CTA.
  • Cada número e rótulo de interface remete à lista de fatos. O roteiro tem pelo menos uma limitação honesta e uma pilha de recursos de exatamente três.
  • Legendas: uma etiqueta por palavra, inclinada, aparecendo no início, páginas de 1-3, na faixa de 68-80%, nunca sobre um rosto.
  • Saturação apenas em personagens, legendas e sinais.
  • Um evento visual em cada palavra tônica, com movimento ambiente sempre em andamento.
  • Cortes em mudanças de banner (cenários 1,5-3 s em tours e notícias, até 5 s em um ritmo metafórico), 20% inferiores limpos.
  • O bloco HOOK (SAY / WRITE / SHOW / ALIGN) está na tela exatamente como escrito: o quadro 0 mostra o momento SHOW em ação com o título WRITE sobre ele, e a primeira linha do narrador é SAY.
  • Cada cena tem um movimento de câmera, no máximo uma virada de página ou rasgo, um puxão de fita ou chicotada para o CTA, e cada transição tem seu efeito sonoro.
  • Passagem de humor visível na tela: um formato em todo o rolo, um adereço de figurino por ideia, um ritmo de luta, o adereço do quadro 0 retorna modificado no cenário do CTA, e cada piada é entendida em menos de 1 s e nunca cobre o banner, as legendas ou o número-chave.
  • Vocabulário no narrador e banners corresponde ao nível do público em SERIES.md.
  • Narrador, legendas e eventos estão sincronizados (percorra o Studio em cada corte).

Para um item reprovado, corrija o arquivo da cena (ou o kit na biblioteca, nunca src/lib/ no projeto) e execute novamente a cena. Reconstrua uma cena com motion-build.

3. Entrega

Abra a pré-visualização do Studio, liste as cenas com durações e diga o que é provisório: narrador, música, efeitos sonoros, assets. Se o narrador for provisório, diga como regravá-lo (motion-voice). Após a postagem, os números vão para motion-strategy para a autópsia.

Verificação de Princípios

Percorra uma cena a 5 qps e verifique contra $MOTION_LIB/style/$MOTION_STYLE/docs/motion-principles.md: antecipação antes de cada grande movimento (2), tudo suavizado (6), algo que se arrasta após impactos (5), um adereço focal (3), um ritmo exagerado (10), sombreamento empilhado e uma sombra consistente (11).

Hand-off (Passagem)

As correções voltam para motion-build (cena ou som) ou motion-voice (sincronização). Uma passagem limpa encerra o rolo: renderize com $MOTION_LIB/core/tools/render.sh quando o usuário pedir.

Individual skills in this repo

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

bang-motion

Render a reel in the Bang Motion style: high-end cinematic motion graphics with a multi-layer glowing-horizon background, floating colour-mesh blobs, living film grain, frosted-glass UI cards, editorial kinetic typography, a breathing camera, and anti-PPT pacing. Use when the user says cinematic motion graphic, promo opener, product launch reel, kinetic typography, SaaS product tour, glassmorphic UI, anti-slides, or asks for a video that moves like footage instead of a deck. Gunakan skill ini setiap kali user meminta "video promo", "opener", "intro animasi", "motion graphic", "bumper", "kinetic typography", "animasi teks sinematik", "explainer", "video penjelasan" (jurnalisme visual, kartun edukasi, kolase), atau menunjukkan referensi video promosi/explainer dan ingin dibuatkan versi web-nya — bahkan bila mereka tidak menyebut kata "motion graphic" secara eksplisit. Juga gunakan bila user mengeluh hasil animasi web "seperti PPT/presentasi" dan ingin lebih sinematik, atau ingin meren...

isometric

Render a reel in the Isometric style: calm precise product line art in 2:1 dimetric isometric on a white or dark ground, drawn only with constant 2px hairlines, white-filled faces so nearer objects hide farther lines, rounded slabs with visible thickness, stacked layers, repeated-part grids, and one tiny dark accent per frame. Use when the user says isometric, product line art, technical illustration, exploded hardware view, or asks for a clean documentation-grade diagram look.

motion-build

Build and render a papercut episode from a storyboard with the library. Scaffolds the project, builds scenes with parallel agents, assets and audio, renders the mp4, then harvests reusables. Use for "build the reel", "scaffold an episode", "rebuild scene 4", "render it".

motion-explainer

Make a papercut reel, video or explainer end to end. Short vertical (9:16) cut-paper explainers from a link (repo, product page, announcement), idea to mp4. Also routes partial asks to the stage skills and hands out the style prompt for other tools.

motion-script

Turn a link into a papercut reel script. Researches a sourced facts list, writes the 75-95 word script on the 10-beat spine, a banner fact track, a staging table with one set per banner, and the humour pass. Use for "write the script", "research this repo for a reel".

motion-storyboard

Storyboard a papercut script before any code. Writes the Camera / Cut table, one block per scene with frame-level events on each stressed word, the SFX plan and the proof beat. Use for "storyboard this script" or "plan the camera moves and cuts".

motion-voice

Voice a papercut reel and time it to the picture. Three paths, local Qwen3-TTS, your own recording or another TTS, or a placeholder voice. Covers delivery rules, voice.json, captions and scene timing. Use for "set up the voice", "re-voice this", "time the script".

papercut

Render a reel in the Papercut style: layered construction paper brought to life with paper grain, torn edges, stacked shade strips, drop shadows, rigid cut-out animation, a slow camera push, taped headline banners and word-by-word torn-tag captions. Use when the user says cut paper, papercraft, paper cutout, paper collage, construction paper, or asks for the default handcrafted explainer look.

Habilidades Relacionadas