reading-agent

Convert academic PDFs into structured Markdown reading notes.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/nealcaren/sociology-writing-suite --skill reading-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reading-agent
Source: https://github.com/nealcaren/sociology-writing-suite/tree/main/plugins/sociology-writing-suite/skills/reading-agent
Command: npx skills add https://github.com/nealcaren/sociology-writing-suite --skill reading-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires docling, and includes scripts (resource) components.

What problem does it solve?

This skill automates the transformation of scattered literature into structured reading notes, converting PDFs to consistent markdown notes and extracting bibliographic data, core arguments, theoretical frameworks, findings, and key quotes for synthesis.

Core Features & Use Cases

  • PDF to Markdown conversion: Converts PDFs into structured markdown notes with cached outputs for reuse.
  • Structured reading notes: Creates consistent frontmatter with identifiers and rich sections for rapid synthesis.
  • Batch processing: Spawns haiku agents to process multiple papers in parallel for large literature reviews.
  • Project integration: Saves notes under literature/synthesis/reading-notes by default and supports project.yaml mappings and Zotero/OpenAlex identifiers.

Quick Start

Use the reading-agent skill to read a single paper: /reading-agent

I need to read: /path/to/paper.pdf

Or with a Zotero reference: /reading-agent

Paper: Smith 2020 "Cultural Frames" DOI: 10.1086/123456

For batch processing: /reading-agent

Batch process these papers:

  • /papers/smith2020.pdf (DOI: 10.1086/123456)
  • /papers/jones2019.pdf (OpenAlex: W2123456789)

Frequently Asked Questions about reading-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert academic PDFs to structured markdown reading notes?

To convert academic PDFs to structured markdown reading notes, use the reading-agent to extract bibliographic data, core arguments, theoretical frameworks, findings, and key quotes into consistent markdown files saved under literature/synthesis/reading-notes.

Can I batch process multiple papers for a literature review?

Yes, you can batch process multiple papers for a literature review by providing a list of PDF paths and identifiers, which spawns haiku agents to handle parallel extraction of reading notes.

Does the PDF to markdown conversion require docling?

Yes, the PDF to markdown conversion requires docling as a dependency to parse the document and cache outputs for reuse during the extraction process.

How do I integrate Zotero or OpenAlex identifiers into reading notes?

To integrate Zotero or OpenAlex identifiers into reading notes, provide the DOI or OpenAlex ID in your command input, allowing the agent to map bibliographic data via project.yaml configurations.

What is the best way to synthesize qualitative research from multiple PDFs?

The best way to synthesize qualitative research from multiple PDFs is using batch processing to extract theoretical frameworks and findings in parallel, generating consistent markdown notes for rapid literature synthesis.

What are the limitations of using automated reading notes for literature synthesis?

Limitations of automated reading notes include the dependency on docling for PDF conversion accuracy and the need for optional Zotero or OpenAlex integration to fully resolve bibliographic data.