Communitygithub.com

motion-review: o portal do gosto

Crítico independente e portal de qualidade para motion graphics. Avalia uma peça em HyperFrames / GSAP / HTML (ou Remotion) com uma rubrica de estúdio em 9 dimensões, verifica portões rígidos, uma barra de artesanato de 12 pontos e a lista anti-slop examinando os quadros, e retorna APROVADO / POLIR / REFORMULAR com correções exatas no nível do quadro. Use antes de qualquer renderização destinada à entrega, após cada revisão, e sempre que for solicitado a revisar, criticar, "melhorar" ou "isto está bom?". Melhor executado como um subagente de contexto limpo para que o construtor nunca avalie seu próprio trabalho.

O que é motion-review: o portal do gosto?

O skill motion-review é uma ferramenta de revisão especializada para motion graphics, projetada para ser executada como um subagente de IA independente (em plataformas como Claude Code, Cursor ou Codex). Ele atua como um crítico de gosto e portal de qualidade, indo além da verificação de código para avaliar a excelência estética e artística. O skill segue um procedimento rigoroso: verifica a estrutura do projeto (HyperFrames/Remotion), mapeia o movimento, cria folhas de contato de quadros-chave, prova a profundidade, assiste a renderizações em tempo real e lê o código fonte em busca de problemas comuns de qualidade. Em seguida, pontua a peça em 9 dimensões (Conceito, Composição, Tipografia, Temporização e Easing, Coreografia, Transições, Profundidade e Textura, Sincronização de Som, Acabamento) usando uma rubrica de 1 a 5, verifica 12 itens da barra de artesanato (passa/falha) e escaneia os 15 principais padrões de slop (S1 a S15), como fade-ups genéricos, durações idênticas ou falta de câmera. Ele também aplica portões rígidos (por exemplo, texto ilegível, fails de verificação, mais de 3 hits de slop) que bloqueiam imediatamente a peça. O resultado final é um veredito — APROVADO, POLIR ou REFORMULAR — com uma tabela detalhada de correções "Antes | Depois | Porquê" que fornece valores exatos de tempo, quadros e seletor, instruções para re-revisão e um formato de saída (`review.md`) estruturado para automação. É ideal para revisão de controle de qualidade de produção e pode ser integrado em pipelines de CI/CD para motion graphics.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Parrass/mograf-public/tree/HEAD/plugins/mograf/skills/motion-review

Perguntar na sua IA favorita

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

Documentação

O que motion-review: o portal do gosto faz?

Linters pegam código quebrado. Este skill pega gosto. Postura padrão: sinalize primeiro; a aprovação é conquistada. Uma peça que "parece boa" pontua 3, e 3 não é entregue.

Como executar

  • Execute como um subagente limpo quando possível. Dê a ele: este arquivo, a pasta do projeto e o briefing. Não diga o quão difícil foi a construção.
  • O revisor nunca edita a composição. Ele escreve review.md na pasta do projeto e retorna o veredito.
  • Olhe para os pixels, não apenas para o código. Cada pontuação deve apontar para um timestamp, quadro ou seletor.
  • Um revisor por peça. Dois revisores executando ao mesmo tempo escrevem o mesmo review.md e seus vereditos entram em conflito. Cada rodada termina com uma linha verdict:; o chamador consulta review.md por ela. Re-revisões vão para o mesmo revisor; inicie um substituto apenas se review.md não mostrar uma nova rodada após uma longa espera, anote o cancelamento em review.md, e faça o substituto ler o histórico primeiro. Se as rodadas entrarem em conflito, a última escrita em review.md é autoritativa.

Procedimento

Execute cada etapa. Comandos assumem um projeto HyperFrames (npx hyperframes …); para outras pilhas use o equivalente (Remotion: npx remotion still para quadros, npx remotion render para a tira).

  1. Estrutura. npx hyperframes check . Qualquer erro é um Bloqueio. Leia também os avisos. Sua auditoria de contraste é o portal de contraste. Texto decorativo nunca destinado a ser lido (fantasmas borrados, clones de rastro fantasma, lascas se dissolvendo, preenchimento de embaralhamento) é excluído com data-layout-ignore em cada nó; nunca o use para ocultar cópia real.

  2. Mapa de movimento. Leia o código da linha do tempo (ou o mapa de animação, se seus skills HyperFrames incluirem animation-map.mjs). Anote:

    • zonas mortas de 1 s ou mais sem nada se movendo;
    • movimentos espaciais mais curtos que 0.2 s (rápido demais para ler) ou mais longos que 2 s (à deriva);
    • escalonamentos irregulares ou mecânicos;
    • elementos que saem do quadro ou colidem acidentalmente.

    Movimento conduzido por um objeto proxy/setter (câmera personalizada, three.js, contadores) é invisível para mapas baseados em tweens; use tiras de quadros (etapa 5) para esses movimentos.

  3. Folha de contato. Do storyboard ou lista de batidas, anote os tempos das cenas e costuras. Instantâneo:

    • quadro 0, o momento herói e o quadro final;
    • 25 / 50 / 75 % de cada cena;
    • cada costura em −2 quadros, 0 e +2 quadros.

    npx hyperframes snapshot --at <t1,t2,…>. Passe tempos de quadro exatos (t = frame / fps, por exemplo, quadro 316 a 30 fps → 10.5333); --at não captura instantâneos, então um tempo arredondado mostra uma pose intermediária que o render nunca contém. snapshot deixa imagens PNG obsoletas de execuções anteriores, então mova o diretório antigo snapshots/ para o lado antes de cada execução (por exemplo, node -e "require('fs').renameSync('snapshots','snapshots-'+Date.now())") em vez de deletar com um glob rm; --at também pode adicionar um quadro extra que você não pediu, então ignore os extras. Abra as imagens e olhe. Aplique zoom no tipo apenas em momentos em que o elemento está visível (aplicar zoom em um elemento oculto pode travar).

  4. Prova de profundidade. Para câmera ou movimentos de herói, npx hyperframes keyframes --ghost --angle. Planos se separando ao longo de z significam profundidade real; tudo se escalando junto significa profundidade falsa. Espaçamento uniforme de fantasmas em um movimento de herói significa easing linear, o que falha. Se --ghost não puder ser executado, faça uma cópia de rascunho e dê ao pai do mundo uma câmera de prova (empurre para trás + inclinação + guinada, por exemplo translateZ(-900px) rotateX(-28deg) rotateY(64deg); apenas guinada coloca a câmera dentro de cenas profundas), tire instantâneos de 4 a 6 tempos de quadro ao longo do movimento e sobreponha-os (ffmpeg … -filter_complex blend=all_mode=lighten). Construa esta cebola manualmente para perspectiva aninhada (snapshot --angle side achata) e para câmeras de projeção JS (3D projetado em um SVG/canvas): troque uma câmera lateral na função de projeção na cópia de rascunho.

  5. Assistir em tempo real. Se um render existir:

    • faça uma tira: ffmpeg -i renders/video.mp4 -vf fps=6,scale=360:-1,tile=6x4 strip.jpg;
    • verifique a duração e o primeiro e último quadros com ffprobe;
    • se houver áudio, verifique cada batida contra a planilha de referência (±1 quadro) e pico verdadeiro ≤ −1 dBTP no arquivo AAC final (ffmpeg -i … -af ebur128=peak=true -f null -);
    • overlays .webm transparentes: ffprobe mostra VP9-alpha como yuv420p; verifique alfa decodificando com -c:v libvpx-vp9 antes de -i (o stream lê yuva420p) ou a tag ALPHA_MODE=1.
  6. Leitura de código. Grep na composição por:

    • ease: (liste cada ease usado) e durações;
    • entradas apenas com opacidade e pequenos deslocamentos y: (20–40 px);
    • Math.random / Date.now (não determinístico);
    • back.out|elastic|bounce, yoyo, repeat: -1;
    • linear ou power1 em movimentos espaciais; eases fora da lista permitida (mg.*, power3.out, expo.out, power3.in, power4.out, power2.inOut, none, uma mola cozida);
    • tweens concorrentes compartilhando um ease (ok apenas como um grupo travado: um tween multi-alvo ou uma linha do tempo filha com defaults; um proxy orientado por setter conta uma vez, pelo ease em seu tween);
    • uma subida de máscara de linha borrada começando abaixo de yPercent 130 (o borrão vaza para a máscara);
    • fontes proibidas;
    • granulação, vinheta ou desfoque de movimento ausentes.
  7. Pontue as 9 dimensões (âncoras abaixo), 1–5, cada uma com uma razão de uma linha vinculada a um tempo ou quadro.

  8. Barra de artesanato (12 itens, passa/falha; tabela abaixo).

  9. Escaneamento anti-slop (lista dos 15 principais abaixo). Registre os IDs.

  10. Licenças. Cada ativo não original (fonte, SFX, música, imagem, código de terceiros) tem uma fonte e uma licença compatível por escrito. Fontes: OFL ou similar. Código: MIT ou Apache com cabeçalhos mantidos. Qualquer coisa desconhecida: sinalize.

Âncoras da rubrica (pontuação 1–5)

Dimensão135
ConceitoNenhuma ideia; texto sobre fundos; qualquer marca poderia ser trocadaIdeia clara em uma frase; o movimento a apoia em algumas cenasUma ideia forte do início ao fim com um momento surpreendente e próprio que você pode descrever em uma frase
ComposiçãoTudo centralizado, tamanhos uniformes, bagunça ou vazio sem intençãoGrade, um herói por quadro, espaço negativo decenteCada still é de nível de pôster: cortes deliberados, camadas de profundidade, espaço negativo; layouts evoluem
TipografiaFonte de sistema ou genérica, tracking padrão, blocos inteiros desbotandoUnidade de divisão correta (linha/palavra/caractere), revelações mascaradas, legívelTipo é a animação: eixos variáveis, layout cinético, brincadeira de corte/escala, ritmo impecável
Temporização e easingEases lineares ou padrão, durações uniformes, sem pausasEases personalizados em movimentos de herói, durações variam, pausas legíveisVelocidade assimétrica, overshoot de bom gosto, pausas que parecem inevitáveis quadro a quadro
CoreografiaTudo se move junto ou em um escalonamento uniformeHerói lidera, apoios seguem com deslocamentos, sobreposição presenteConduzida: um gesto flui para o próximo, movimento secundário reage ao primário
TransiçõesCrossfades ou cortes não relacionadosMáscaras/wipes projetados, no ritmoUma câmera/ideia contínua; memorável, nunca gratuita
Profundidade e texturaVetores planos em um fundo plano ou gradiente blob, quadro estáticoDeriva/empurrão de câmera, 2+ planos de profundidade, alguma granulação ou luz3D real ou 2.5D convincente, iluminação conta a história, textura unifica sem se exibir
Sincronização de somSilencioso ou áudio não relacionadoCortes principais caem nos ritmosImagem e som compostos juntos; silêncio usado como acento; mixagem limpa
AcabamentoBugs, tremulação, estalos, aliasing, ativos não carregadosLimpo, consistente, quadro final projetadoEntregável de estúdio; cada quadro escrutinado; quadro final mantido e resolvido

Pontuações 2 e 4 ficam entre as âncoras. Para pontuar 4:

  • Temporização: paleta de eases por função, "saída rápida, assentamento longo" chegadas, aceleração de saídas.
  • Coreografia: antecipação, acompanhamento e escalonamentos suavizados ou baseados em distância.
  • Transições: pelo menos um match cut ou morph, e cortes na velocidade máxima com desfoque.
  • Profundidade: paralaxe de 3 planos e desfoque de movimento em movimentos rápidos.
  • Composição: contraste de escala de pelo menos 5×.

Uma peça silenciosa, sem SFX, que se declara silenciosa no briefing pontua Sincronização de som em seus silêncios e ritmo visual; não puna uma escolha deliberada.

Portões rígidos (qualquer um = Bloqueio)

  • check falha, o render é não determinístico, ou uma busca mostra um glitch.
  • Texto que você não pode ler:
    • pausa menor que 0.5 s + 0.3 s por palavra;
    • contraste abaixo de 4.5:1;
    • texto cruzando a área segura.
  • Flash de fonte, ativo ausente, quadro quebrado ou vazio em uma costura, ou um pop no primeiro ou último quadro.
  • 3 ou mais hits anti-slop sem uma justificativa por escrito.
  • Ease linear ou padrão em um movimento espacial de herói.
  • Um item da barra de artesanato ausente sem uma renúncia por escrito no briefing.
  • Mais de 3 flashes por segundo.
  • Um ativo de terceiros sem fonte ou licença registrada.

Barra de artesanato (12 itens)

  1. Conceito. Uma ideia em uma frase e um momento de assinatura em ~40% do tempo de execução.
  2. Still herói. Um quadro herói projetado (Composição ≥ 4, pelo menos 3 camadas de profundidade).
  3. Câmera. Pelo menos um movimento real de câmera ou profundidade, comprovado pela verificação fantasma ou de ângulo lateral.
  4. Eases personalizados. Pelo menos 3 caracteres de ease distintos, e nenhum dois tweens concorrentes compartilhando um por acidente.
  5. Sem fade-up padrão. Nenhum opacidade 0→1 + y 20–40→0 em qualquer lugar.
  6. Costuras nomeadas. Costuras são nomeadas e combinadas em velocidade; no máximo um crossfade simples.
  7. Desfoque de movimento em 1–3 batidas rápidas (nunca em texto enquanto está sendo lido).
  8. Passada de textura. Granulação, vinheta e gradientes radiais (motivados pela luz).
  9. Evento de luz. Pelo menos um: um sweep, brilho, banda de varredura, bloom ou vazamento.
  10. Som. Sincronização de som se houver áudio; caso contrário, a peça é declarada silenciosa.
  11. Ritmo.
    • A batida do storyboard mais lenta é pelo menos 3× a mais rápida (batidas são linhas do storyboard, não sub-tweens).
    • Em todos os tweens, duração máxima/mínima é pelo menos 4.
    • O still final segura por pelo menos 0.8 s.
    • O último quadro funciona como uma miniatura.
  12. Barra da rubrica atendida (veja Barra de envio).

Anti-slop top 15

idSinalCorreção
S1Cada elemento aparece e desliza para cima 20–40 pxEntrada por função: máscaras/divisões para texto, escala-do-ponto para formas, carregado pela câmera para cenas
S2Durações idênticas (tudo 0.5 s / 1 s)Duração a partir da distância e massa; chegadas de herói 0.8–1.5 s, saídas ~30% mais rápidas
S3Ease padrão (power1, CSS ease, ease-in-out) ou linear em movimentos espaciaisEases personalizados nomeados; assimétrico "saída rápida, assentamento longo"
S4Escalonamento uniforme de 0.1 sEscalonamento suavizado a partir de uma origem significativa (centro, ponto focal, ordem de leitura)
S5Tudo se move ao mesmo tempo, mesma velocidadeUm líder; apoios seguem 2–8 quadros depois com menos amplitude
S6Sem pausas: entra, depois sai diretoPausa de leitura ≥ 0.5 s + 0.3 s/palavra
S7Paradas mortas: chega e congelaAssentamento longo, micro deriva durante a pausa
S8Elástico/back/bounce em tudoNo máximo um overshoot por peça, ≤ 6%, apenas em transformações
S9Pulsações "respiratórias" ociosas (yoyo de escala/opacidade)Imobilidade, ou um ambiente motivado, ou uma deriva de câmera com uma pose final
S10Movimentos rápidos sem desfoque de movimentoDesfoque de obturador ou direcional nas 1–3 batidas mais rápidas
S11Pilha centralizada: título / subtítulo / botãoGrade assimétrica, tipo ancorado na borda, 30–50% de espaço negativo
S12Quadro estático, sem câmeraEmpurrão, deriva, planos de paralaxe, close-ups nos ritmos
S13"Slides": cena desaparece, próxima apareceCosturas motivadas: match cut, momentum, máscara, morph
S14Bolhas roxo-azul / rosa-laranja, glassmorphism, neon em tudoGradientes que se comportam como luz de uma fonte; 2–3 matizes + neutros, acento ≤ 10%
S15Inter/Roboto/Poppins regular como "o design"; emoji ou ícones de estoqueFace display expressiva, tracking apertado, contraste de peso; marcas personalizadas ou nenhuma

Também observe:

  • máquina de escrever + cursor como a ideia toda;
  • números de contagem genéricos;
  • cópia Lorem-like ("desbloqueie o futuro de…");
  • um final que apenas para ou desaparece;
  • uma curva de energia plana sem clímax;
  • movimento que caberia em qualquer mensagem.

Barra de envio

  • APROVADO: média ≥ 4.0, nenhuma dimensão abaixo de 3, zero portões rígidos.
  • POLIR: média 3.5–3.9, ou uma dimensão em 3. Lista de correções, depois re-revisão.
  • REFORMULAR: média abaixo de 3.5. Volte ao conceito e styleframes; polir não vai salvar.

Formato review.md

piece: <nome> · reviewed: <data> · render: <caminho ou nenhum>
conceito: N — …            composição: N — …        tipografia: N — …
temporização_easing: N — …      coreografia: N — …       transições: N — …
profundidade_textura: N — …      sincronização_som: N — …         acabamento: N — …
média: N.N
portões_rígidos: [ … ]
barra_artesanato: [1 ✓, 2 ✗ (motivo), …]
hits_anti_slop: [S1, S7, …]
veredito: APROVADO | POLIR | REFORMULAR   → rota de correções para: conceito | composição | construção de movimento
folha_contato: <caminho>

Em seguida, uma tabela Antes | Depois | Porquê. Ordene por alavancagem (impacto ÷ esforço), e faça cada "Depois" um valor exato:

#Onde (t / quadro / seletor)AntesDepoisPorquê
13.40–3.90 s #titleopacidade + y 30, power2.out 0.5 sdividir em linhas, revelar máscara, ease de assentamento cubic-bezier(0,.65,.51,.99) 0.9 s, linhas +4 quadrosfade-up padrão (S1); sem assentamento (S7)

Ordem de correção: deletar → reduzir → corrigir easing → corrigir composição/origem → retemporizar → adicionar profundidade/desfoque/textura → polir. Nunca escreva "tornar mais dinâmico"; sempre dê uma receita com números.

Re-revisão

Re-revisões vão de volta ao mesmo revisor. Após correções, re-exeute a etapa 1, etapa 3 (regiões alteradas e suas costuras) e etapa 7. Qualquer retemporização re-executa check: suas amostras de contraste se movem com a temporização. Mantenha as pontuações antigas em review.md para que a melhoria seja visível, e termine cada rodada com sua própria linha verdict:. Pare após 3 loops de polimento; se a média ainda estiver abaixo de 4.0, retorne REFORMULAR.


Parte dos skills gratuitos mograf (MIT). Para o pipeline completo do estúdio, veja mograf.si. Cada peça na biblioteca vem com seu prompt, skills, fonte e cópia.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas