# epub

Inspects EPUB files, pulls metadata, and converts chapters into clean Markdown. It lets your coding assistant read ebooks and locate excerpts.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 5 installs · ★ 5 repo stars
- Author: aliceisjustplaying
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/aliceisjustplaying/claude-resources-monorepo/tree/HEAD/skills/epub/SKILL.md
- Updated: 2025-12-22
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/epub

## What it does

This skill bundles a Node.js command-line script to unpack `.epub` archives. The agent queries publication details, examines the table of contents, and extracts single chapters or whole manuscripts.

The utility converts book markup into clean Markdown, preserving headers and lists while stripping extra whitespace. Built-in search scans chapters for text patterns, returning up to 5 snippets per chapter with surrounding context. Because chapter numbering starts at 1, checking the table of contents first prevents index mistakes. Running the tool requires an active `node` binary on your path.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add aliceisjustplaying/claude-resources-monorepo --skill epub -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/epub/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/epub/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add aliceisjustplaying/claude-resources-monorepo --skill epub -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/epub/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add aliceisjustplaying/claude-resources-monorepo --skill epub -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/epub/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install aliceisjustplaying/claude-resources-monorepo skills/epub
```

2. **Manually: put the files in place**
- File: `.github/skills/epub/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add aliceisjustplaying/claude-resources-monorepo --skill epub -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/aliceisjustplaying/claude-resources-monorepo --path skills/epub
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/epub/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add aliceisjustplaying/claude-resources-monorepo --skill epub -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/aliceisjustplaying/claude-resources-monorepo/tree/HEAD/skills/epub/SKILL.md

## When to use it
- read a specific ebook chapter without manual format conversion
- locate quotes and key terms with adjacent context inside an EPUB
- retrieve book metadata such as author, publisher, and summary
- extract entire ebook contents into structured Markdown

## Example prompts
- Show me the table of contents for `books/guide.epub`
- Search for mentions of architecture in `system-design.epub`
- Extract chapter 4 from `manual.epub` as Markdown

## Similar
- [markdown-to-epub-converter](https://affpapa.org/en/nevibecode/skills/markdown-to-epub-converter.md) — skill · 725 installs
- [book-converter](https://affpapa.org/en/nevibecode/skills/book-converter.md) — skill · 147 installs
- [obsidian2epub](https://affpapa.org/en/nevibecode/skills/obsidian2epub.md) — skill · 1 install
- [ai-ebook-generator](https://affpapa.org/en/nevibecode/mcp/ai-ebook-generator.md) — MCP server · 272 installs
- [cli-anything-calibre](https://affpapa.org/en/nevibecode/skills/cli-anything-calibre.md) — skill · 386 installs
- [publishing](https://affpapa.org/en/nevibecode/skills/publishing.md) — skill · 458 installs

From the same set: [aliceisjustplaying/claude-resources-monorepo](https://affpapa.org/en/nevibecode/by/aliceisjustplaying/claude-resources-monorepo.md) — 2 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
