Communitygithub.com

Win-Hao/knowledge-video

Transforme um tópico em um vídeo explicativo de conhecimento, fácil de acompanhar, agradável visualmente e que faz as pessoas quererem assistir até o fim (texto na tela sobre música, no estilo que bombou no #Vibe知识大赏 do Douyin), renderizado com HyperFrames.

O que é knowledge-video?

Esta skill transforma qualquer tópico — ciência, história, como algo funciona — em um vídeo explicativo curto e envolvente no estilo 'Vibe知识大赏' (texto na tela sobre música, popular no Douyin). O ponto forte é oferecer um caminho flexível e testado (pesquisa → roteiro → imagens → direção visual e storyboard → renderização), permitindo que você pule, mescle ou reordene etapas conforme o tópico. A skill integra ferramentas auxiliares para edição de música, detecção de batidas, marcação de tempo para sincronia com o texto e efeitos sonoros, além de verificações de qualidade automáticas. Funciona com HyperFrames para a parte visual e pode delegar etapas grandes (como pesquisa ou renderização) para subagentes, garantindo que o contexto de cada um seja limpo e focado. O design visual e narrativo fica a seu critério para cada tópico, com referências de projetos anteriores para inspiração, mas não como regra. É ativada por comandos como 'faça um vídeo sobre X', 'transforme a história de X em um vídeo curto', 'vídeo explicativo', mesmo que o usuário não nomeie a skill explicitamente. Para animações curtas ou apenas um novo visual, use a skill 'code-video'.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Win-Hao/knowledge-video/tree/HEAD/skills/knowledge-video

Perguntar na sua IA favorita

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

Documentação

Knowledge video

Transforme um tópico em um vídeo de conhecimento que as pessoas queiram assistir até o fim. O que segue é um caminho que funciona, não um procedimento fixo: mescle, pule ou reordene etapas, e crie a escrita, o visual e o movimento para este tópico por conta própria.

Fale com o usuário no idioma dele; os nomes de arquivos abaixo são os padrões.

O caminho geral

  1. Pesquisa → article.md: encontre fontes e escreva um artigo com fontes. Primeiro veja qual formato o tópico tem (linha do tempo, cadeia de causas, conceito, comparação, mitos, uma história), depois decida quais pontos cobrir. O usuário decide quantos: ofereça duas ou três opções baseadas na duração da música e recomende uma
  2. Roteiro → script.md: reescreva o artigo como um vídeo que as pessoas veem enquanto rolam a tela
  3. Imagens → images.md ou image-prompts.md: imagens reais ou prompts para ilustrações de IA (presuma que você não pode chamar uma API de imagens; o usuário usa a própria ferramenta dele)
  4. Direção visual e storyboard → looks/, storyboard.md: mostre ao usuário algumas direções, depois faça o storyboard no ritmo da música
  5. Renderização → opening-preview.mp4 → final.mp4: primeiro um pequeno preview de abertura, depois o vídeo completo quando estiver certo

Por padrão, mostre ao usuário o resultado de cada etapa antes de prosseguir: um erro de direção é mais caro depois da renderização. Se ele disser "vá até o fim", continue e anote o que escolheu e por que em storyboard.md.

Cada etapa: preencha um prompt, depois siga-o

Seguindo o guia de prompts da Anthropic, mantenha contexto, requisitos e verificações em tags XML separadas, com uma razão para cada linha: partes separadas não se confundem, e saber o porquê permite que o modelo generalize para o que não está escrito. Você mesmo preenche as tags, a partir deste tópico e do que o usuário disse.

  • Briefing prompts/brief.md: preenchido uma vez no início, atualizado após cada etapa. Apenas um <context>: o tópico, o público, a conclusão, duração, orientação, música, o que o usuário gosta e não gosta, o que as etapas anteriores definiram, onde estão os arquivos

  • Prompt desta etapa prompts/<etapa>.md, quatro tags:

    • <role>: qual papel esta etapa representa e o que esse papel mais valoriza. Os papéis variam por etapa; escolha um para esta etapa, ex.: pesquisa é um editor de conhecimento (valoriza mais fontes), roteiro é um roteirista (valoriza mais se os espectadores vão sair do vídeo), imagens é um editor de fotos ou ilustrador, a direção visual é um diretor de arte, o storyboard é um artista de storyboard, a composição é um designer de movimento (valoriza mais o que cada movimento explica)
    • <task>: o que esta etapa produz e para onde vai
    • <style>: abordagens recomendadas, cada uma com uma razão; recomendações, não regras: escolha entre os exemplos em references/ ou crie algo novo para este tópico; siga o usuário onde ele já disse o que quer, e anote aqui também o que ele não quer
    • <check>: o que verificar, item por item, antes de considerar a etapa concluída; inclua os itens "Deve valer"

    Escreva <role>, <task> e <check> em todas as etapas; omita <style> onde não for necessário (pesquisa e renderização geralmente). Infira o que o usuário não disse a partir do tópico e pergunte sobre o que não tiver certeza no relatório. Mostre o prompt preenchido junto com a saída da etapa; se o usuário editá-lo, refaça a etapa a partir da versão editada

Quem segue: etapas que exigem idas e vindas com o usuário (quantos pontos, qual direção visual) você mesmo executa. Etapas grandes e autocontidas (pesquisa, encontrar imagens ou escrever prompts de imagem, escrever a composição e renderizar) vão para um subagente: dê a ele apenas o briefing, o prompt desta etapa e os caminhos dos arquivos, para que seu contexto fique limpo e contenha apenas o que esta etapa precisa. Ele não sabe o que você e o usuário discutiram, então ambos devem estar completos. Quando ele terminar, leia a saída e execute a autoverificação antes de mostrar ao usuário. Sem subagentes, siga o prompt você mesmo.

Deve valer

  • Fatos têm fonte: cada ano, nome, número e citação remete a uma fonte confiável (artigos científicos, instituições, arquivos, palavras da própria pessoa), vinculada em article.md; descarte o que não puder ter fonte, rotule estimativas, diga de quem é o relato de uma informação de segunda mão. Cada linha na tela, incluindo a pergunta de abertura e o encerramento, corresponde a article.md
  • Ativos são utilizáveis: imagens, música, efeitos sonoros e fontes têm licença para este uso (verifique a página do arquivo); créditos vão em credits.md
  • Sem rostos de pessoas reais desenhados por IA; se o vídeo usar ilustrações de IA, ative o rótulo "conteúdo gerado por IA" da plataforma
  • A imagem depende apenas do tempo: fixe qualquer aleatoriedade para que um quadro seja renderizado sempre igual (HyperFrames precisa disso)
  • Antes de entregar, assista ao vídeo inteiro você mesmo: texto visível e legível no tempo certo, anos e números correspondem ao artigo, som e imagem sincronizados

Ferramentas disponíveis

HyperFrames para a parte visual (npx hyperframes init / docs / check / snapshot / render); se as skills dele estiverem instaladas, siga-as para composições. Ferramentas pequenas em scripts/, use-as ou não:

ScriptO que faz
beats.pyandamento, batidas, linhas de compasso e mudanças de volume por compasso da música
music_loops.py, cut_music.pyencontra compassos que se repetem ou cortam sem emenda, constrói a nova música a partir de uma lista de compassos
timing.pydistribui cada tela do roteiro na grade de batidas, fixa telas-chave em compassos determinados
sfx.pybaixa os efeitos sonoros CC0 da Kenney, mistura dicas de efeitos em uma faixa
qa.pyfolhas de contato de cada tela e quadros ao redor de batidas importantes

O que vídeos anteriores deixaram

Referências, não regras. Crie para este tópico primeiro; consulte aqui quando não tiver certeza ou quando encontrar o mesmo problema:

  • references/example-ai-history.md: o primeiro teste executado, saída de cada etapa e marcação de tempo
  • references/prompt-examples.md: dois prompts preenchidos de um vídeo testado, para ver o nível de detalhe
  • references/notes.md: observações sobre roteiro e ritmo
  • references/images.md: verificação de licenças, escrita de prompts, geração em camadas
  • references/visuals.md: colagem densa, momentos de linha do tempo, cartões de foto, encaixe de interface em telas geradas, o que desenhar em código
  • references/sound.md: edições de música, efeitos sonoros, volume
  • references/pitfalls.md: verifique primeiro quando uma renderização falhar ou a imagem estiver errada

Habilidades Relacionadas