reading-lens

What problem does it solve?

Active-reading scaffolding for nonfiction books (EPUB). Parses an EPUB, generates a structured book analysis in the user's Obsidian vault at Read/{Book Name} ({Author})/, with 0. General.md as the book-level overview and one numbered markdown file per chapter containing pre-read brief, the user's own notes section, and post-read synthesis — all through configurable role lenses (e.g. PM, CEO, Entrepreneur). Six sub-skills — reading-lens:setup loads an EPUB with lens selection, reading-lens:brief generates a pre-read brief for a chapter, reading-lens:synthesize generates a post-read synthesis, reading-lens:overview-redo regenerates 0. General.md, reading-lens:lenses manages global lens presets, reading-lens:to-notion mirrors the book to Notion via MCP. Use whenever the user wants deep, structured book analysis, says "analyze this book", "read this book", "reading lens", "book analysis", "pre-read brief", "chapter synthesis", or references an EPUB path. Prefer this skill for any book-study workflow — even when the user doesn't say its name.

Core Features & Use Cases

• EPUB parsing and TOC extraction: Reads an EPUB, derives title, author, and chapter texts for analysis.
• Per-book and per-chapter outputs: Generates a book overview (0 General.md) and a numbered chapter file for each chapter with a pre-read brief, notes section, and post-read synthesis.
• Lens-driven analysis: Supports multiple fixed roles (PM, CEO, Entrepreneur) and a configurable set of global lenses.
• Notion integration and vaulting: Includes optional Notion mirroring and Obsidian vault-ready formatting.

Quick Start

Load an EPUB into Claude Code and run /reading-lens:setup <epub-path> to generate the initial vault with 0. General and per-chapter stubs.