TrevorS Book Reader
Read and query digital book formats from the command line using BM25 search.
Quick Start
# Get book metadata
uv run ${CLAUDE_PLUGIN_ROOT}/skills/reading-books/book.py info ~/Books/mybook.pdf
# Show table of contents
uv run ${CLAUDE_PLUGIN_ROOT}/skills/reading-books/book.py toc ~/Books/mybook.epub
# Read a specific chapter
uv run ${CLAUDE_PLUGIN_ROOT}/skills/reading-books/book.py read ~/Books/mybook.pdf --chapter 3
# Read a specific page
uv run ${CLAUDE_PLUGIN_ROOT}/skills/reading-books/book.py read ~/Books/mybook.pdf --page 42
# Search for content (BM25 ranked)
uv run ${CLAUDE_PLUGIN_ROOT}/skills/reading-books/book.py search ~/Books/mybook.pdf "query"
# Extract full text
uv run ${CLAUDE_PLUGIN_ROOT}/skills/reading-books/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.