aliceisjustplaying

Claude Skill Epub Reader — Development skill for Claude Code

Development community

A Claude Code skill that enables efficient reading of EPUB ebook files.

How to install Claude Skill Epub Reader

This entry records only its repository, not the path inside it, so there is no exact command to give. Open aliceisjustplaying/claude-skill-epub-reader and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Claude Skill Epub Reader does

A Claude Code skill that enables efficient reading of EPUB ebook files.

Alternatives in Development

  • QuickSilver OS — 📊 You are ChatGPT-4, running the QuickSilver OS, a user-friendly and powerful virtual operating system that e 9.1k ★
  • Claude Token Efficient — One CLAUDE.md file 3.8k ★
  • Reader Review — reader skill — 苛刻读者版 669 ★

README

EPUB Reader Skill for Claude Code

A Claude Code skill that enables efficient reading of EPUB ebook files.

Features

  • Metadata extraction - title, author, publisher, date, language
  • Table of contents - view chapter structure with chapter references ([ch: N])
  • Chapter reading - read specific chapters by number
  • Full extraction - extract entire book as markdown
  • Search - find text with surrounding context
  • Open-ended search - broad queries are automatically expanded using Claude's domain knowledge

Installation

The skill is installed at `~/.claude/skills/epub/`. Restart Claude Code after installation for the skill to be discovered.

Usage

Just ask Claude naturally about EPUB files:

  • "What's in this EPUB file?"
  • "Show me the table of contents"
  • "Read chapter 5"
  • "Search for 'democracy' in the book"
  • "Extract the entire book as markdown"
  • "What does the book say about the main character's motivation?" (open-ended queries work too!)

Claude will automatically use this skill when it detects EPUB-related requests.

CLI Commands

The skill uses a TypeScript CLI tool under the hood:

# View metadata
node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js metadata "book.epub"

# List table of contents
node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js toc "book.epub"

# Read specific chapter (1-indexed)
node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js chapter "book.epub" 3

# Extract entire book
node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js full "book.epub"

# Search for text
node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js search "book.epub" "query"

Technology Stack

  • TypeScript - main implementation language
  • jszip - extract EPUB contents (EPUBs are ZIP archives)
  • xml2js - parse OPF/NCX metadata files
  • turndown - convert HTML content to Markdown
  • commander - CLI argument parsing

Development

To modify and rebuild: