literature-notes

Agent skills that turn academic PDFs into a queryable wiki of reading notes.

View the Project on GitHub emvalencaf/literature-notes-docs

literature-notes

English Português (Brasil)

Oito skills de agente que transformam fontes acadêmicas (artigos, dissertações, teses e livros) em uma wiki estruturada e consultável de notas de leitura. Cada nota é ancorada a uma página, citada na norma que a sua pesquisa segue, marcada com um glossário controlado e lida à luz da sua pergunta de pesquisa.

Disponível na Agensi. Licença de um usuário.

Assistir no YouTube

O fluxo de trabalho

Por que eu criei

Criei estas skills para me ajudar a estudar e a escrever a minha dissertação de mestrado. Dois objetivos moldaram o sistema:

  1. Um segundo cérebro para pesquisa acadêmica. Cada leitura vira notas pequenas, ligadas e pesquisáveis, cada uma presa a uma página e à pergunta que estou fazendo. Eu acho o que li e vejo como um autor se liga a outro.
  2. Insumo para a escrita. As notas guardam a citação literal, a página e a referência numa estrutura consistente, então um agente, ou eu, consegue redigir a partir delas, e cada afirmação volta à sua fonte. O pacote não escreve o trabalho por você. Ele entrega material em que você pode confiar e que dá para rastrear.

A ideia foi montar um sistema fácil de controlar e de usar: arquivos Markdown que são seus, poucos comandos e um fluxo que dá para enxergar.

O que faz

As oito skills

Skill Para que serve
setup-literature-notes Preparação única: cria .literature-notes/, escolhe o estilo de links, a norma de citação e como você conta as páginas.
literature-notes-research-scope Definir a pergunta de pesquisa e o glossário.
literature-notes-annotate Ler um PDF e escrever as notas.
literature-notes-review Conciliar notas pendentes com o escopo, uma pergunta de cada vez.
literature-notes-query Buscar o que você já anotou.
literature-notes-validate Checar referências quebradas e, se quiser, as citações literais, antes do commit.
literature-notes-visualize Gerar o site HTML.
literature-notes-ask-how Perguntar qual skill serve ao que você faz.

Como usar

Estrutura em disco

  1. /setup-literature-notes: uma vez por projeto. Pergunta o estilo de links, a norma de citação e se você cita a página do PDF ou a impressa.
  2. /literature-notes-research-scope: pergunta de pesquisa, limites e glossário.
  3. /literature-notes-annotate <caminho-do-pdf>: ler uma fonte, filtrada pelo escopo.
  4. /literature-notes-query: buscar o que já está anotado.
  5. /literature-notes-review: de tempos em tempos, em lote. Entrevista você e atualiza o escopo.
  6. /literature-notes-validate: antes de cada commit. Com --check-quotes, confere as citações literais.

Instalação: copie cada pasta de skills/ para a pasta de skills do seu agente (no Claude Code, ~/.claude/skills/ ou .claude/skills/). Requer Python 3. A skill review usa a skill gratuita grilling, de terceiros. O visualizador HTML carrega fontes e bibliotecas de CDNs públicas.

Versão anterior com campos abnt_*: rode de novo o /setup-literature-notes. Ele lista o que seria migrado e só altera depois da sua confirmação. Três skills foram renomeadas: literature-notes virou literature-notes-annotate, literature-notes-scope virou literature-notes-research-scope e literature-notes-rescope virou literature-notes-review.

Licença: de um usuário. As notas que você cria são suas.