OpenParable
Skip to content
← Back to skills

Reading Books

Documents
reading-books

Reading Books is an Agent Skill for documents published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/documents/reading-books/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/reading-books, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Book Reader

Read and query digital book formats from the command line using BM25 search.

Quick Start

# Get book metadata
uv run ~/.claude/skills/reading-books/book.py info ~/Books/mybook.pdf

# Show table of contents
uv run ~/.claude/skills/reading-books/book.py toc ~/Books/mybook.epub

# Read a specific chapter
uv run ~/.claude/skills/reading-books/book.py read ~/Books/mybook.pdf --chapter 3

# Read a specific page
uv run ~/.claude/skills/reading-books/book.py read ~/Books/mybook.pdf --page 42

# Search for content (BM25 ranked)
uv run ~/.claude/skills/reading-books/book.py search ~/Books/mybook.pdf "query"

# Extract full text
uv run ~/.claude/skills/reading-books/book.py extract ~/Books/mybook.txt

Supported Formats

FormatExtensionsFeatures
PDF.pdfPage numbers, TOC detection, metadata
EPUB.epubChapters from spine, full metadata
MOBI.mobi, .azw, .azw3Basic extraction
Text.txt, .text, .mdChapter 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

  1. First access: Extracts and caches the book content
  2. Subsequent access: Uses cached version (invalidates on file change)
  3. Search: BM25 algorithm ranks results by relevance
  4. Results: Include chapter/page location for reference

See Also

See REFERENCE.md for complete command documentation.