Communitygithub.com

Jihoon950/paper-to-research-video

Produza um vídeo de pesquisa refinado de 80 a 100 segundos a partir de um artigo acadêmico ou preprint, com afirmações verificadas, cenas animadas personalizadas, legendas e um MP4 verificado.

O que é paper-to-research-video?

Esta skill transforma artigos acadêmicos em vídeos de pesquisa concisos e visualmente refinados, com duração alvo de 90 segundos. Ideal para pesquisadores e desenvolvedores que desejam comunicar descobertas científicas de forma acessível, ela lê o artigo completo, cria um "livro-razão de afirmações" com referências precisas a figuras, tabelas e métodos, e dirige um roteiro cena-por-cena com animações originais. A skill suporta plataformas como Claude Code, Cursor e Codex, e utiliza ferramentas como Remotion e FFmpeg para produção, além de scripts de validação integrados que verificam duração, legendas e conformidade científica. Ela prioriza a integridade dos dados ao marcar claramente o que é evidência observada versus ilustração, e evita qualquer afirmação não fundamentada ou conteúdo inventado, garantindo que o vídeo final seja um resumo fiel e rigoroso do artigo original.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Jihoon950/paper-to-research-video/tree/HEAD/skills/paper-to-research-video

Perguntar na sua IA favorita

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

Documentação

De Artigo a Vídeo de Pesquisa

Crie um filme que permita a um novo espectador entender o problema, o que foi construído ou proposto, o que foi testado e o que a evidência realmente mostra em cerca de 90 segundos. Trate o artigo fornecido como fonte de evidência, não como um conjunto de slides para passar.

Comece com a fonte

  1. Leia o artigo completo, incluindo legendas de figuras, métodos, unidades, linhas de base, limitações e material suplementar quando fornecido. Para uma URL ou DOI, busque o artigo referenciado. Para um PDF local, extraia o texto e inspecione as páginas de figuras reais; use OCR em páginas digitalizadas quando necessário. Não infira resultados apenas do resumo.
  2. Faça um livro-razão de afirmações compacto: cada afirmação quantitativa ou causal na tela precisa da localização exata da fonte (página, figura, tabela ou item suplementar), definição da métrica, condição de comparação e qualquer qualificação. Separe medições reportadas, interpretação dos autores e sua própria ilustração explicativa. Se um resultado-chave for ambíguo, inspecione a fonte novamente e restrinja a afirmação.
  3. Faça um inventário de figuras, tabelas, vídeos, fotos, logotipos, gravações de tela e direitos autorais da fonte. Prefira as próprias figuras/dados do artigo ou diagramas originais gerados. Se uma demonstração solicitada de um sistema real não tiver gravação, construa uma ilustração explicitamente rotulada; não a retrate como filmagem observada. Não carregue material de fonte privado ou não publicado para um serviço externo sem autorização.

Dirija o filme

Escreva uma lista de tomadas cena por cena com código de tempo, uma mensagem por tomada, a ação visual, o que se move para onde, transição, legenda/narração, IDs de afirmações de origem e proveniência da mídia. Use a forma narrativa que se adequa ao artigo; um caminho comum é aposta → sistema ou ideia → comparação controlada → mecanismo → resultado e limite. Coloque o título do artigo, autores e instituição na abertura, quando conhecidos. Mostre o sistema testado antes de mostrar sua falha ou benefício quando esse contexto for necessário.

Mire em 90 segundos por padrão (80-100 é aceitável); ajuste quando o usuário especificar uma duração diferente. Use o tempo de tela para configuração experimental e denominadores, não apenas o maior número. Se uma comparação for condicional, identifique o estado de cada lado e a linha de base; não transforme medições de condição fixa separadas em evidência de um controlador online medido. Dê ao quadro final uma conclusão e limitação precisas.

Planeje a linguagem visual a partir da ciência. Anime diagramas, gráficos medidos, traços e filmagens autorizadas de maneiras diferentes para que o público possa distingui-las. Vídeo real ou saída de terminal devem reter proveniência; repetições, mecanismos ilustrativos e painéis simulados devem ser marcados visivelmente. Nenhuma métrica inventada, fluxo de tokens, traço de utilização, log de falha ou transição não medida. Para orientação detalhada de narrativa e rotulagem, leia editorial-guidance.md.

Produza e verifique

Crie uma pasta de produção funcional ao lado do artigo ou no local escolhido pelo usuário. Salve o livro-razão de afirmações e a lista de tomadas lá, depois implemente o filme com uma ferramenta de timeline nativa de código adequada (Remotion e FFmpeg quando disponíveis; escolha outra ferramenta se ela se adequar melhor ao ambiente). O Remotion starter incluído é um scaffold executável, não um estilo visual a ser deixado intacto: substitua seu texto de amostra e construa tomadas e transições específicas do artigo. Seu film manifest e scripts/validate_film.py fornecem uma verificação de evidência/código de tempo reutilizável. Não copie as afirmações sintéticas do starter no filme do usuário.

Renderize alguns stills representativos cedo para inspecionar hierarquia, rótulos, direitos de imagem e contraste no tamanho de visualização alvo. Em seguida, renderize o vídeo completo, inspecione abertura/meio/fechamento e transições, e corrija texto cortado, gráficos minúsculos, legendas ilegíveis ou saltos abruptos de história. Entregue um MP4, projeto fonte, livro-razão de afirmação-para-fonte, lista de tomadas e arquivo de legendas (ou legendas na tela, se solicitado). Padrão para 1920×1080, 30 fps, H.264 e sem áudio quando o usuário não escolheu áudio; adicione narração/música apenas quando solicitado ou quando o contexto claramente o exigir. Respeite o idioma do usuário.

Execute <skill-dir>/scripts/validate_film.py path/to/film.json --release ao usar o manifesto inicial, e <skill-dir>/scripts/export_srt.py path/to/film.json path/to/captions.srt para legendas em nível de cena. Em seguida, execute <skill-dir>/scripts/verify_video.py path/to/final.mp4 --target-seconds 90 quando ffprobe e ffmpeg estiverem disponíveis. Essas verificações não substituem a revisão visual e científica. Indique o que foi medido, o que foi reconstruído ou ilustrado e o que não estava disponível em filmagem. Não considere uma renderização concluída se sua duração, decodificação, legendas ou afirmações científicas principais não tiverem sido verificadas.

Habilidades Relacionadas