translate-book

Translates PDF, DOCX, and EPUB books into other languages using parallel sub-agents.

2|3|Updated Mar 13, 2026
One-click install
npx skills add https://github.com/spideynolove/claude-dotfiles --skill translate-book-spideynolove
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: translate-book
Source: https://github.com/spideynolove/claude-dotfiles/tree/main/.claude-global-backup/skills/translate-book
Command: npx skills add https://github.com/spideynolove/claude-dotfiles --skill translate-book-spideynolove

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, pandoc, ebook-convert, and includes scripts (resource) components.

What problem does it solve? Translating an entire book manually is slow and error-prone, and feeding a whole book into a single AI context causes truncation and quality loss. This Skill automates full-book translation by splitting the source into chunks and translating them with parallel sub-agents. ## Core Features & Use Cases - Multi-format pipeline: Converts PDF, DOCX, or EPUB input into Markdown chunks, then rebuilds translated output as HTML, DOCX, EPUB, and PDF. - Parallel sub-agent translation: Assigns one chunk per sub-agent with configurable concurrency (default 8) to avoid context overflow and output truncation. - Resumable and verifiable: Tracks progress via a manifest, detects missing or empty output chunks, and retries failed chunks automatically. - Use Case: Translate an English EPUB novel into Chinese by pointing the Skill at the file; it chunks the book, translates each chunk in parallel, and produces a finished EPUB and PDF with the translated title. ## Quick Start Translate the book at /path/to/book.epub into Chinese and generate the translated EPUB and PDF files.

Frequently Asked Questions about translate-book

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I translate an entire book with AI without losing context?

Split the book into Markdown chunks and translate each chunk with an independent sub-agent so no single context accumulates the whole text. This Skill automates that pipeline, launching chunks in batches with configurable concurrency and merging results afterward.

What file formats can I translate with this book translation skill?

Input supports PDF, DOCX, and EPUB files, which are converted to Markdown chunks before translation. Output can be generated as HTML, DOCX, EPUB, and PDF, with ebook formats requiring Calibre's ebook-convert.

Does book translation preserve images and Markdown formatting?

Yes, the translation prompt requires sub-agents to keep all Markdown syntax, heading structure, and image references intact. Image file paths like media/image-001.png are preserved while alt text may be translated.

What dependencies are required to translate books to EPUB or PDF?

The pipeline requires python3 and pandoc for conversion to Markdown chunks, plus ebook-convert from Calibre for generating DOCX, EPUB, and PDF outputs. HTML output is produced without Calibre.

What happens if some chunks fail during parallel translation?

After all batches finish, the Skill checks that every source chunk has a non-empty output file using the manifest. Missing chunks are retried once as individual sub-agents, and any chunks still failing are reported to the user.