Communitygithub.com

explicador-de-papel-recortado

Crie um vídeo explicativo curto (9:16) no estilo papercut reel, do conceito ao mp4, a partir de um link ou ideia. Também roteia solicitações parciais para as habilidades de estágio e fornece o prompt de estilo para outras ferramentas.

O que é explicador-de-papel-recortado?

O motion-explainer é uma habilidade (skill) de IA especializada em criar vídeos explicativos verticais (9:16) de 20 a 45 segundos, com um visual único de papel recortado e animado (papercut). A partir de um link (repositório, página de produto, anúncio) ou de uma simples ideia, ele gerencia todo o pipeline: estratégia, roteiro, storyboard, locução, renderização e pós-publicação. A habilidade organiza o trabalho em 9 estágios bem definidos, cada um implementado por uma skill dedicada (motion-strategy, motion-hook, motion-script, etc.), e utiliza arquivos locais para garantir retomabilidade total. É compatível com Remotion para renderização e oferece três modos de instalação (Mínimo, Padrão, Completo), permitindo desde apenas a produção de roteiros até a geração completa de vídeo com locução via IA (Qwen3-TTS). O resultado é um estilo visual rico em texturas de papel, sombras, animações rígidas de recorte e legendas palavra por palavra, ideal para demonstrações de produtos e anúncios em redes sociais.

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

Perguntar na sua IA favorita

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

Documentação

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 linha MOTION_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 o SERIES.md se existir.

Modos de execução (pergunte primeiro)

  1. Vídeo completo, da ideia ao mp4: estágios 1 a 8, depois estágio 9 após a postagem.
  2. Apenas roteiro: estratégia, gancho, roteiro (pare após a tabela de encenação).
  3. Storyboard a partir de um roteiro existente: motion-storyboard. Peça o roteiro, os fatos e o bloco HOOK.
  4. Prompt de estilo para outra ferramenta: forneça o bloco correto de $MOTION_LIB/style/$MOTION_STYLE/docs/style-prompt.md e pare.
  5. Corrigir ou reconstruir uma cena: motion-build (etapa de cenas), depois motion-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ágioSkillLêEscreve
1Estratégiamotion-strategySERIES.md, a fonteBRIEF em research/facts.md, SERIES.md
2Ganchomotion-hookBRIEFBloco HOOK no topo de video/STORYBOARD.md
3Roteiromotion-scriptBRIEF, HOOKresearch/facts.md, narration/script.json, tabela de encenação em STORYBOARD.md
4Storyboardmotion-storyboardscript.json, STORYBOARD.mdTabela Câmera/Corte, blocos de cena, plano de SFX em STORYBOARD.md
5Estrutura e planomotion-buildSTORYBOARD.mdo projeto, episode.json
6Voz e tempomotion-voicescript.json, voice/voice.jsonnarration/ takes, public/vo/captions.json, src/plan.json
7Cenas, som, renderizaçãomotion-buildplan.json, STORYBOARD.mdsrc/scenes/*, tools/cues.json, out/*.mp4
8QAmotion-qastills, STORYBOARD.mdcorreções, o resumo de entrega
9Pós-publicaçãomotion-strategy (autópsia), motion-build (colheita)números da plataforma, o projetoresearch/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 say do 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.

Individual skills in this repo

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

Habilidades Relacionadas