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)

Eight agent skills that turn academic sources (articles, dissertations, theses and books) into a structured, queryable wiki of reading notes. Every note is anchored to a page, cited in the norm your research follows, tagged against a controlled glossary, and read through your research question.

Available on Agensi. Single-user license.

Watch on YouTube

Why I built it

I built these skills to help me study and write my master’s dissertation. Two goals shaped them:

  1. A second brain for academic research. Every reading becomes small, linked, searchable notes, each tied to a page and to the question I am asking. I can find what I read, and see how one author connects to another.
  2. Input for writing. The notes keep the quote, the page and the citation in one consistent structure, so an agent, or I, can draft from them and every claim traces back to its source. The pack does not write the paper for you. It gives you material you can trust and trace.

The aim was a system that is easy to control and to interact with: plain Markdown files that you own, a handful of commands, and a workflow you can see.

What it does

The workflow

The eight skills

Skill Use it to
setup-literature-notes One-time setup: scaffold .literature-notes/, pick the link style, the citation norm and how you count pages.
literature-notes-research-scope State the research question and the glossary.
literature-notes-annotate Read a PDF and write the notes.
literature-notes-review Reconcile pending notes with the scope, one question at a time.
literature-notes-query Search what you already noted.
literature-notes-validate Check for broken references and, optionally, quotes before a commit.
literature-notes-visualize Generate the HTML site.
literature-notes-ask-how Ask which skill fits what you are doing.

Keep reading

Why a query stays cheap

A query or a validation only brings what matches into the chat, not the whole bundle. The notes can grow to hundreds of files without each query costing more.