← Back to Skills Marketplace
243
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install epub-converter
Description
Convert EPUB ebooks between Traditional and Simplified Chinese with metadata and TOC fixed; supports both directions and outputs a new EPUB file.
README (SKILL.md)
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 \x3Cinput.epub>
Convert Simplified to Traditional:
python3 scripts/convert_epub.py \x3Cinput.epub> --direction s2t
Specify output filename:
python3 scripts/convert_epub.py \x3Cinput.epub> -o \x3Coutput.epub>
How It Works
The script:
- Auto-installs dependencies - Creates a virtual environment at
~/.openclaw/epub_venvand installsebooklibandopencc-python-reimplementedon 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 writingopencc-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 (\x3C100MB 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.).
Usage Guidance
This skill appears to do what it says: it converts EPUB text and metadata between Traditional and Simplified Chinese. Before running: (1) be aware it will create a virtual environment at ~/.openclaw/epub_venv and pip-install packages from PyPI (network access required); (2) if you prefer to review or control installs, manually create/activate a venv and pip install ebooklib and opencc-python-reimplemented before running; (3) back up originals (recommended), and avoid attempting to convert DRM-protected files; (4) you can inspect scripts/convert_epub.py and run test_skill.sh to verify behavior locally. If you need stricter supply-chain guarantees, verify package versions or install from pinned wheels/sources.
Capability Analysis
Type: OpenClaw Skill
Name: epub-converter
Version: 1.0.0
The skill is a legitimate utility for converting EPUB files between Simplified and Traditional Chinese. The core logic in `scripts/convert_epub.py` uses the `ebooklib` and `opencc-python-reimplemented` libraries to process ebook content. While the script performs potentially risky actions such as creating a virtual environment and installing dependencies via `subprocess` (in `~/.openclaw/epub_venv`), these behaviors are explicitly documented in `SKILL.md` and `README.md` as part of its 'auto-install' feature. The implementation uses safe coding practices, such as list-based subprocess calls to prevent shell injection, and lacks any indicators of data exfiltration, persistence, or malicious prompt injection.
Capability Assessment
Purpose & Capability
Name/description match the included files and behavior: scripts/convert_epub.py parses EPUBs, converts text and metadata using OpenCC and ebooklib, and writes a new EPUB. No unrelated credentials, binaries, or services are requested.
Instruction Scope
SKILL.md instructs the agent/user to run the included script and documents what is and isn't converted. Runtime instructions (create venv, install ebooklib and opencc-python-reimplemented, parse/convert EPUB files, fix TOC) are narrowly scoped to the conversion task and do not request unrelated files, credentials, or external endpoints.
Install Mechanism
There is no separate install spec; the script auto-creates a virtualenv at ~/.openclaw/epub_venv and runs pip install to fetch dependencies from PyPI at first run. This is expected for a Python utility but does perform network downloads and writes to the user's home directory. The subprocess calls are invoked safely (list form) and install common packages (ebooklib, opencc-python-reimplemented).
Credentials
The skill requests no environment variables, credentials, or config paths beyond creating/using ~/.openclaw/epub_venv. That filesystem access is proportional to the stated behavior (local venv and caches).
Persistence & Privilege
The script creates persistent files (virtualenv) under ~/.openclaw which is reasonable for convenience. always:true is not set, and the skill does not modify other skills or global agent configuration. Users should be aware of the venv left on disk.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install epub-converter - After installation, invoke the skill by name or use
/epub-converter - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of epub-converter.
- Convert EPUB ebooks between Traditional and Simplified Chinese in both directions.
- Automatically installs required dependencies and sets up a virtual environment.
- Processes all text content and metadata within the EPUB file.
- Automatically repairs common EPUB structural issues, including table of contents errors.
- Customizable output file naming with automatic "_简体" or "_繁體" suffixes.
- Includes troubleshooting steps for installation and conversion issues.
Metadata
Frequently Asked Questions
What is 一个万无一失的EPUB繁简转换技能，可以将繁体中文电子书转换为简体中文，或反向转换。?
Convert EPUB ebooks between Traditional and Simplified Chinese with metadata and TOC fixed; supports both directions and outputs a new EPUB file. It is an AI Agent Skill for Claude Code / OpenClaw, with 243 downloads so far.
How do I install 一个万无一失的EPUB繁简转换技能，可以将繁体中文电子书转换为简体中文，或反向转换。?
Run "/install epub-converter" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is 一个万无一失的EPUB繁简转换技能，可以将繁体中文电子书转换为简体中文，或反向转换。 free?
Yes, 一个万无一失的EPUB繁简转换技能，可以将繁体中文电子书转换为简体中文，或反向转换。 is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does 一个万无一失的EPUB繁简转换技能，可以将繁体中文电子书转换为简体中文，或反向转换。 support?
一个万无一失的EPUB繁简转换技能，可以将繁体中文电子书转换为简体中文，或反向转换。 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created 一个万无一失的EPUB繁简转换技能，可以将繁体中文电子书转换为简体中文，或反向转换。?
It is built and maintained by zhaojiaqi (@johnzhaoxiao); the current version is v1.0.0.
More Skills