| name | reading-books |
| 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
uv run ${CLAUDE_PLUGIN_ROOT}/skills/reading-books/book.py info ~/Books/mybook.pdf
uv run ${CLAUDE_PLUGIN_ROOT}/skills/reading-books/book.py toc ~/Books/mybook.epub
uv run ${CLAUDE_PLUGIN_ROOT}/skills/reading-books/book.py read ~/Books/mybook.pdf --chapter 3
uv run ${CLAUDE_PLUGIN_ROOT}/skills/reading-books/book.py read ~/Books/mybook.pdf --page 42
uv run ${CLAUDE_PLUGIN_ROOT}/skills/reading-books/book.py search ~/Books/mybook.pdf "query"
uv run ${CLAUDE_PLUGIN_ROOT}/skills/reading-books/book.py extract ~/Books/mybook.txt
Supported Formats
| Format | Extensions | Features |
|---|
| PDF | .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.
