book-reader
Read and search digital books (PDF, EPUB, MOBI, TXT). Use when answering questions about a book, finding quotes or passages, navigating to specific pages or chapters, or extracting information from documents.
When & Why to Use This Skill
The Book Reader skill empowers Claude to seamlessly read, search, and navigate various digital book formats including PDF, EPUB, MOBI, and TXT. By leveraging BM25 ranked search and automated table of contents detection, it enables precise information retrieval and document processing, allowing users to interact with long-form content as a dynamic knowledge source.
Use Cases
- Academic Research: Quickly locate specific citations, passages, or evidence across multiple PDF textbooks and research papers.
- Document Navigation: Use the table of contents or page-specific commands to jump directly to relevant chapters in technical manuals or long-form reports.
- Content Extraction: Extract full text or specific sections from EPUB and MOBI files for summarization, analysis, or repurposing.
- Deep Search: Perform keyword-based searches using the BM25 algorithm to find the most relevant sections within a book based on a specific query.
| name | book-reader |
|---|---|
| description | Read and search digital books (PDF, EPUB, MOBI, TXT). Use when answering questions about a book, finding quotes or passages, navigating to specific pages or chapters, or extracting information from documents. |
Book Reader
Read and query digital book formats from the command line using BM25 search.
Quick Start
# Get book metadata
uv run ~/.claude/skills/book-reader/book.py info ~/Books/mybook.pdf
# Show table of contents
uv run ~/.claude/skills/book-reader/book.py toc ~/Books/mybook.epub
# Read a specific chapter
uv run ~/.claude/skills/book-reader/book.py read ~/Books/mybook.pdf --chapter 3
# Read a specific page
uv run ~/.claude/skills/book-reader/book.py read ~/Books/mybook.pdf --page 42
# Search for content (BM25 ranked)
uv run ~/.claude/skills/book-reader/book.py search ~/Books/mybook.pdf "query"
# Extract full text
uv run ~/.claude/skills/book-reader/book.py extract ~/Books/mybook.txt
Supported Formats
| Format | Extensions | Features |
|---|---|---|
.pdf |
Page numbers, TOC detection, metadata | |
| EPUB | .epub |
Chapters from spine, full metadata |
| MOBI | .mobi, .azw, .azw3 |
Basic extraction |
| Text | .txt, .text, .md |
Chapter pattern detection |
When to Use
- User provides a book file and asks questions about its content
- Need to find specific quotes, passages, or information
- Navigating to specific pages or chapters in a document
- Researching topics across digital books
- Extracting text for further processing
How It Works
- First access: Extracts and caches the book content
- Subsequent access: Uses cached version (invalidates on file change)
- Search: BM25 algorithm ranks results by relevance
- Results: Include chapter/page location for reference
See Also
See REFERENCE.md for complete command documentation.