How do I install the Epub Converter skill?

Run npx skillmds@latest add dvcrn/epub-converter in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Epub Converter safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Epub Converter?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Epub Converter free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Epub Converter?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Epub Converter by dvcrn — Agent Skill

Name: Epub Converter
Rating: 4.2 (5 reviews)
Author: dvcrn

Epub Converter

Convert EPUB ebooks between Traditional and Simplified Chinese. Use when: (1) user provides an EPUB file and asks to convert between Traditional/Simplified Chinese, (2) user mentions "繁简转换", "繁体转简体", "简体转繁体", "EPUB转换", (3) user wants to convert Chinese text encoding in ebook files. Supports bidirectional conversion (Traditional→Simplified and Simplified→Traditional).

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

EPUB Chinese Converter

Convert EPUB ebooks between Traditional Chinese (繁體中文) and Simplified Chinese (简体中文).

Quick Start

Convert Traditional to Simplified (most common):

python3 scripts/convert_epub.py <input.epub>

Convert Simplified to Traditional:

python3 scripts/convert_epub.py <input.epub> --direction s2t

Specify output filename:

python3 scripts/convert_epub.py <input.epub> -o <output.epub>

How It Works

The script:

Auto-installs dependencies - Creates a virtual environment at ~/.openclaw/epub_venv and installs ebooklib and opencc-python-reimplemented on first run
Reads EPUB structure - Parses the EPUB file using ebooklib
Converts all text content - Processes all HTML/XHTML documents inside the EPUB
Converts metadata - Updates book title and other metadata
Fixes TOC structure - Repairs any broken table of contents entries
Saves new EPUB - Writes a properly formatted EPUB file

Conversion Directions

t2s (default): Traditional → Simplified (繁體 → 简体)
s2t: Simplified → Traditional (简体 → 繁體)

Output Naming

If no output filename is specified:

Traditional→Simplified: adds _简体 suffix
Simplified→Traditional: adds _繁體 suffix

Example: book.epub → book_简体.epub

Technical Details

Dependencies:

ebooklib - EPUB file parsing and writing
opencc-python-reimplemented - Chinese text conversion

Conversion coverage:

All HTML/XHTML content files (chapters, cover, etc.)
Book metadata (title, author, etc.)
Table of contents entries

Not converted:

Image files (covers, illustrations)
CSS stylesheets
Binary resources

Troubleshooting

If dependencies fail to install:

# Manual installation
python3 -m venv ~/.openclaw/epub_venv
source ~/.openclaw/epub_venv/bin/activate
pip install ebooklib opencc-python-reimplemented

If EPUB structure is corrupted:

The script automatically fixes common issues:

Missing TOC entry UIDs
Malformed EPUB headers
Encoding problems

If conversion fails:

Check that:

Input file is a valid EPUB (not PDF or other format)
File is not DRM-protected
File size is reasonable (<100MB recommended)

Examples

Basic conversion:

python3 scripts/convert_epub.py "自我升级第一原理.epub"
# Output: 自我升级第一原理_简体.epub

Custom output:

python3 scripts/convert_epub.py input.epub -o simplified_version.epub

Reverse conversion:

python3 scripts/convert_epub.py simplified.epub --direction s2t
# Output: simplified_繁體.epub

Success Indicators

When conversion succeeds, you'll see:

✅ Successfully read EPUB
✅ Successfully converted X documents
📝 Converted book title
🎉 Conversion complete!
File size comparison

The output EPUB can be opened in any standard ebook reader (Apple Books, Calibre, etc.).

---name: epub-converterdescription: Convert EPUB ebooks between Traditional and Simplified Chinese. Use when: (1) user provides an EPUB file and asks to convert between Traditional/Simplified Chinese, (2) user mentions "繁简转换", "繁体转简体", "简体转繁体", "EPUB转换", (3) user wants to convert Chinese text encoding in ebook files. Supports bidirectional conversion (Traditional→Simplified and Simplified→Traditional).---# EPUB Chinese ConverterConvert EPUB ebooks between Traditional Chinese (繁體中文) and Simplified Chinese (简体中文).## Quick Start**Convert Traditional to Simplified (most common):**```bashpython3 scripts/convert_epub.py <input.epub>```**Convert Simplified to Traditional:**```bashpython3 scripts/convert_epub.py <input.epub> --direction s2t```**Specify output filename:**```bashpython3 scripts/convert_epub.py <input.epub> -o <output.epub>```## How It WorksThe script:1. **Auto-installs dependencies** - Creates a virtual environment at `~/.openclaw/epub_venv` and installs `ebooklib` and `opencc-python-reimplemented` on first run2. **Reads EPUB structure** - Parses the EPUB file using ebooklib3. **Converts all text content** - Processes all HTML/XHTML documents inside the EPUB4. **Converts metadata** - Updates book title and other metadata5. **Fixes TOC structure** - Repairs any broken table of contents entries6. **Saves new EPUB** - Writes a properly formatted EPUB file## Conversion Directions- `t2s` (default): Traditional → Simplified (繁體 → 简体)- `s2t`: Simplified → Traditional (简体 → 繁體)## Output NamingIf no output filename is specified:- Traditional→Simplified: adds `_简体` suffix- Simplified→Traditional: adds `_繁體` suffixExample: `book.epub` → `book_简体.epub`## Technical Details**Dependencies:**- `ebooklib` - EPUB file parsing and writing- `opencc-python-reimplemented` - Chinese text conversion**Conversion coverage:**- All HTML/XHTML content files (chapters, cover, etc.)- Book metadata (title, author, etc.)- Table of contents entries**Not converted:**- Image files (covers, illustrations)- CSS stylesheets- Binary resources## Troubleshooting**If dependencies fail to install:**```bash# Manual installationpython3 -m venv ~/.openclaw/epub_venvsource ~/.openclaw/epub_venv/bin/activatepip install ebooklib opencc-python-reimplemented```**If EPUB structure is corrupted:**The script automatically fixes common issues:- Missing TOC entry UIDs- Malformed EPUB headers- Encoding problems**If conversion fails:**Check that:1. Input file is a valid EPUB (not PDF or other format)2. File is not DRM-protected3. File size is reasonable (<100MB recommended)## Examples**Basic conversion:**```bashpython3 scripts/convert_epub.py "自我升级第一原理.epub"# Output: 自我升级第一原理_简体.epub```**Custom output:**```bashpython3 scripts/convert_epub.py input.epub -o simplified_version.epub```**Reverse conversion:**```bashpython3 scripts/convert_epub.py simplified.epub --direction s2t# Output: simplified_繁體.epub```## Success IndicatorsWhen conversion succeeds, you'll see:- ✅ Successfully read EPUB- ✅ Successfully converted X documents- 📝 Converted book title- 🎉 Conversion complete!- File size comparisonThe output EPUB can be opened in any standard ebook reader (Apple Books, Calibre, etc.).

Frequently asked questions