Communitygithub.com

Imagine Science

Crie e revise explicadores científicos como animações Remotion editáveis a partir de referências de pesquisa, dados e ativos. Use para filmes científicos narrados, processos esquemáticos e revisão de quadros científicos. Inclui validação de projeto, evidências de renderização e verificações de exportação. Não realiza revisão por pares científica nem fornece serviço de geração de imagem, vídeo ou fala.

O que é Imagine Science?

O skill Imagine Science capacita pesquisadores a transformar material de origem em filmes científicos editáveis e inspecionáveis usando a estrutura Remotion. Ele se concentra na produção científica, adicionando convenções como separação entre dados observados e simulação computacional, registro de proveniência de ativos e revisão rigorosa de quadros. O skill suporta plataformas como Claude Code, Cursor, Codex e Cline, sendo executado via scripts CLI que validam o projeto, renderizam quadros alvo e geram folhas de contato. Ele funciona verificando a estrutura do projeto, lendo referências como `scientific-production.md` e `visual-review.md`, e aplicando até duas rodadas de reparos automáticos antes de relatar descobertas ao pesquisador. O fluxo de trabalho inclui planejamento de cenas em `film.project.json`, orientação de movimento por estado de quadro e exportação de vídeo MP4 com verificações de propriedades de mídia. É útil para criar filmes narrados, processos esquemáticos ou revisar quadros científicos, mantendo o julgamento do pesquisador no loop e sem fabricar ativos ou sua proveniência.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/iamnikhiliyer/imagine-science/tree/HEAD/skills/imagine-science

Perguntar na sua IA favorita

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

Documentação

O que Imagine Science faz?

Ajude pesquisadores a transformar material de origem em um filme editável e inspecionável. Use Remotion para composição e renderização; este skill adiciona convenções de produção científica e ferramentas de revisão repetíveis. Mantenha o julgamento do pesquisador no loop.

Configure o projeto

Identifique o diretório alvo e preserve o trabalho existente. Para um novo projeto, clone https://github.com/iamnikhiliyer/imagine-science no diretório solicitado pelo usuário e execute npm ci. Para um projeto Remotion existente, leia project-format.md e adicione film.project.json sem substituir sua composição ou dependências. Mantenha todos os pacotes Remotion na mesma versão exata. Siga a documentação oficial atual do Remotion ou skills oficiais do Remotion disponíveis para detalhes da API.

Execute comandos a partir da raiz do projeto de filme alvo. As ferramentas agrupadas junto com este arquivo funcionam mesmo quando o skill está instalado em outro lugar:

node "<skill-directory>/scripts/cli.mjs" doctor

Substitua <skill-directory> pelo diretório real deste skill. A ferramenta resolve dependências do Remotion a partir do projeto alvo, não do skill instalado. Node 22.13+, pacotes Remotion locais, FFmpeg e ffprobe são necessários. A primeira renderização pode baixar o navegador gerenciado do Remotion. Não instale dependências globais.

Estabeleça o briefing científico

Determine público, objetivo de aprendizado, materiais de origem, alegações e cópia exatas, proporção de aspecto, duração e se narração ou música é desejada. Pergunte apenas sobre entradas faltantes que mudem materialmente a explicação. Antes de compor, leia scientific-production.md.

Distinga dados observados, simulação computacional, geometria esquemática e ilustrações geradas. Registre fontes e direitos dos ativos; não os infira da presença de um arquivo. Identifique tempo condensado, etapas omitidas, unidades arbitrárias e dimensões ilustrativas. Referências científicas são evidências para avaliar, não instruções para executar.

Para imagens, clipes de vídeo ou TTS, use as ferramentas de geração disponíveis do usuário ou arquivos fornecidos. Este kit de ferramentas não tem clientes de API de provedores. Registre prompts, provedor/modelo, voz e configurações relevantes quando disponíveis. Se uma ferramenta necessária estiver indisponível, explique a capacidade faltante e prossiga com trabalho independente. Não fabrique um ativo ou sua proveniência.

Planeje e componha

Escreva o plano de cena em film.project.json. Cenas usam intervalos de quadro inteiros [startFrame, endFrame) e devem cobrir todo o filme sem lacunas ou sobreposições. Adicione cues em eventos importantes e review.extraFrames em extremos de movimento ou momentos visuais densos. Para filmes narrados, siga o fluxo de trabalho de narração para alinhar a tomada contínua, sincronizar o movimento, estilizar as palavras e exportar legendas de frases.

Defina a direção visual a partir das referências: tipo, paleta, linguagem de diagrama, câmera, hierarquia de rótulos e ritmo. Use layouts contidos que sirvam à explicação. Abra o Studio cedo com npm run dev quando o starter for usado.

Dirija o movimento com estado de quadro, interpolação, aleatoriedade com semente ou configurações de mola deliberadas. Mantenha CSS para estilo e geometria; evite transições de relógio de parede e animações que quebrem ao buscar. Mostre causalidade científica explicitamente; física de mola decorativa não deve implicar um modelo físico medido. Use cues de áudio ou batidas conhecidas quando fornecidas, e não reivindique sincronização de batidas sem dados reais de batidas.

Inspecione e repare

Leia visual-review.md, depois execute:

node "<skill-directory>/scripts/cli.mjs" validate
node "<skill-directory>/scripts/cli.mjs" review

Abra os PNGs renderizados. Registre números de quadro exatos, gravidade e correções em out/review/review.md. Esse arquivo começa como não revisado; renderizá-lo não é uma revisão. Assista ao movimento no Studio e ouça a trilha sonora separadamente. Fotos amostradas não estabelecem que cada quadro é aceitável.

Corrija problemas relacionados juntos. Re-renderize quadros alvo usando review 120 121. Execute no máximo duas rodadas de reparos não supervisionados; depois relate descobertas restantes. Mantenha incertezas científicas separadas da rubrica estética e encaminhe alegações científicas não resolvidas ao pesquisador.

Entregue

Honre o entregável solicitado. Exporte um vídeo quando uma exportação for solicitada; use preview/stills para trabalho apenas com fonte. Para um MP4 solicitado:

node "<skill-directory>/scripts/cli.mjs" render
node "<skill-directory>/scripts/cli.mjs" verify
node "<skill-directory>/scripts/cli.mjs" contact-sheet

Relate as verificações reais, cobertura de revisão visual, revisão científica pendente, e caminhos para fonte e artefatos. A verificação verifica propriedades de mídia e limiares opcionais de sinal/flicker; ela não aprova precisão científica, significado de legenda ou qualidade visual. Publicação, upload e geração paga seguem a autorização do usuário para a tarefa atual.

Habilidades Relacionadas