Communitygithub.com

vibe-knowledge-video

Crie ou refine vídeos animados de conhecimento sobre ciência, história, matemática, psicologia, economia, humanidades etc. Primeiro, confirme o propósito e o público para definir o estilo; em seguida, realize verificação de fatos, storyboard narrativo, cenas 2D ou 3D, opção de sincronização musical, legendas, revisão final e entrega. Adequado para criar vídeos a partir de tópicos de conhecimento, decompor e migrar vídeos de referência, revisar vídeos existentes em pontos específicos no tempo, e produzir capa e textos complementares.

O que é vibe-knowledge-video?

Este skill modela um fluxo de trabalho completo para produção de vídeos animados de conhecimento, abrangendo ciência, história, matemática, psicologia, economia e humanidades. Ele foi projetado para ser usado com agentes de IA (como Claude Code, Cursor ou Codex) e fornece um processo estruturado que começa com a definição do propósito e estilo do vídeo, seguido por verificação de fatos, criação de storyboard, produção visual (2D ou 3D), sincronização musical opcional, legendagem e verificação final. O skill não presume que qualquer tópico gerará um vídeo perfeito na primeira tentativa, nem trata o código-fonte gerado como um vídeo finalizado. Ele suporta múltiplos cenários: criação de novos vídeos, decomposição e migração de vídeos de referência, revisão de vídeos existentes em pontos específicos, e produção apenas de capa e textos. A abordagem enfatiza precisão factual, clareza causal e rastreabilidade das fontes, com decisões de estilo (profundidade do conhecimento, paleta de cores, som e animação) independentes umas das outras. O fluxo de trabalho é iterativo e inclui checkpoints de qualidade, como a criação de uma amostra de qualidade antes da produção completa e uma lista de verificação de QA final. O skill também oferece referências detalhadas para cada etapa (história e evidência, design visual, análise de referências, biblioteca de modelos, música e tempo, produção e QA, materiais de publicação) e um starter kit baseado em Remotion e Three.js para configuração inicial do projeto.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/S-Fan-ZJU/vibe-knowledge-video/tree/HEAD/skills/vibe-knowledge-video

Perguntar na sua IA favorita

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

Documentação

Vibe Knowledge video

Transforme conhecimento em animações adequadas ao propósito, compreensíveis e prontas para exibição real. Baseie-se no fluxo de trabalho, ferramentas e processo de verificação já praticados no Vibe Science Video, expandindo para diferentes áreas e estilos. Profundidade do conhecimento, cores, som e animação são escolhidos independentemente; expressão científica e referências de entretenimento são direções opcionais. Não prometa que qualquer tópico será gerado com sucesso na primeira tentativa, nem trate o código-fonte gerado como um vídeo já entregue.

Cada novo vídeo: primeiro confirme propósito e estilo

Este é o passo inicial deste skill. Leia Propósito e Estilo, organize as informações já fornecidas e use 2-3 perguntas curtas para complementar:

  1. Propósito e público: Onde será usado, para quem, qual a base de conhecimento do público, o que devem entender após assistir?
  2. Estilo e referências: Científico/educacional, divulgação científica popular, entretenimento ou misto? Quais características das referências serão adotadas e quais não?
  3. Ritmo e som: Suave/moderado/intenso? Presença de música, narração e efeitos sonoros? Sincronização e cintilação musical desligadas, sutis ou evidentes?

Registre diretamente as informações já esclarecidas, pergunte apenas as omissões; quando o usuário delegar explicitamente a escolha, documente a justificativa. Se o propósito ou estilo ainda estiverem ausentes, aguarde a resposta antes de definir storyboard, visuais e trilha sonora; é possível, entretanto, organizar materiais e verificar fatos. Não aplique automaticamente um estilo baseado apenas no tema, plataforma ou vídeo anterior; revisões comuns de um mesmo vídeo mantêm a direção já confirmada.

Escreva as respostas, fontes confirmadas e itens pendentes no brief. Todos os estilos devem manter precisão factual, clareza causal e rastreabilidade das fontes. Cores vibrantes também podem ser usadas em diagramas científicos; planos contidos podem ser combinados com música rítmica. Permite-se sem BGM, cintilação desligada, narração dominante e expressão 2D. A avaliação específica deve se basear no propósito do vídeo, não usando mais cores vibrantes ou mais efeitos como padrão uniforme de qualidade.

Primeiro, identifique em que etapa o projeto se encontra

  • Novo projeto: Leia História e Evidência e Design Visual, crie o brief, tabela de fatos e storyboard.
  • Continuar projeto existente: Primeiro leia o AGENTS.md, planning/brief.md, planning/project-state.md e o índice de análise de referências; se o caminho do projeto existente for diferente, use o ponto de entrada real. Encontre a versão final, trilha sonora final, linha do tempo e o último feedback do usuário; mantenha as saídas antigas, não sobrescreva a versão final com rascunhos históricos.
  • Decompor vídeo de referência: Leia Análise e Migração de Referências, registre o vídeo fonte, intervalo de tempo, evidência, propósito aplicável e método de migração; distinga métodos já aprendidos de componentes genéricos já implementados.
  • Revisar problema específico: Leia a seção de reparos de Produção, Verificação e Reparo, registre o ponto no tempo, objeto, fenômeno e decida se é necessário trocar a trilha sonora, re-renderizar ou reorganizar todo o vídeo.
  • Apenas capa ou texto: Leia Materiais de Publicação; não inicie uma regravação desnecessária do vídeo.

Ao criar um novo vídeo, redefinir visuais ou adicionar/substituir assets, verifique os assets, imagens, dados e modelos existentes no projeto. Quando necessário candidatos 3D, leia assets/models/README.md, inventory.json e prévias existentes; se não houver um inventário, use a ferramenta de auditoria somente leitura do Fluxo de Reutilização de Modelos para encontrar arquivos reais. Selecione com base no assunto do quadro, toma e estilo já confirmado; registre arquivos e decisões no Plano de Assets. Para alterações apenas em legendas, mixagem ou texto de divulgação, não é necessário reexaminar a biblioteca de modelos.

Som, público, duração e proporção de tela devem ser definidos para este vídeo. 16:9, master 4K60 + versão de reprodução 1080p60 são especificações opcionais já experimentadas; prévias podem usar resolução mais baixa. Quando orçamento, hardware ou tema não forem adequados, proponha trade-offs específicos; não trate 4K, 60 fps ou 3D como substitutos de qualidade.

Pergunte apenas o que não pode ser obtido dos materiais existentes e que mudaria o resultado. Se o tema já foi fornecido, não force a redefinição do tópico. Quando o usuário solicitar primeiro uma amostra, entregue a amostra; quando o usuário autorizar a conclusão contínua, prossiga após verificação de qualidade interna, sem solicitar permissão repetidamente a cada etapa. A autorização de produção não inclui automaticamente publicação pública ou modificação em contas externas.

Restrições principais deste fluxo

  1. Faça sentido à primeira vista. O primeiro quadro deve conter um sujeito relevante ao tema; vídeos científicos podem apresentar diretamente a questão de pesquisa; vídeos educacionais podem mostrar a relação a ser compreendida; divulgação popular pode usar uma situação humana ou contradição intrigante para introduzir.
  2. Cada segmento avança uma compreensão. Explique o mecanismo com "problema → mudança de condição → comportamento do objeto → resultado visível"; responda antes de introduzir a próxima pergunta. Não substitua respostas por uma série de perguntas.
  3. Separe fato e metáfora. Registre objeto, condição, causa, efeito, fonte, divergências de interpretação e simplificações visuais; pesquisa científica não deve ser transformada em um sistema onipotente, eventos históricos não devem confundir tempo e causalidade, gráficos matemáticos e dados devem compartilhar o modelo. As alegações do autor de referência precisam ser verificadas independentemente.
  4. Ative a resposta audiovisual conforme a escolha. São possíveis três níveis: energia contínua, batida normal e revelação chave; cada nível pode ser desligado. Quando for necessário sincronizar, faça os ataques sonoros corresponderem a resultados visíveis, com ações de preparação antecipadas; não force cada batida a piscar.
  5. Conciso não significa cortar palavras. Primeiro, remova entradas lentas e esperas vazias após a leitura; ações complexas ainda precisam de tempo de observação. Legendas, ações e SFX devem ser exportados da mesma linha do tempo.
  6. Refinamento a serviço da compreensão. Priorize sujeito claro, textura, profundidade, direção e contato visível em detrimento de partículas irrelevantes. Mecanismos que exigem sobreposição, inserção ou envolvimento devem usar estruturas espaciais verificáveis.
  7. Transição também é storyboard. Defina claramente o objeto do quadro anterior, continuidade de oclusão ou forma, quadro de troca e ponto de aterrissagem do próximo quadro. Não espere o vídeo todo terminar para adicionar fade in/out uniforme.
  8. Verifique o arquivo final. Studio, PNG, MP4 codificado e pré-visualização de upload podem ser diferentes. Decodifique completamente, verifique quadros selecionados, reproduza continuamente e ouça de fato; registre cada um separadamente, não se substituam.

Fluxo de entrega executável

A tabela a seguir é para um novo vídeo completo. Quando o usuário solicitar apenas storyboard, análise de referência, capa ou revisão local, execute e entregue dentro do escopo correspondente; não execute fases irrelevantes; quando não houver plano de som, não imponha etapas musicais.

FaseResultados verificáveis obrigatóriosCritério para próxima etapa
1. Receber entradabrief: propósito, público, estilo, ritmo/audiovisual, materiais, especificações, escopo de entregaDireções principais com base confirmada; itens pendentes e objetivo de visualização claros
2. Conteúdo e narrativaTabela de fatos, linha narrativa única, cadeia de perguntas, design dos primeiros 15 segundosPrincipais conclusões rastreáveis; abertura com ação e promessa; perguntas que podem ser respondidas
3. Storyboard audiovisualStoryboard, Plano de Assets, plano de som, cues opcionais, transiçõesObjetos consistentes com fatos; relações visíveis; estilo e intensidade adequados ao propósito
4. Amostra de qualidadeVídeo curto codificado real: abertura + tomada do mecanismo mais complexo + uma transição representativaAssets principais com qualidade final; ação e som reais alinhados
5. Produção completaProjeto editável, linha do tempo unificada, legendas, eventos sonoros, registro de assetsCada capítulo claro, tomadas fluem naturalmente, legendas sem espera ou leitura apressada
6. Saída e reparoVídeo completo, QA correspondente, versões revisadas e diferençasArquivo, imagem, som e identidade da versão aprovados em verificações separadas
7. Pacote de publicaçãoCapa, título, descrição, tags, lista de entrega, instruções de reproduçãoPromessas externas consistentes com o conteúdo; cortes e seleção de arquivos corretos para a plataforma atual

Leia as referências relevantes conforme a necessidade:

  • História e Evidência: transformação de artigo em roteiro, ganchos, cadeia de perguntas, tempo de legenda, exemplo narrativo completo.
  • Propósito e Estilo: perguntas iniciais, dimensões de estilo independentes, confirmação e limites de revisão.
  • Análise e Migração de Referências: métodos específicos de 8 referências, códigos de tempo e limites de evidência; processo de extração de frames e migração de novas referências.
  • Design Visual: sistema de design, seleção de assets, textura e espaço, receitas de ação, transições e verificação de colisão.
  • Biblioteca de Modelos e Reutilização entre Diálogos: primeiro descubra assets locais, verifique estrutura, componentes, tamanho e licença, depois projete as tomadas; como estabelecer ponto de entrada para novos projetos ou projetos existentes.
  • Música e Tempo: música opcional, envelope e transient, quadro de resultado, mixagem e alinhamento.
  • Produção, Verificação e Reparo: implementação reproduzível, orçamento de renderização, verificação de arquivo final, reparo local, estrutura de entrega.
  • Materiais de Publicação: composição da capa, proporção da plataforma, título e descrição, fonte dos assets e pacote de publicação.
  • Estudo de Caso e Reparos de Falhas: resultado final, feedback, razões de correção e limites de aplicabilidade de "Transformando Bactérias em Remédio".
  • Ferramentas Portáteis: comandos reais e limitações para analisar BGM, verificar linha do tempo, decodificar completamente e extrair quadros.

Verificação inicial e início do projeto

Ao criar um novo projeto, é possível copiar o Starter Remotion + Three.js para o projeto do usuário e seguir as instruções para instalar, visualizar e renderizar. Não modifique diretamente os templates do skill instalado. Este starter é um experimento de ação espacial de duas condições com cerca de 12 segundos, usado para verificar ambiente, movimento, som e fluxo de exportação; não é uma abertura fixa que transforma automaticamente qualquer tema em vídeo completo.

A Música de Referência e o Registro de Origem mantêm entradas de teste opcionais do experimento técnico original; não substituem a escolha de música para um novo vídeo. O starter suporta arquivos personalizados e mudo explícito; após trocar a música, atualize a análise e as marcações de eventos. O timeline.json do template é um exemplo de estrutura independente, não uma tabela de sincronização fixa para a música de referência ou para o starter.

Em projetos reais, execute tools.md para análise de música, verificação de linha do tempo e verificação final de mídia. Leia os avisos no relatório e interprete com base no quadro; não remova condições científicas ou desative avisos apenas para fazer o script ficar verde. As ferramentas não podem julgar automaticamente se o mecanismo está correto, se o resultado realmente aparece no quadro especificado, ou se o som de aviso é auditivamente proeminente; isso ainda requer revisão visual e auditiva.

Ferramentas e templates relacionados devem ser baseados na documentação real do repositório; não adivinhe novos tempos musicais a partir de valores de exemplo. Mesmo sem um modelo de imagem específico, GPU ou skill adicional, é possível executar este fluxo com as ferramentas disponíveis. Projetos Remotion existentes devem manter a versão bloqueada; para chamar novas APIs, consulte a documentação oficial atual. Se houver um skill oficial do Remotion, pode ser combinado; este skill não depende de outro skill específico para entender o fluxo principal.

Ao iniciar a produção, conclua estas avaliações

Narrativa: Escreva uma razão de visualização específica; escolha as 3-5 perguntas que melhor formam uma resposta visível como ponto de partida, não como requisito fixo. Decida qual cena é a maior revelação e quais parágrafos precisam de explicação tranquila.

Assets: Primeiro, faça um inventário dos candidatos locais, registrando a correspondência entre cada objeto visível e o fato. Reutilize quando apropriado; quando o objeto, época, estrutura, componentes ou efeito visual não forem adequados, explique o motivo e escolha 2D, modificação ou criação de novo asset. Colorir por cadeia não significa que a cadeia possa se mover independentemente; um modelo pronto não significa que a animação do mecanismo já esteja feita. Primeiro, leve uma tomada representativa ao nível de conclusão desejado, depois generalize textura e ação.

Som: Escolha música, narração, efeitos sonoros ou silêncio conforme confirmado para este vídeo. Ao usar música, registre o arquivo real, duração e versão; após cortar, loop ou alterar velocidade, reanalise. Detectar transient não é o mesmo que batida de bateria confirmada; a mixagem do vídeo de referência também não é puro BGM.

Engenharia: No projeto, arquive entrada, assets, código-fonte, saída e QA; o estado do mesmo quadro deve ser reproduzível. Use sementes aleatórias explícitas e evite que a animação dependa do relógio real, do histórico de reprodução ou de recursos assíncronos não concluídos.

Tomadas de risco: Primeiro, teste o processo completo mais difícil de explicar. Gráficos de contagem e curvas compartilham dados; rótulos de mapa seguem o local correto; retorno de insert mantém o estado do quadro principal; ao envolver ação espacial, verifique orifícios, varreduras rotacionais, estruturas internas e externas e contato. Relações específicas baseiam-se nos materiais atuais.

Definição de concluído

Após cada entrega importante ou feedback do usuário, atualize planning/project-state.md: arquivos oficiais, verificações reais, itens a verificar, itens confirmados/aguardando avaliação do usuário, entrada de assets e referências, próximos passos. Inicialização e instalação de ferramentas fornecem ponto de entrada para continuidade do projeto; consulte o manual da ferramenta para detalhes. Registre métodos estáveis nas notas de referência; a duração, taxa de quadros, paleta de cores e preferências de trabalhos específicos mantêm seu escopo de aplicação; amostras, vídeos completos e componentes genéricos são registrados separadamente.

Em vídeos sem som, os itens de som podem ser marcados como não aplicáveis; não crie picos sonoros ou imponha música para verificação. Os vídeos de referência e suas trilhas sonoras não são fornecidos com este pacote; apenas métodos de análise transferíveis são fornecidos; BGM de estudo de caso original é indicado separadamente com fonte e escopo de licença.

Use a Lista de Verificação QA para marcar "verificado / não verificado / não aplicável" e evidências; não preencha status de conclusão não executado. A entrega de tarefa de vídeo completo inclui: vídeo reproduzível, projeto editável, roteiro/legendas finais, registros de som e eventos realmente usados, capa e texto no escopo, método de pré-visualização/renderização, fonte dos assets e limitações conhecidas; apenas storyboard, análise ou revisão local entregam os resultados correspondentes conforme a solicitação.

Se o ambiente não puder realmente renderizar, indique claramente até que etapa foi concluída, qual comando ou recurso está bloqueado, e mantenha o projeto executável; não escreva um link de pré-visualização ou "teoricamente renderizável" como MP4 gerado. O gosto do usuário pelo trabalho, a aprovação em verificação automática e os dados de visualização da plataforma são evidências diferentes; nenhum deles pode ser automaticamente escrito como "garantia de alta retenção".

Habilidades Relacionadas