Explicador de Papel Recortado
Um vídeo explicativo vertical de ~20-45 s que parece papel de construção em camadas ganhando vida: adereços de papel granulados com sombras projetadas, animação rígida de recorte, um movimento lento de câmera com trepidação de papel em stop-motion, um banner de manchete com fita adesiva por batida e etiquetas de legenda de papel rasgado palavra por palavra. Construído com Remotion, ativos texturizados opcionais gerados por IA e qualquer TTS.
Cada batida executa três trilhas:
- a narração conta a história
- o banner com fita adiciona um fato concreto que a narração pula
- um novo conjunto de papel ilustra as palavras da narração, com uma reconstrução em papel recortado da interface do produto fazendo a demonstração
Reutilize o estilo e a narrativa, não o conteúdo dos exemplos trabalhados. Cada produto, empresa e número nos exemplos é inventado. As regras de estilo estão em $MOTION_LIB/style/$MOTION_STYLE/docs/style-guide.md (a seção 2 é o DNA do Estilo).
Pré-voo
- Biblioteca. Resolva
$MOTION_LIB, senão a linhaMOTION_LIB=em${XDG_CONFIG_HOME:-~/.config}/motion-explainer/config.env, senão pergunte uma vez. Nunca codifique um caminho de máquina. Os estágios 1 a 4 não precisam de biblioteca. - Modo de instalação. Verifique antes de prometer um estágio (veja Modos de instalação abaixo).
- Série. Encontre a pasta da série (ela contém
episodes/). Leia oSERIES.mdse existir.
Modos de execução (pergunte primeiro)
- Vídeo completo, da ideia ao mp4: estágios 1 a 8, depois estágio 9 após a postagem.
- Apenas roteiro: estratégia, gancho, roteiro (pare após a tabela de encenação).
- Storyboard a partir de um roteiro existente:
motion-storyboard. Peça o roteiro, os fatos e o bloco HOOK. - Prompt de estilo para outra ferramenta: forneça o bloco correto de
$MOTION_LIB/style/$MOTION_STYLE/docs/style-prompt.mde pare. - Corrigir ou reconstruir uma cena:
motion-build(etapa de cenas), depoismotion-qa.
Captação (pergunte apenas o que está faltando)
- Fonte: geralmente um link (repositório, site de produto, anúncio). Todo o resto é pesquisado a partir dele.
- A única afirmação que o vídeo prova, e o tópico.
- Enquadramento de papéis: quem ou o que faz o trabalho, quem aconselha ou aprova. Confirme com o usuário e nunca invente comportamento do produto.
- Palavra-chave CTA e o que o espectador ganha (a entrega).
- Duração: padrão 22-30 s.
- Nível do público (de
SERIES.md) e qualquer cor de destaque ou mascote.
Escreva as respostas como o bloco BRIEF no topo de episodes/NN-slug/research/facts.md (formato em motion-strategy).
Estágios
| # | Estágio | Skill | Lê | Escreve |
|---|---|---|---|---|
| 1 | Estratégia | motion-strategy | SERIES.md, a fonte | BRIEF em research/facts.md, SERIES.md |
| 2 | Gancho | motion-hook | BRIEF | Bloco HOOK no topo de video/STORYBOARD.md |
| 3 | Roteiro | motion-script | BRIEF, HOOK | research/facts.md, narration/script.json, tabela de encenação em STORYBOARD.md |
| 4 | Storyboard | motion-storyboard | script.json, STORYBOARD.md | Tabela Câmera/Corte, blocos de cena, plano de SFX em STORYBOARD.md |
| 5 | Estrutura e plano | motion-build | STORYBOARD.md | o projeto, episode.json |
| 6 | Voz e tempo | motion-voice | script.json, voice/voice.json | narration/ takes, public/vo/captions.json, src/plan.json |
| 7 | Cenas, som, renderização | motion-build | plan.json, STORYBOARD.md | src/scenes/*, tools/cues.json, out/*.mp4 |
| 8 | QA | motion-qa | stills, STORYBOARD.md | correções, o resumo de entrega |
| 9 | Pós-publicação | motion-strategy (autópsia), motion-build (colheita) | números da plataforma, o projeto | research/analytics/, promoções da biblioteca |
Arquivos do projeto
O pipeline vive em arquivos, não no chat. Cada estágio lê os arquivos acima e escreve os seus próprios, para que uma nova sessão possa retomar de qualquer estágio.
<serie>/
SERIES.md opcional: público, voz, paleta, mascote, registro de palavras-chave
voice/voice.json opcional: configurações de voz (copie library/voice/voice.example.json)
video-assets/ opcional: texturas e adereços de sobreposição
research/analytics/ opcional: estudos de concorrência e autópsias
episodes/NN-slug/
research/facts.md BRIEF + fatos com fontes
narration/script.json [{"id": "l1_hook", "text": "..."}, ...]
video/
episode.json cenas, banners, gancho, lacunas, fundo musical, cortes
STORYBOARD.md HOOK, tabela de encenação, tabela Câmera/Corte, blocos de cena
Catálogos da biblioteca: style/$MOTION_STYLE/remotion/CATALOG.md (cada componente do kit) e $MOTION_LIB/core/audio/CATALOG.md (cada SFX e fundo musical). Eles são gerados, então um checkout novo pode não tê-los ou tê-los desatualizados. Execute python3 $MOTION_LIB/core/tools/catalog.py para reconstruir. Agentes leem os catálogos, não o código-fonte do kit.
Reutilize antes de escrever: um componente do kit, um conjunto de adereços ou um modelo de cena é melhor que um novo código de desenho. Escolha SFX e fundos musicais pelo nome.
Modos de instalação
- Mínimo (apenas skills): estratégia, gancho, roteiro, storyboard, prompts de estilo. Sem renderização.
- Padrão: Mínimo + construção e renderização com uma voz substituta (silenciosa, ou
saydo macOS) via$MOTION_LIB/core/tools/placeholder_vo.py, QA de stills, áudio SFX e fundo musical, o mp4 completo. - Completo: Padrão + narração Qwen3-TTS local e legendas sincronizadas a partir de áudio real.
Verifique (somente leitura):
. "$(grep '^MOTION_LIB=' "${XDG_CONFIG_HOME:-$HOME/.config}/motion-explainer/config.env" | cut -d= -f2-)/env.sh" # preenche MOTION_PY, QWEN_TTS_PY
node -v; ffmpeg -version | head -1
"$MOTION_PY" -c 'import numpy, PIL, soundfile'
"$QWEN_TTS_PY" -c 'import qwen_tts'
As três primeiras linhas passando significam Padrão. A importação qwen_tts passando também significa Completo. Se um estágio precisar de mais do que a instalação fornece, diga em uma linha, execute ./install.sh --doctor a partir da raiz do repositório e passe para motion-setup em vez de improvisar. Encontre a raiz com readlink na pasta da skill instalada (sob .claude/skills, .agents/skills, .config/opencode/skills ou outra pasta de skills de um harness), ou MOTION_HOME no arquivo de configuração.
Regras entre estágios
- Anotações de estratégia vencem anotações de estilo: 22-30 s e sem ganchos com moldura de notícias.
- Paralelize trabalhos independentes (grupos de cena, fundos e adereços, re-renderizações) com agentes de uma só vez.
- Renderize apenas quando solicitado. Visualize no Remotion Studio.
Referências compartilhadas
$MOTION_LIB/style/$MOTION_STYLE/docs/style-guide.md: DNA do estilo, desenho em papercut, paleta, fontes, textura, câmera e trepidação, temporizações de movimento, legendas, som.$MOTION_LIB/style/$MOTION_STYLE/docs/style-prompt.md: prompts portáteis para outros agentes e geradores.$MOTION_LIB/style/$MOTION_STYLE/docs/motion-principles.md: os 12 princípios da animação mapeados para componentes e ajudantes do kit, com uma nota de uso em cada estágio.$MOTION_LIB/style/$MOTION_STYLE/remotion/RECIPES.md: esboços de componentes Remotion, para quando não há biblioteca.$MOTION_LIB/style/$MOTION_STYLE/docs/asset-prompts.md: o que gerar versus construir em código, com modelos de prompt.$MOTION_LIB/style/$MOTION_STYLE/docs/frame-breakdown.md: um exemplo trabalhado de ~28 s com resolução de 0,2 s. Copie sua densidade de eventos, não seu conteúdo.
Passagem
Comece no estágio 1 para um vídeo completo, ou no estágio que o modo de execução nomeia. Após a captação, execute motion-strategy; ele lê SERIES.md e o BRIEF e passa para motion-hook. Cada skill de estágio nomeia a próxima.