← Back to Skills Marketplace
279
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install translate-book
Description
Translate books (PDF/DOCX/EPUB) into any language using parallel sub-agents. Converts input -> Markdown chunks -> translated chunks -> HTML/DOCX/EPUB/PDF.
Usage Guidance
This skill appears coherent for translating ebooks, but consider these practical cautions before installing/using it: 1) Dependencies: install Calibre (ebook-convert), Pandoc, and Python3 (plus pypandoc) locally — the scripts call them via subprocess. 2) Data exposure: translation works by sending chunk text to sub-agents/LLM; do not use it on copyrighted, confidential, or sensitive documents you cannot send to an LLM. 3) Filesystem effects: the pipeline writes a {book_name}_temp/ directory in your current working directory and may create many output files—run it in a dedicated workspace and back up important data. 4) Review code if you require higher assurance: the included scripts are plain Python and call local binaries; if you need to confirm no unexpected network/IO behavior, inspect the scripts (convert.py, glossary.py, merge_and_build.py, calibre_html_publish.py) before running. 5) Minor metadata note: the manifest redundantly lists ebook-convert in both bins/anyBins, which is harmless but worth noting. If you are comfortable with these points, the skill is internally consistent with its stated purpose.
Capability Analysis
Type: OpenClaw Skill
Name: translate-book
Version: 1.0.0
The translate-book skill is a legitimate and well-structured tool for translating books (PDF/DOCX/EPUB) using a multi-step pipeline and parallel sub-agents. The orchestration logic in SKILL.md and the supporting Python scripts (such as convert.py, merge_meta.py, and merge_and_build.py) are entirely focused on the stated purpose: converting documents, managing a terminology glossary, and ensuring translation consistency. The skill uses standard tools like Pandoc and Calibre, and its use of subprocess execution follows security best practices (list-based arguments) to prevent shell injection. No evidence of data exfiltration, malicious execution, or harmful prompt injection was found.
Capability Assessment
Purpose & Capability
Name/description, SKILL.md orchestration, and the included Python scripts (convert.py, glossary.py, merge_and_build.py, calibre_html_publish.py, etc.) all align with a book-translation pipeline. Required binaries (python3, pandoc, ebook-convert/Calibre) are appropriate. Minor redundancy: ebook-convert appears both in required bins and anyBins, but this is a benign metadata/detail issue.
Instruction Scope
SKILL.md instructs the agent to read a user-provided file path, convert it to Markdown chunks, build a glossary, spawn per-chunk sub-agents that receive chunk text and prompts, and write translated chunk outputs and metadata. This stays within the stated purpose. Important user-facing behavior: chunk contents are sent to LLM sub-agents (expected for translation), and the pipeline writes a <book>_temp/ working directory under the current cwd. The instructions do not ask the agent to scan arbitrary system files or exfiltrate data to external endpoints.
Install Mechanism
There is no remote install/download step in the skill manifest (instruction-only), and the repo includes local Python scripts. No URLs or download/extract install steps are present in the manifest. The runtime uses local binaries (Calibre, Pandoc) invoked by subprocesses; the code is local so install-time network fetch risk is low.
Credentials
The skill requests no environment variables or credentials. All operations are local (file I/O, subprocesses, spawning sub-agents). There are no declared secrets or unrelated service tokens.
Persistence & Privilege
always:false and no special persistence is requested. The skill requires allowed-tools (Read/Write/Bash/Agent/etc.), which lets it run local commands and spawn sub-agents — expected for a parallel translation pipeline. This combination increases blast radius if misused, but it is coherent with the skill's purpose and not excessive by itself.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install translate-book - After installation, invoke the skill by name or use
/translate-book - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release with major new glossary and per-chunk meta support for consistency and collaboration:
- Added glossary extraction (with chunk sampling and proper noun detection), v2 schema, and frequency counting for consistent term translation; terms are injected per chunk for sub-agents.
- Sub-agents now emit detailed per-chunk `.meta.json` files (entities, alias hypotheses, conflicts, etc.) to support collaborative glossary growth and later human QA.
- Glossary CLI supports term-table assembly (only injects relevant terms), v1-to-v2 upgrade, and enforces unique surface forms.
- Added comprehensive tests for conversion, glossary, meta, and merger logic; improved script modularity.
- Documentation expanded with detailed glossary, agent, and pipeline behavior; skill metadata updated with homepage link.
- Legacy translation script removed; new modular scripts + tests added.
v0.2.0
- Added full skill documentation detailing book translation workflow from file input to output in multiple formats.
- Introduced parallel sub-agent architecture: each book chunk is translated independently to prevent context accumulation.
- Included rigorous translation prompt for sub-agents, with rules on markdown formatting, header levels, images, and custom instructions.
- Implemented batching with concurrency limit (default: 8) and automatic retry for translation failures.
- Process now translates the book title with proper language formatting before merging and exporting.
- Output includes status report with file locations, count of translated chunks, translated title, and generation summary.
Metadata
Frequently Asked Questions
What is Translate Book?
Translate books (PDF/DOCX/EPUB) into any language using parallel sub-agents. Converts input -> Markdown chunks -> translated chunks -> HTML/DOCX/EPUB/PDF. It is an AI Agent Skill for Claude Code / OpenClaw, with 279 downloads so far.
How do I install Translate Book?
Run "/install translate-book" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Translate Book free?
Yes, Translate Book is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Translate Book support?
Translate Book is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Translate Book?
It is built and maintained by Rainman (@deusyu); the current version is v1.0.0.
More Skills