reading-lens

Parse EPUBs and generate Obsidian-ready book analyses with role lenses.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

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.

Frequently Asked Questions about reading-lens

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

FAQPage Schema
How do I generate structured book analyses from EPUB files for my Obsidian vault?

To generate structured book analyses from EPUB files, you can use a parsing tool that reads the EPUB, extracts the table of contents, and outputs Obsidian-ready markdown files with a general overview and per-chapter notes directly into your vault.

Can I apply different reading lenses like PM or CEO to my nonfiction book analysis?

Yes, you can apply configurable role lenses such as PM, CEO, and Entrepreneur to your nonfiction book analysis. These lenses tailor the generated pre-read briefs and post-read syntheses to your specific professional perspective.

What is the best way to create pre-read briefs and post-read syntheses for book chapters?

The best way to create pre-read briefs and post-read syntheses is by using an automated analysis tool that processes each chapter individually, generating structured markdown files with sections for briefs, personal notes, and syntheses.

Does this EPUB book analysis workflow support parallel processing for multiple chapters?

Yes, this EPUB book analysis workflow supports parallel processing. It applies a scalable workflow architecture that generates per-chapter briefs and syntheses concurrently, ensuring consistent and high-quality structured outputs.

How do I mirror my structured Obsidian book notes to Notion?

To mirror your structured Obsidian book notes to Notion, you can use a dedicated integration command that syncs the generated vault files, including the general overview and chapter syntheses, directly to your Notion workspace via MCP.

Are there specific limitations when parsing EPUBs for active reading scaffolding?

A limitation when parsing EPUBs for active reading scaffolding is that the input must be a valid EPUB file format. The tool relies on extracting text and table of contents data, so poorly structured or DRM-protected EPUBs may fail to parse correctly.