Read book

SkillDocs & knowledge

'Reads a book or long PDF and extracts structured, reusable notes — chunks

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Read book skill

What this skill tells your AI

The instructions your AI receives, as published by matteotitta/genesys-skills in skills/research/read-book/SKILL.md and read by ahel’s review.

Turn a book or long PDF into structured, grep-able notes. Same content-consumption pattern every time: ingest → chunk → extract → write a dated clip to the taste-library. The clip is the deliverable — a knowledge asset that /content-strategy and /thought-leadership pull from for evidence, angles, and named frameworks.

Triggers

"read book", "read this book / PDF", "book notes", "extract notes from this PDF", "summarize this ebook", "what's in this book", "pull quotes from this", "extract frameworks from [book]".

What it accepts

InputHow it's read
PDFThe Read tool reads PDFs natively (~10 pages per call — chunk longer books). The pdf skill handles extraction edge cases.
Markdown /.txtRead directly. No conversion.
Pasted textUse what was pasted. Treat a short paste as one chunk.
URL (public-domain text)WebFetch first (free). Firecrawl (firecrawl_scrape) only if the page is JS-heavy or blocked. Project Gutenberg / archive.org .txt URLs are cleanest.
EPUB / MOBIConvert to PDF or markdown first (ebook-convert, calibre), then read as PDF. If no converter is installed, deferred — give the user the one-line install.

Detect type from the file extension or URL. If ambiguous, ask.

Modes

InvocationModeWhat you get
read-book <input>notes (default)Chapter-by-chapter: TL;DR + key concepts + quotes + action items + frameworks
read-book <input> summarysummaryWhole-book TL;DR (1 paragraph) + 3–5 takeaways + who-it's-for
read-book <input> quotesquotesPull-quote highlights only, with chapter + page refs
read-book <input> studystudyNotes + 10–20 spaced-repetition Q&A cards

Full per-mode templates: the premium reference. A long book (>200 pages) with no mode given defaults to notes — warn it'll take many read passes.

Process

Step 1 — Parse input and mode

Detect the format (table above) and the mode (default notes). Confirm the target book if the input is ambiguous.

Step 2 — Get the text and plan the chunks

Per-source ingestion: the premium reference. Chunk in priority order:

  1. By chapter when a TOC exists (PDF bookmarks, or converted EPUB chapter headers).
  2. By 50-page block for PDFs with no TOC.
  3. By 30,000-char block (~7,500 words) for markdown / text.

Keep a short chunking plan (source, title, author, type, total pages, strategy, chunk list) in the scratchpad — not in the repo.

Step 3 — Read each chunk and extract

Loop: read chunk N → extract per the chosen mode (the premium reference) → append the partial to the scratchpad. For PDFs, read chunks individually — never the whole book in one call (the PDF Read cap is ~10 pages). If a chunk is front-matter or diagrams with nothing to extract, log the skip and continue.

Step 4 — Aggregate into the full notes

Combine the chunk partials into the mode's full-book shape: TL;DR, key takeaways (3–7 — the ones that survive forgetting), who-it's-for, verdict, chapter notes, and cross-reference suggestions.

Step 5 — Write the taste-library clip

The clip is the deliverable. Write to:

projects/research/taste-library/resources/{MMYY}-{slug}.md

{MMYY} = current month+year (0726 = July 2026). {slug} = author + short-title in kebab-case (0726-hormozi-100m-offers.md). Frontmatter matches the taste-library clip convention (below). Confirm the tags against the blessed vocabulary in projects/research/taste-library/CLAUDE.md, and write a real why — a clip without a why is a bookmark, not a taste signal.

Step 6 — Report

In chat: one-line headline (<title> · <author> · <pages or words> · <mode> · <chunks>), the clip path, the TL;DR, and the top 3 takeaways (top 3 quotes for quotes mode).

Evidence discipline

Bound by .claude/rules/evidence-bound-outputs.md. Quotes are the highest-value output and the easiest to corrupt:

  • Quote verbatim. Copy the exact words. Never paraphrase into quotation marks.
  • Cite the locator. Page number (p. 84) when available; chapter + paragraph (Ch 3, ¶12) for EPUB-converted books with no stable pages.
  • Attribute. When the author quotes someone else, name them after the quote. When it's the author, no attribution is needed.
  • Never invent. If the book doesn't say it, it doesn't go in the notes. Flag a gap rather than fill it.

Quality notes

  • Don't flatten. A 30-page chapter earns 8–15 lines, not 3. Compression is good; flattening loses the specifics that make the clip worth keeping.
  • Preserve specifics. Names, numbers, dates, examples — keep them. The point is that later you can grep "what did X say about Y" and find it.
  • Action items are explicit. When the book makes you think "I should do X," flag it. These are the highest-leverage lines for GTM work.
  • Name the frameworks. When the author names a framework, call it out by name — a framework you remember outperforms ten ideas you forget.
  • Push back. In notes and study mode, surface disagreements. Reading critically beats reading reverently.

Error handling

FailureResponse
EPUB/MOBI, no converterbrew install calibre (ebook-convert) or brew install pandoc, then convert to PDF/markdown first.
Scanned PDF (no text layer)OCR first: brew install ocrmypdf && ocrmypdf <in.pdf> <out.pdf>.
PDF has no TOCFall back to 50-page chunks; note it in the clip.
Book >500 pagesWarn on time and read passes; offer summary mode instead of full notes.
Chunk extracts nothingSkip, log, continue — don't fail the whole run.

Composes with

  • /content-strategy — book takeaways and frameworks feed cluster planning and content angles.
  • /thought-leadership — quotes, frameworks, and pushback become evidence and counterpoints in long-form.
  • /deep-research — when a research question surfaces a book, this is the next step; notes feed back into the brief.
  • /storytelling and /gtme-pulse — book stories and stats become narrative and newsletter material.

Attribution

Adapts coreyhaines31/makerskills/read-book (MIT, © 2026 Corey Haines), accessed 2026-07-08. Re-pointed at our taste-library as the notes sink.

Signals

GitHub stars
36
Forks
14
Last commit
Jul 2026
Advanced
Catalog kind
skill
Gateway key
read-book-matteotitta
Source
github.com/matteotitta/genesys-skills