this repo has no description
Add README.md
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
+72
+72
README.md
+72
README.md
···
1
+
# EPUB Reader Skill for Claude Code
2
+
3
+
A Claude Code skill that enables efficient reading of EPUB ebook files.
4
+
5
+
## Features
6
+
7
+
- **Metadata extraction** - title, author, publisher, date, language
8
+
- **Table of contents** - view chapter structure
9
+
- **Chapter reading** - read specific chapters by number
10
+
- **Full extraction** - extract entire book as markdown
11
+
- **Search** - find text with surrounding context
12
+
13
+
## Installation
14
+
15
+
The skill is installed at `~/.claude/skills/epub/`. Restart Claude Code after installation for the skill to be discovered.
16
+
17
+
## Usage
18
+
19
+
Just ask Claude naturally about EPUB files:
20
+
21
+
- "What's in this EPUB file?"
22
+
- "Show me the table of contents"
23
+
- "Read chapter 5"
24
+
- "Search for 'democracy' in the book"
25
+
- "Extract the entire book as markdown"
26
+
27
+
Claude will automatically use this skill when it detects EPUB-related requests.
28
+
29
+
## CLI Commands
30
+
31
+
The skill uses a TypeScript CLI tool under the hood:
32
+
33
+
```bash
34
+
# View metadata
35
+
node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js metadata "book.epub"
36
+
37
+
# List table of contents
38
+
node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js toc "book.epub"
39
+
40
+
# Read specific chapter (1-indexed)
41
+
node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js chapter "book.epub" 3
42
+
43
+
# Extract entire book
44
+
node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js full "book.epub"
45
+
46
+
# Search for text
47
+
node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js search "book.epub" "query"
48
+
```
49
+
50
+
## Technology Stack
51
+
52
+
- **TypeScript** - main implementation language
53
+
- **jszip** - extract EPUB contents (EPUBs are ZIP archives)
54
+
- **xml2js** - parse OPF/NCX metadata files
55
+
- **turndown** - convert HTML content to Markdown
56
+
- **commander** - CLI argument parsing
57
+
58
+
## Development
59
+
60
+
To modify and rebuild:
61
+
62
+
```bash
63
+
cd ~/.claude/skills/epub/scripts/epub-reader
64
+
npm install
65
+
npm run build
66
+
```
67
+
68
+
Restart Claude Code after any changes to `SKILL.md`.
69
+
70
+
## License
71
+
72
+
MIT