Communitygithub.com

konka0812/narrated-explainer-video

Projeta ou melhora animações explicativas com narração (科普动画) a partir de roteiro e material fornecido pelo usuário. Adequado para explicações de conhecimento, demonstrações de princípios, apresentações de produtos e comentários de opinião.

O que é narrated-explainer-video?

Este skill é especializado na criação e refinamento de vídeos explicativos animados com narração (科普动画). Ele orienta o agente de IA desde o entendimento do conteúdo do roteiro e do material visual disponível até a entrega final do vídeo. O skill cobre todo o fluxo de trabalho: definição do escopo (tema, roteiro, áudio, projeto existente), design visual (storyboard, estilo, composição), produção de animação (com suporte a Remotion, código, vetores e elementos de design), revisão e entrega. Ele enfatiza a sincronização precisa entre narração, legendas e elementos visuais, a verificação de fatos e fontes, e a adaptação do conteúdo para diferentes plataformas (como 16:9, 9:16). O skill é particularmente útil para criadores de conteúdo educacional, técnico e de opinião que desejam transformar roteiros em vídeos explicativos claros e envolventes, mantendo a fidelidade ao significado original do texto narrado e aproveitando ao máximo os materiais fornecidos pelo usuário.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/konka0812/narrated-explainer-video/tree/HEAD

Perguntar na sua IA favorita

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

Documentação

Animação Explicativa com Narração (科普动画)

Primeiro, entenda o que o usuário quer que o público entenda com a narração, depois veja o que o material disponível pode mostrar ao público. O conteúdo da narração acordado entre as partes, a versão final especificada pelo usuário e o escopo da entrega atual são a prioridade. Se uma filmagem real já explica o processo claramente, deixe-a ser reproduzida de forma contínua. Se o material mostra apenas o resultado, use-o para exibir o resultado e use diagramas para explicar o princípio. Se for realmente necessário alterar o significado da narração, discuta a frase específica separadamente.

O fluxo de trabalho abaixo, a tabela de storyboard e os exemplos de planos podem ser adaptados conforme o projeto. Ao escolher um método, mantenha três bases: a citação deve estar de acordo com o significado original, o tempo da legenda deve vir da versão selecionada e, na entrega, deve ser possível explicar claramente o que foi realmente verificado.

Começando pelo Progresso Atual

Primeiro, examine os materiais fornecidos pelo usuário, os projetos existentes e as decisões já confirmadas, depois escolha o ponto de entrada. Não peça ao usuário para refazer todo o fluxo:

  • Apenas tópico ou opinião: Organize uma questão central, público-alvo e conclusão, ajude a escrever um roteiro natural e falável. Se o conteúdo for muito extenso, sugira focar ou dividir, mas não divida em vários vídeos sem autorização.
  • Apenas roteiro: Pode-se começar com um plano visual e um storyboard aproximado. Sem áudio oficial, o tempo é apenas uma estimativa; não se pode afirmar que está sincronizado.
  • Já possui áudio e legendas: Verifique diretamente a entrada, determine a linha do tempo e projete o storyboard. Não reorganize o tempo com base no roteiro antigo.
  • Já possui projeto ou vídeo finalizado: Primeiro, localize o trecho com o feedback do usuário. Se houver um projeto editável, modifique as camadas correspondentes; se houver apenas MP4, verifique primeiro se o texto já está queimado no vídeo. Siga as práticas de modificação local para escolher os ajustes possíveis.
  • Solicitação de entrega para publicação: Verifique a entrada final e o projeto, produza o vídeo final, a miniatura ou o texto conforme necessário. Faça apenas as entregas solicitadas.

Quando faltar informação, priorize a inferência a partir de materiais e projetos. Pergunte apenas quando realmente afetar o resultado, por exemplo, quando a versão final da faixa de áudio for desconhecida. Se o usuário solicitar explicitamente a confirmação do plano, forneça um plano específico e aguarde; se já houver autorização ou confirmação, prossiga sem pedir aprovação repetidamente.

Antes de entrar na implementação do layout e da linha do tempo, esclareça proporção e cenário de publicação, base para a duração e entregas desta etapa. Projetos existentes e requisitos já confirmados têm prioridade; quando houver narração final, organize o tempo com base na duração real, não corte o áudio para se adequar a uma duração alvo. Quando faltarem requisitos claros, proponha primeiro uma configuração padrão adequada e explique as suposições; se uma escolha crítica não puder ser razoavelmente inferida e causar retrabalho significativo, confirme com o usuário. Trabalhos como discussão de tópicos e escrita de roteiro, que não dependem dessas escolhas, podem continuar.

Antes da Produção: Verificar e Preparar o Ambiente

Quando a tarefa entrar na fase de implementação do projeto ou preview, leia primeiro Verificação do Ambiente e Configuração Inicial. Se escolher Remotion, mas o ambiente local não estiver disponível, primeiro configure o ambiente de execução, inicialize o projeto, instale as dependências e verifique o preview e os frames de teste, depois produza o vídeo completo. Não presuma que o ambiente Remotion já está configurado só porque este skill foi instalado.

Distinga entre: falta de orientação do skill Remotion, falta de ambiente de execução (Node.js, etc.), falta de dependências do projeto, e falta de projeto. Projetos existentes devem ser reutilizados e instalados conforme o arquivo de lock, evitando reinicialização ou upgrades arbitrários; quando apenas roteiro ou plano visual for solicitado, não é necessário instalar software.

1. Estabelecer a Base de Conteúdo e Tempo

Registre o arquivo de entrada atual, duração do áudio, intervalo de legendas, proporção, frame rate, entrada do projeto e entrega alvo. A versão final especificada pelo usuário tem prioridade sobre o roteiro antigo e exportações antigas.

  • Mantenha o texto original das legendas, números e tempo absoluto. Verifique se há frases faltando, legendas vazias, ordem inversa, sobreposição, tempo de exibição muito curto e se excedem o áudio; sobreposições também podem ser intencionais, primeiro julgue.
  • Use a versão final para entender o significado das frases, use o SRT final para localizar as legendas e use a pronúncia real e as pausas para arranjar as ações. Se o usuário especificou "seguir a nova legenda", projete com base nela. Se o áudio divergir substancialmente dela, aponte as frases e os trechos específicos, não altere palavras ou mova timecodes sem autorização.
  • Fatos, números, políticas e fontes de notícias com prazo de validade precisam ser verificados. Ao fazer comparações, primeiro esclareça os objetos e versões, depois verifique se as definições, unidades e condições de aplicação são comparáveis. Se a gravação final contiver erros que afetem o significado, proponha correções específicas, não deixe que o visual e a narração entrem em contradição.
  • Quando novo áudio ou novas legendas chegarem, recalcule os trechos de tempo afetados, legendas, transições e número total de frames, verifique se os planos subsequentes ainda estão sincronizados.

Se houver SRT, execute scripts/inspect_media.py para verificar a estrutura e a duração. Se houver áudio final e for necessário alinhar ações, você pode ouvir previamente frases alteradas ou frases-chave reconhecíveis antes de espalhar o storyboard; veja Implementação e Sincronização.

2. Primeiro, Determinar a Direção Visual Julgável

Ao propor uma nova direção, use uma frase do roteiro para explicar como a imagem será apresentada. Se houver material pronto, aponte qual detalhe merece ser ampliado e qual pausa é adequada para o público ler o gráfico. Quando for necessário criar diagramas, explique qual relação eles devem esclarecer. Cores, fontes e composição só precisam ser decididos para a parte necessária desta etapa.

Considerar Conteúdo e Material Simultaneamente

Quando o usuário descreveu apenas o material e quer discutir ideias, você pode propor um design condicional com base na descrição, por exemplo, "se a foto mostra tanto a fonte de luz quanto a mesa, faça com que apareçam juntos". Quando chegar a fase de seleção, corte ou alinhamento da imagem, examine o arquivo real para confirmar o que ele pode mostrar e quais detalhes precisam ser preservados. Se um material pode explicar algumas frases, dê a ele tempo de tela suficiente.

Quando o usuário fornecer imagens, screenshots, gravações de tela ou filmagens reais, leia primeiro Design e Reutilização de Material, estabeleça a correspondência com a narração, depois escolha entre exibir originalmente, focar localmente, redesenhar com base nos fatos ou combinar com animações explicativas. Se não houver material pronto, prepare gráficos de código ou gere material com base no tema e público; personagens e expressões são apenas uma opção possível.

  • Deixe que o método de apresentação sirva ao tema: mecanismos são adequados para animações esquemáticas, processos para fluxo de objetos, comentários para distinção clara entre evidências e opiniões. Não encaixe todo o conteúdo no mesmo layout de cartão.
  • Quando o usuário não especificar, proponha 16:9, 1920×1080, 30fps; projetos existentes, requisitos de formato vertical e requisitos de plataforma têm prioridade. A fonte deve se adequar ao tom do conteúdo e ao idioma, não fixe em uma fonte arredondada ou de uma marca específica.
  • No início, mostre o problema e o assunto ao público o mais rápido possível. Ao apresentar vários termos para iniciantes, primeiro explique o que este vídeo ajuda o público a entender ou que decisão tomar. Ao mostrar uma lista, agrupe os termos com base nos problemas que o público pode entender e coloque os termos nas posições correspondentes.
  • Se o estilo não agradar, verifique a composição, a linguagem do material, o ritmo dos planos e a lógica da ação; apenas mudar as cores muitas vezes não resolve a sensação de template.

Primeiro, Validar a Direção com Imagens Representativas

Para problemas de layout, você pode tentar fazer o quadro mais difícil e julgar com um frame estático. Para validar um novo estilo ou uma mudança grande de ritmo, selecione dois trechos com diferentes tarefas de explicação e faça uma pequena amostra, reproduzindo-os continuamente com a transição entre eles. Verifique se a ação acompanha a narração, se o olhar é direcionado para a informação chave, se o resultado tem tempo de leitura suficiente e se a composição e a forma de entrada são repetitivas. Quando o usuário pedir para ver o plano primeiro, espere a confirmação antes de expandir; quando a direção já estiver clara ou for apenas uma modificação local, pode-se prosseguir.

3. Organizar Cenas Contínuas com Base no Significado das Frases

Primeiro, agrupe algumas frases da narração que explicam o mesmo problema, escolha um assunto que o público possa acompanhar. Decida, frase por frase, onde o público deve olhar naquele momento; a imagem pode responder com: mudança de objeto, transferência do olhar ou permanência no resultado. Ao mudar para um novo problema, reescolha o assunto, composição e movimento de acordo com a necessidade da explicação. Para trechos simples, uma única frase de cena é suficiente. Quando o usuário exigir efeitos de movimento frase por frase ou transições complexas, marque as mudanças correspondentes a cada frase com o ID da legenda e o tempo. Storyboard e Animação Semântica contém tabelas e exemplos de cenas contínuas que podem ser adaptados.

Priorize que a mudança expresse o significado: causa do aparecimento, processo de ocorrência, comparação de estados, acúmulo, decomposição, tentativa e erro, feedback e resultado. O mesmo objeto pode percorrer todo o vídeo, mas deve evoluir com a narrativa; o uso repetido de material estático não substitui o desenvolvimento.

Cada plano deve estabelecer apenas um centro de atenção principal. Legendas, títulos, ilustrações e movimentos de câmera não devem competir pela atenção do público. Mecanismos complexos permitem que os elementos apareçam gradualmente e sejam observados com estabilidade; o número de ações não é um indicador de qualidade.

4. Produzir Imagens e Animações

Ao usar Remotion, utilize simultaneamente o skill oficial remotion-best-practices e leia Implementação e Sincronização. Se esse skill estiver faltando, consulte Verificação do Ambiente e Configuração Inicial para obtê-lo e carregue as orientações relevantes para esta implementação; se a instalação for impedida, explique as limitações e continue com a documentação oficial para lidar com as partes realizáveis. Quando a cadeia de ferramentas existente (não Remotion) for adequada, pode-se mantê-la; não force a migração do projeto apenas para usar este skill.

  • Gráficos, setas, valores numéricos, gráficos e mudanças de estado devem ser priorizados como elementos de código editável ou vetoriais. Gere ou selecione material bitmap apenas quando forem necessárias ilustrações, texturas ou personagens.
  • Assuntos que precisam de movimento independente devem ser separados em camadas. Imagens geradas servem para material visual; planos e ações ainda precisam ser projetados em torno da linha do tempo. Screenshots reais e gravações de tela são responsáveis por mostrar fatos; animações auxiliares são responsáveis por explicar relações; não use ícones decorativos para substituir operações-chave, nem fixe todo o material no mesmo lado.
  • Notícias e evidências devem usar materiais reais e indicar a fonte real; imagens geradas não podem se passar por screenshots de notícias, resultados de testes ou evidências estatísticas. Ampliações e destaques de screenshots devem apontar com precisão para a área relevante e preservar o contexto necessário.
  • Preserve o texto na tela conforme sua função. Títulos levantam problemas ou indicam transições, anotações ajudam a identificar objetos, dados e condições, legendas carregam a narração. As descrições do storyboard devem ser convertidas em ações ou mudanças de estado na tela. Durante a revisão, texto extra pode ser temporariamente ocultado; se a imagem ainda for facilmente compreendida, pode ser removido. Palavras-chave, fórmulas ou conclusões-chave podem aparecer em dois lugares, mas deve haver uma relação clara de hierarquia principal e secundária; se necessário, desloque os tempos. Texto em fundos complexos deve usar fundo de cor sólida estável, máscara local ou layout independente para garantir contraste.
  • Títulos e anotações podem entrar com a narração; após a leitura, a atenção deve retornar ao assunto principal ou ao próximo plano. Veja Controle de Texto e Layout para detalhes.
  • Verifique títulos, anotações, texto original de screenshots e legendas no tamanho de visualização alvo. Amplie o assunto principal, feche o layout e corte o foco antes de empilhar mais decoração para preencher espaços.
  • Reserve espaço para legendas e interface da plataforma; ações-chave, fontes e explicações não devem ficar escondidas atrás das legendas. Fontes e materiais devem poder ser carregados de forma estável com o projeto.

5. Preview, Revisão e Entrega

Escolha o método de verificação com base na entrega atual e distinga três tipos de evidência:

  1. Frame estático: Composição, tamanho do texto, contraste, oclusão, posição do destaque do screenshot.
  2. Reprodução contínua: Sincronia entre narração, legendas, ações e transições; se repetições e pausas são razoáveis.
  3. Verificação de arquivo: Resolução, frame rate, duração, faixa de áudio, codec e decodificabilidade.

Não substitua a validação dinâmica do vídeo inteiro por "build bem-sucedido" ou "vistas algumas screenshots". Registre o escopo real da verificação; se não é possível assistir ou ouvir alguma parte, explique honestamente, evitando declarar que tudo foi aprovado.

Ao receber feedback, primeiro localize o quadro específico; por exemplo, "letra pequena" pode ser devido ao tamanho insuficiente do título ou a uma screenshot de página inteira reduzida demais. Após a modificação, revise o trecho alterado e a transição; quando componentes compartilhados estiverem envolvidos, verifique também outros planos afetados.

Quando for necessário o vídeo final, exporte dentro do escopo autorizado e verifique o arquivo final. Miniatura, título de publicação e texto devem ser feitos apenas conforme a necessidade; o conteúdo deve ser baseado no vídeo final; o título deve ser atraente, mas sem ampliar as conclusões. A criação de material para publicação não significa publicar em plataformas externas em nome do usuário.

Mantenha o áudio final, legendas, projeto editável, material referenciado, vídeo final e fontes necessárias. Nomeie os arquivos usando o tema ou nome do projeto; não codifique duramente números de episódios, diretórios pessoais ou ambiente de máquina. Antes de limpar, verifique as referências do projeto e dependências compartilhadas; não torne a exclusão de arquivos antigos uma etapa padrão.

Entregue o plano, preview de trecho ou vídeo final conforme o acordado nesta etapa. Ao entregar o vídeo, anexe localização, especificações e resultados reais da verificação; se houver um projeto editável, forneça o ponto de entrada.

Habilidades Relacionadas