translate-book

Translate long-form PDF, DOCX, and EPUB books through a four-stage Codex-plus-local-model workflow.

8|3|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/wastemobile/translate-book-codex-skill --skill translate-book-wastemobile
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: translate-book
Source: https://github.com/wastemobile/translate-book-codex-skill/tree/main
Command: npx skills add https://github.com/wastemobile/translate-book-codex-skill --skill translate-book-wastemobile

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pypandoc, beautifulsoup4, markdown, opencc-python-reimplemented, and includes scripts (resource) components.

What problem does it solve?

This skill enables end-to-end translation of long-form books (PDF, DOCX, EPUB) while preserving the upstream conversion, packaging, and style anchors, reducing manual overhead and enabling resumable long-running workflows.

Core Features & Use Cases

  • Four-stage translation pipeline: convert -> sample -> draft -> refine -> audit -> merge/build, with Codex guiding the front controller and local models handling drafting and refinement.
  • Single entrypoint with automatic preflight and format packaging into HTML, DOCX, EPUB, and PDF via Pandoc and Calibre.
  • Open-source glossary integration (NAER) and genre-aware style prompts for fiction and nonfiction, plus zh-TW regional lexicon support during audit.

Quick Start

Run the provided entrypoint to translate a book end-to-end using preflight, convert, draft, refine, audit, and merge steps.

Frequently Asked Questions about translate-book

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

FAQPage Schema
How do I automate long book translation while preserving original formatting?

Automating long book translation while preserving formatting is achieved through a four-stage pipeline: convert, draft, refine, and merge. This workflow uses Codex and local models to process PDF, DOCX, and EPUB inputs while maintaining style anchors.

Can I use local models for drafting and refining translated book drafts?

Yes, local models handle the drafting and refinement stages of the translation workflow. Codex acts as the front controller guiding the process, while local models execute the actual text generation and refinement for long-form books.

What is the best way to translate a PDF book end-to-end and export it to multiple formats?

The best way to translate a PDF book end-to-end is using an automated pipeline that coordinates conversion, drafting, and refinement. It packages translated outputs into HTML, DOCX, EPUB, and PDF formats via Pandoc and Calibre.

Does the book translation workflow support Traditional Chinese regional lexicon adjustments?

The book translation workflow supports Traditional Chinese regional lexicon adjustments during the audit stage. It integrates open-source glossaries like NAER and applies zh-TW regional lexicon support to ensure accurate localized outputs.

Do I need Pandoc and Calibre installed to package translated books into EPUB and PDF?

Yes, Pandoc and Calibre are required to package translated books into EPUB and PDF formats. These dependencies handle format conversion and packaging during the final merge and build stages of the translation workflow.