Communitygithub.com

blixvip/skills

O runbook completo para transformar filmagens brutas e um roteiro em uma edição finalizada e sem erros — ordem das etapas, verificações de qualidade, estrutura de artefatos em disco, escolha do motor, construção paralela de cenas e a lista de verificação para envio.

O que é skills?

Esta skill orquestra todo o pipeline de edição de vídeo, desde a ingestão de mídia bruta até a exportação final. Ela define sete etapas obrigatórias (Intake, Transcrever, Planejar, Ativos, Projetar, Animar, Integrar), cada uma com uma verificação de qualidade (gate) que deve ser aprovada antes de avançar. O objetivo é evitar os artefatos comuns de edições geradas por IA, como paletas inventadas, fontes inconsistentes ou animações descoordenadas — tudo é decidido e registrado em disco para garantir consistência entre as cenas. A skill suporta múltiplas engines (Remotion, HyperFrames, Manim, After Effects, Blender, etc.) e incentiva a mistura delas, desde que a paleta de cores e o estilo visual permaneçam uniformes. Ideal para uso com agentes de IA como Claude Code, Cursor ou Codex, que podem executar as etapas em paralelo após a aprovação do 'piloto' (primeira cena).

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

Perguntar na sua IA favorita

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

Documentação

motion-pipeline

Você é o orquestrador, não o animador. Seu trabalho é executar as etapas em ordem, recusar-se a avançar através de uma verificação com falha e manter cada cena consistente com todas as outras.

A única causa de edições com aparência de IA é pular etapas. Uma animação brilhante em um compasso não planejado, em uma paleta inventada, com um ativo de estoque que ninguém reequalizou, é porcaria. Ordem supera esforço.

Inegociáveis

  1. Nunca faça um vídeo completo de uma só vez. Construa a cena 1 com qualidade de envio, obtenha aprovação, então processe as demais em lote em relação a ela. Um estilo rejeitado após 26 cenas resulta em 26 regravações.
  2. Nunca avance através de uma verificação vermelha. Informe qual verificação falhou e o que está faltando.
  3. Nunca invente uma paleta, uma fonte ou um ativo quando as filmagens, o kit de marca ou a pasta de referência puderem fornecê-los.
  4. Nunca decore cada linha. A densidade é limitada na etapa 2 e aplicada no envio.
  5. Cada decisão é gravada no disco, não mantida no contexto. O próximo agente, a próxima sessão e o usuário leem os mesmos arquivos.

Mapa de etapas

#EtapaSkill / ferramentaVerificação a passar
0Intakeesta skillG0 Brief completo
1Transcreverwhisper / hyperframes transcribe / painel de texto do PremiereG1 Existem temporizações no nível da palavra
2Planejarmotion-planG2 Todo compasso classificado, densidade abaixo do limite
3Ativosmotion-assetsG3 Paleta amostrada, tokens escritos, zero placeholders
4Projetarmotion-designG4 Verificação anti-porcaria no quadro piloto
5Animarmotion-animateG5 Verificação de movimento na cena piloto
6Lotesubagentes paralelosG6 Cada cena corresponde ao piloto
7IntegrarPremiere / linha do tempo mestraG7 Lista de verificação de envio (Apêndice A)

Etapa 0 — Intake

Colete antes de tocar em qualquer coisa. Pergunte apenas o que está genuinamente faltando; infira o resto e declare a inferência. Modelos — para um briefing completo, para o que usar como padrão quando um é vago, e para a mensagem que você envia a um subagente na etapa 6 — estão no Apêndice B.

  • Filmagens caminho, resolução, fps e se já estão cortadas.
  • Roteiro ou transcrição e se existem temporizações.
  • Proporção — 16:9, 9:16, 1:1. Isso altera a composição, não apenas o corte.
  • Duração alvo e prazo final.
  • Kit de marca — arquivos de logotipo, fontes, códigos hexadecimais, vídeos anteriores para correspondência. Se não existir, diga e derive das filmagens na etapa 3.
  • Links de referência — a entrada única de maior alavancagem. Três referências superam três parágrafos de descrição. Peça-as pelo nome: "envie 2-3 vídeos ou capturas de tela cujo visual você deseja".
  • Restrição de motor — o entregável precisa ser finalizado no Premiere/After Effects, ou uma renderização independente é suficiente?

Escreva edit/BRIEF.md. Se as referências estiverem ausentes, sinalize: nenhuma referência fornecida, então o estilo é derivado das filmagens e permanece um palpite até que o usuário reaja à cena 1.

Estrutura de artefatos

Crie isso antes da etapa 1. Tudo a jusante lê e escreve aqui; nada importante vive apenas em um chat.

edit/
  BRIEF.md            intake + inferências + restrições
  NOTES.md            registro contínuo: cada correção do usuário, na íntegra
  00-source/          filmagens a-roll brutas, música, sfx, kit de marca
  01-transcript/      words.json (nível de palavra), transcript.md
  02-plan/            plan.md  + plan.json (linhas de cena legíveis por máquina)
  03-assets/
    brand/            logo.svg, fonts/, brand.json
    refs/             as referências de estilo, nomeadas pelo que ensinam
    gen/              imagens estáticas/vídeo gerados por IA, com prompt.txt ao lado
    3d/               glb/obj + as passagens de renderização
    lottie/           .json / .lottie
    sfx/              whooshes, impactos, ticks de ui
  04-design/
    tokens.css        a paleta + escala tipográfica — a fonte única da verdade
    palette.json      legível por máquina, para geradores
    pilot/            o quadro aprovado da cena 1
  05-scenes/          uma pasta por cena: 03-stat-card/, 07-map/, ...
  06-renders/         mp4 (opaco) / mov prores4444 (alfa) por cena
  07-master/          arquivo de projeto + exportação final

tokens.css é a lei. Cada cena o importa. Uma cena que codifica uma cor é um bug, porque se distanciará das outras — a deriva de paleta entre cenas é o sinal estrutural de porcaria mais alto.

Etapa 1 — Transcrever

Nível de palavra ou não conta. Temporizações no nível da frase produzem visuais de duração uniforme, que parecem automatizados.

  • Local: whisper (large-v3 para final, base para uma passagem de rascunho) ou npx hyperframes transcribe.
  • Já no Premiere: a transcrição do painel de Texto exporta com temporizações.
  • Já no YouTube: extraia a faixa de legenda.

Saída 01-transcript/words.json com registros {word, start, end}.

G1 — falha se você tiver apenas temporizações de frase. Corrija antes de planejar; não estime.

Etapa 2 — Planejar

Invoque motion-plan. Ele classifica cada compasso como VISUAL ou DESCANSO e escreve o que cada visual deve mostrar.

Adicione o limite de densidade do pipeline sobre ele:

Duração do vídeoMáx. parcela VISUALNúmero típico de cenas
abaixo de 60s (curto)65%8-14
3-8 min40%15-30
8-20 min30%25-50
20 min+22%40-80

Também emita plan.json — uma linha por cena: {id, start, end, dur, text, must_show, archetype, engine, assets[]}. A etapa 6 se distribui por essas linhas, portanto cada linha deve ser independente da conversa ao redor.

G2 — falha se algum compasso não estiver classificado, se a densidade exceder o limite, ou se duas cenas adjacentes usarem o mesmo arquétipo (monotonia parece modelo).

Etapa 3 — Ativos

Invoque motion-assets. Duas saídas importam:

  1. 04-design/tokens.css — paleta amostrada das filmagens, nunca inventada.
  2. Cada entrada assets[] em plan.json resolvida para um arquivo real no disco.

G3 — falha em qualquer placeholder, qualquer lorem, qualquer "TODO: encontrar ícone", qualquer ativo de estoque ainda não reequalizado na paleta.

Etapa 4 — Projetar o piloto

Escolha a cena que é mais representativa, não a primeira. Geralmente um cartão de estatística ou conceito no meio do vídeo. Construa um quadro, com qualidade de envio, usando motion-design.

Execute a lista de verificação anti-porcaria do motion-design. Três ou mais falhas significam redesenho, não remendo.

Em seguida, mostre ao usuário e pare. Um quadro, uma pergunta: este é o visual — algo a mudar antes de eu construir as outras N cenas nele?

G4 — falha sem uma aprovação explícita, ou uma correção registrada em NOTES.md.

Etapa 5 — Animar o piloto

Invoque motion-animate no quadro aprovado. Renderize-o. Assista-o contra o áudio real, não isoladamente.

G5 — falha se alguma das quatro leis for quebrada: easing linear em qualquer lugar, entradas simultâneas, câmera totalmente estática por mais de ~2s, ou durações metronômicas.

Etapa 6 — Processar em lote as cenas restantes

Agora, e só agora, paralelize.

Distribua um subagente por cena (ou por grupo de 3-4 cenas semelhantes). Cada agente recebe, e apenas recebe:

  • Sua linha de plan.json.
  • 04-design/tokens.css — somente leitura.
  • O caminho para a cena piloto aprovada, como o padrão a imitar.
  • O motor para esta cena (veja tabela abaixo).
  • As listas de verificação anti-porcaria e de movimento.

Cada agente retorna um arquivo renderizado em 06-renders/ e uma nota de uma linha em NOTES.md. Agentes não conversam entre si e não modificam tokens.

Isole os espaços de trabalho. Agentes paralelos editando um diretório de projeto se sobrescreverão — dê a cada um uma git worktree, uma cópia, ou pelo menos uma subpasta disjunta, então reconcilie no final.

G6 — amostre quatro renderizações aleatoriamente e coloque-as lado a lado. Mesma paleta, mesmo tipo, mesma direção de sombra, mesmo grão, mesmos raios de canto? Qualquer deriva significa que o agente à deriva reconstrói contra o piloto, não contra sua própria saída.

Escolha do motor

A cena é...Construa em
Dados, gráficos, mapas, contadores, sequências programáticas longasRemotion
Mock de UI, terminal, tipo cinético, HTML+GSAP rápido, precisa de um inspetor ajustávelHyperFrames
Matemática, geometria, teoria de grafos, passo a passo de algoritmoManim
Qualquer coisa que precise ficar sobre as filmagens — rastreamento, integração de placa, roto, câmera 3D realAfter Effects (veja ae-extendscript)
Um objeto ou ambiente 3DBlender / Unreal, passagens de renderização, depois composição
B-roll fotorrealista, beleza de produto, filmagens impossíveisIA de imagem para IA de vídeo, depois reequalizar para tokens.css
Legendasadd-subtitles ou o bloco de legenda, estilizado a partir de tokens
A linha do tempo mestra, áudio, exportaçõesPremiere / DaVinci

Misturar motores é normal e bom — é um dos sinais anti-modelo mais fortes. O que nunca deve misturar é a paleta.

Etapa 7 — Integrar e enviar

Monte na linha do tempo mestra. Em seguida, execute o Apêndice A na íntegra. Ele cobre o que as verificações por cena não podem ver: ducking de áudio sob os gráficos, colisão entre legenda e terço inferior, áreas seguras, ritmo em toda a peça, e a especificação de renderização.

G7 — cada caixa marcada, ou uma lista escrita do que não está e por quê.

Fechando o ciclo

Antes de terminar, leia NOTES.md e pergunte: quais dessas correções o usuário fará novamente no próximo vídeo?

Transforme-as em uma skill de projeto — .claude/skills/<cliente>-style/SKILL.md — contendo sua paleta, fontes, preferências de ritmo, movimentos proibidos e as correções que você precisou ouvir. O próximo vídeo então começa na etapa 4, não na etapa 0.

Este é o passo de acumulação. Um agente que não anota o que foi corrigido será corrigido sobre isso para sempre.

Quando o usuário só quer uma animação

Pule para as etapas 3-5 para aquela única cena, mas ainda assim: amostre uma paleta de algo real, ainda execute ambas as listas de verificação, ainda escreva tokens.css. As verificações são baratas; reconstruir não é.


Apêndice A · Lista de verificação de envio (G7)

Execute na montagem mestra, não em cenas individuais. As verificações por cena já passaram; isso captura o que só aparece quando tudo está junto.

Assista a coisa toda duas vezes: uma vez sem som, uma vez no volume máximo com os gráficos ocultos. Problemas se escondem na mistura dos dois.

1. Consistência entre cenas

  • Cada cena extrai cor de tokens.css. grep nas pastas de cena por valores hex brutos que não estão no arquivo de token — qualquer ocorrência é deriva.
  • A direção da sombra é idêntica em cada cena.
  • A passagem de grão/textura existe em cada cena na mesma intensidade.
  • Raios de canto, espessuras de traço e intensidade de brilho correspondem.
  • Tipo: as mesmas duas famílias em toda parte, mesmas regras de tracking, mesmas regras de caixa.
  • Elementos recorrentes (cartões de capítulo, contadores, terços inferiores, bug de inscrição) são literalmente o mesmo componente, não refeitos por instância.
  • Logotipo aparece em escala e espaço livre consistentes.

2. Ritmo em toda a peça

  • Nenhuma cena adjacente compartilha um arquétipo.
  • As durações das cenas variam. Faça um gráfico delas — uma linha plana é um metrônomo e parece automatizada.
  • Os compassos de DESCANSO sobreviveram. Se cada linha terminou com um visual, o plano foi substituído em algum lugar; reduza.
  • Os primeiros 5 segundos carregam a maior densidade; o meio respira.
  • Nenhum gráfico sobrevive à sua linha. Um visual que permanece além do ponto que ilustra é ar morto.
  • Nada na tela é ilegível na velocidade. Leia cada supertexto em voz alta na taxa de reprodução; se você não conseguir terminá-lo, é muito longo ou muito rápido.

3. Integração com as filmagens

  • Os gráficos são equalizados à placa, não colados nela — nível de preto correspondente, aquecimento correspondente, grão correspondente.
  • Qualquer coisa destinada a ficar na cena tem sombra de contato ou oclusão.
  • Nada cobre o rosto do orador, e nada fica onde suas mãos viajam.
  • Terços inferiores e legendas nunca colidem. Decida a ordem z uma vez: gráficos acima das legendas, ou legendas acima dos gráficos — então mantenha-a.
  • O enquadramento sobrevive ao corte: exportações 9:16 mantêm o sujeito e os supertextos dentro da área visível, não apenas dentro do canvas.
  • As áreas seguras são respeitadas — nada crítico nos 5% externos, nada atrás da interface da plataforma em shorts (inferior ~15%, direito ~10%).

4. Áudio

  • A música faz ducking sob o diálogo. Keyframes gerados, não um nível estático.
  • SFX existem nos momentos que precisam deles — entradas, impactos, ticks de UI, transições — e em nenhum outro lugar. Whooshes de ponta a ponta é sua própria assinatura de porcaria.
  • SFX são mixados sob o gráfico, não sobre a voz. Se você notar o whoosh, está muito alto.
  • Cada efeito sonoro cai no quadro em que o movimento cai, não perto dele.
  • O nível de diálogo é consistente cena a cena; nenhum corte salta no tom ambiente.
  • Termina limpo: a música resolve ou desvanece, nenhum corte abrupto em uma nota sustentada.

5. A edição em si

  • Os cortes começam nas palavras, não nas inspirações.
  • Takes repetidos, reinícios e preenchimento removidos.
  • Nenhum quadro duplicado em um ponto de costura (um sinal clássico ao encadear clipes gerados última-para-primeira — corte um quadro).
  • As transições são motivadas. Uma transição que existe porque uma transição estava disponível é cortada.
  • Qualquer b-roll gerado por IA foi reequalizado na paleta e, se tiver texto visível, verificado para tipografia distorcida. Texto distorcido na tela é o artefato de vídeo gerado mais reconhecível — corte-o ou substitua a cena.

6. Especificação de renderização

  • Resolução, fps e espaço de cores corretos para o destino.
  • Cenas com alfa exportadas como ProRes 4444 / QuickTime com alfa, não assadas sobre preto.
  • Taxa de bits adequada para a plataforma; sem bandas em gradientes (adicione um toque de grão se houver).
  • Áudio na sonoridade alvo da plataforma, picos abaixo de 0 dBFS.
  • O nome do arquivo diz o que é e qual versão é.

7. A pergunta honesta

Assista mais uma vez e responda em uma frase: o que um espectador diria que entregou isso como automatizado?

Se você pode nomear algo, corrija essa coisa. Se você genuinamente não pode, envie.

Registro de falhas

Qualquer coisa que falhou aqui vai para NOTES.md com a causa, não apenas o sintoma. "A cena 12 tinha um fundo plano" é um sintoma; "o agente de lote para a cena 12 não importou tokens.css" é a causa, e é aquela que se torna uma regra na skill do projeto.


Apêndice B · Fazendo o briefing do agente (e fazendo o briefing de subagentes)

...

Individual skills in this repo

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

blixvip/skills

The motion vocabulary that separates premium animation from AI slop — text pop-blur-fade, sequential staggers, always-moving eased cameras, object entrances, and the timing/easing tables behind them. Includes ready code for Remotion (interpolate/spring) and HyperFrames (GSAP). Use when animating designed frames, when motion "feels stiff", "bouncy", "jittery", "too fast", "too uniform", or when writing any timing/easing code for video.

blixvip/skills

Source, generate, and prepare the real assets that keep a motion-graphics edit from looking generated — sampling the palette from the footage, collecting style references, pulling 3D models/Lottie/SVG/textures/SFX, generating AI stills and b-roll, and the mandatory conform pass that grades every asset into one palette. Use when a scene needs an icon, logo, 3D object, texture, background, screenshot, chart source, sound effect, or generated image/video, and whenever output "looks flat", "looks stocky", "looks AI", or assets came from different places and no longer match.

blixvip/skills

Design the actual frames for motion graphics and generated UI — palette derived from the footage, type pairing, one of five scene archetypes, and the layering order that produces depth instead of flat AI slop. Use when building scenes in Remotion, HyperFrames, After Effects, or any generated-image pipeline (Nano Banana / GPT Image / Seedream), and whenever output "looks AI-generated", "looks flat", "looks like a template", or needs to match a creator's branding.

blixvip/skills

Turn a script or timestamped transcript into a shot-by-shot motion plan — which lines earn an on-screen visual, which stay bare A-roll rest, what each visual must show, and how long it holds. Use BEFORE designing or animating anything in Remotion, HyperFrames, or After Effects. Triggers on "plan this edit", "what should be on screen", "storyboard this script", "beat map", "where do the animations go", or any request to animate a video that arrives without a shot list.

Habilidades Relacionadas