read-book

Extracts structured notes, quotes, and study cards from books in PDF, EPUB, MOBI, and text formats.

Updated Aug 13, 2026
One-click install
npx skills add https://github.com/imMamdouhaboammar/marketing-skills --skill read-book-immamdouhaboammar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: read-book
Source: https://github.com/imMamdouhaboammar/marketing-skills/tree/main/skills/read-book
Command: npx skills add https://github.com/imMamdouhaboammar/marketing-skills --skill read-book-immamdouhaboammar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Reading long books and retaining their content is time-consuming, and manually taking structured chapter-by-chapter notes from PDFs or ebooks is tedious. This Skill automates chunked reading and produces organized notes, summaries, quotes, or spaced-repetition study cards. ## Core Features & Use Cases - Four extraction modes: notes (chapter-by-chapter TL;DR, key concepts, quotes, action items, frameworks), summary (whole-book TL;DR plus takeaways), quotes (verbatim pull-quotes with page references), and study (notes plus Q&A spaced-repetition cards). - Multi-format ingestion: handles PDF, EPUB, MOBI, markdown, plain text, pasted text, and public-domain URLs, with smart chunking by chapter, page count, or character count. - Second-brain integration: optionally captures the final notes file into a second-brain vault as a highlights file with compatible frontmatter and cross-reference suggestions. - Use Case: You have a 300-page business book as a PDF. Run the notes mode to get per-chapter summaries with verbatim quotes and action items, then capture the result into your Obsidian vault for later compilation into wiki pages. ## Quick Start Ask the agent to read the book at a given file path and extract chapter-by-chapter notes with key takeaways and quotes.

Frequently Asked Questions about read-book

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

FAQPage Schema
How do I extract notes from a PDF book?

Provide the PDF file path and the Skill reads it in chunks, using the table of contents when available or 50-page blocks otherwise. It produces per-chapter TL;DRs, key concepts, verbatim quotes, action items, and frameworks aggregated into a single notes file.

What ebook formats are supported for note extraction?

PDF, EPUB, MOBI, markdown, plain text, pasted text, and public-domain URLs are supported. EPUB files are converted with pandoc, while MOBI and AZW3 require calibre's ebook-convert before processing.

Can I convert EPUB or MOBI files without pandoc installed?

EPUB conversion requires pandoc, installable via brew install pandoc. MOBI files need calibre's ebook-convert, installed with brew install calibre, which can also handle EPUB as an alternative.

Why does text extraction fail on my scanned PDF?

Scanned PDFs lack a text layer, so standard extraction returns almost nothing. Run OCR first with ocrmypdf to add a text layer, then process the OCR'd version normally.

What is the difference between notes, summary, quotes, and study modes?

Notes mode produces chapter-by-chapter structured notes, summary gives a whole-book TL;DR with 3-5 takeaways, quotes extracts only verbatim pull-quotes with page references, and study adds spaced-repetition Q&A cards to the notes output.

Can I export book notes to PDF or HTML?

Yes, the --render pdf or --render html flags post-process the final notes file through pandoc with a shared stylesheet. PDF rendering requires a TeX distribution such as basictex in addition to pandoc.