</>MCP Agents Market
Skill

translate-book

by deusyu1.2kPythonUpdated 2026-08-06

Agent skill for Codex, Claude Code, and OpenClaw that translates entire books (PDF/DOCX/EPUB) into any language using parallel subagents.

CodexClaude CodeOpenClaw

The translate-book agent skill enables Codex, Claude Code, and OpenClaw to translate complete books (PDF, DOCX, EPUB formats) into multiple languages using parallel subagent orchestration. It splits documents into chunks, assigns each to an independent AI subagent with isolated context, then validates and merges results into multi-format output (HTML, DOCX, EPUB, PDF). The skill includes resumable translation, glossary-driven term consistency, manifest validation, and neighbor-chunk context for accurate pronoun resolution across hundreds of pages.

Key Features

Parallel subagent translation with 8 concurrent workers per batch, each with fresh context to prevent output truncation
Resumable runs with chunk-level SHA-256 manifest tracking and selective re-translation after glossary edits
Glossary system with alias tracking, frequency scoring, and per-chunk term tables for consistent proper nouns and domain terminology
Neighbor context injection providing read-only adjacent-chunk excerpts for accurate pronoun and entity resolution
Multi-format input and output supporting PDF/DOCX/EPUB input and generating HTML (with TOC), DOCX, EPUB, and PDF
Integrity validation enforcing 1:1 source-to-output mapping and hash verification before merge
Configurable temp workspace, explicit EPUB cover support, and user-facing export name aliases
Multi-language support for Chinese, English, Japanese, Korean, French, German, and Spanish

Use Cases

  • 01Translating technical documentation or textbooks from English to Chinese while maintaining consistent terminology
  • 02Converting foreign-language novels or academic papers into readable EPUB and PDF editions
  • 03Batch-processing multi-chapter reports with guaranteed resumability after interruptions or API rate limits
  • 04Producing web-ready HTML versions with floating tables of contents for online publication
  • 05Re-translating specific chapters after updating glossary entries without reprocessing the entire book
  • 06Converting legacy PDF manuals into modern DOCX and EPUB formats with improved accessibility

Related Skills

View more

translate-book — FAQ

What is translate-book and what does it do?+

Translate-book is an agent skill for Codex, Claude Code, and OpenClaw that translates entire books (PDF, DOCX, EPUB) into multiple languages. It splits books into chunks, translates each with an independent subagent to avoid context overflow, then merges results into HTML, DOCX, EPUB, and PDF formats with validation and term consistency.

How do I install translate-book for Codex?+

Run 'npx skills add deusyu/translate-book -a codex -g' to install automatically, or manually clone the repository to ~/.agents/skills/translate-book and restart Codex. Once installed, use the $translate-book command or ask Codex to translate a book naturally.

Which AI clients work with translate-book?+

The skill currently works with Codex, Claude Code, and OpenClaw. Each client uses a different installation directory and invocation method, but all support the same full-pipeline translation workflow.

What prerequisites are needed to run translate-book?+

You need Calibre (with ebook-convert command), Pandoc, Python 3, and the pypandoc package installed. BeautifulSoup4 is optional but recommended for improved table-of-contents generation. No API keys are required beyond your agent runtime's existing configuration.

Is translate-book free to use?+

Yes, translate-book is open-source under the MIT license and free to use. Translation costs depend on your agent runtime's underlying API usage (e.g., Claude API tokens), which are billed separately by your provider.

Can I resume a translation if it gets interrupted?+

Yes, translate-book automatically resumes from where it stopped by checking which chunks already have valid output files. It also supports selective re-translation when you edit glossary entries, only reprocessing affected chunks instead of the entire book.

How do I install translate-book?+

Open the source repository on GitHub and follow its README. translate-book is a skill — MCP Agents Market links you directly to the official repo.

Is translate-book free?+

translate-book is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.

Related searches