translate-book

A skill that translates whole books in PDF, DOCX and EPUB into any language using parallel subagents

Skill

Medium risk

We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.

Why this level

  • Runs conversion scripts and reads files on disk
  • Consumes tokens across parallel subagents
All reasons and checks

deusyu/translate-book

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/translate-book

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

Run in a terminal in the project folder

npx skills add deusyu/translate-book --skill translate-book -a claude-code -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add deusyu/translate-book --skill translate-book -a cursor -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add deusyu/translate-book --skill translate-book -a github-copilot -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add deusyu/translate-book --skill translate-book -a codex -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add deusyu/translate-book --skill translate-book -a gemini-cli -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add deusyu/translate-book --skill translate-book -a cline -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add deusyu/translate-book --skill translate-book -a roo -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

A fork of Roo Code, same .roo folders.

Run in a terminal in the project folder

npx skills add deusyu/translate-book --skill translate-book -a opencode -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

You will need: Node.js

Checked against the repository on Sep 25, 2026, commit bd5424b.

Text for your agent

Install the skill via the skills CLI: npx skills add deusyu/translate-book -a claude-code -g. Make sure Calibre (ebook-convert), Python, pandoc and the pypandoc pip package are installed.

Other ways from the author
npx skills add deusyu/translate-book -a claude-code -g

Needs Calibre (ebook-convert), Python, pandoc and the pypandoc pip package.

This is third-party code. Review the repository files before installing.

What it does

The skill translates whole books: it parses the source file into markdown, splits it into chunks, translates them with parallel subagents and reassembles the result into HTML, DOCX, EPUB or PDF. It builds a glossary of terms and names to keep the translation consistent across the book, and can resume an interrupted run. It works in Codex, Claude Code and OpenClaw, with Calibre handling format conversion and Python helper scripts.

Who it is for. For translators, editors and readers who need a draft translation of a whole book.

Good fit when

  • You need to translate a PDF, DOCX or EPUB book into another language
  • You need a consistent glossary across the whole text
  • You need to resume an interrupted translation of large files

Not a fit when

  • You need a certified professional translation without human review
  • You have no Calibre and Python for the scripts

Example request

Translate this EPUB book into English and build a single glossary of names

Limitations

It needs Calibre with ebook-convert, Python and pandoc, plus beautifulsoup4 for a better table of contents. The output is a machine translation that deserves review. Token usage on long books is significant because of parallel subagents.

How to disable. Remove the translate-book folder from your agent's skills directory, for example ~/.claude/skills/translate-book or ~/.agents/skills/translate-book.

Security check

  • Runs conversion scripts and reads files on disk
  • Consumes tokens across parallel subagents

README in short

The README describes an agent skill for translating books in Codex, Claude Code and OpenClaw. The pipeline takes the source file through markdown chunks to translated chunks and reassembles HTML, DOCX, EPUB and PDF outputs. Install via npx skills add or by cloning into a skills directory. It needs Calibre, Python and pandoc, and its scripts merge metadata and maintain a term glossary. MIT licensed.

SKILL.md

---
name: 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.
allowed-tools: Read, Write, Edit, Bash, Glob, Grep, Agent, AskUserQuestion
---

# Book Translation Skill

You are a book translation assistant. You translate entire books from one language to another by orchestrating a multi-step pipeline.

## Workflow

### 1. Collect Parameters

Determine the following from the user's message:
- file_path: Path to the input file (PDF, DOCX, or EPUB) - REQUIRED
- target_lang: Target language code (default: zh)
- concurrency: Number of parallel sub-agents per batch (default: 8)

### 2. Preprocess - Convert to Markdown Chunks

Run the conversion script to produce chunks.

FAQ

What else do I install?

Calibre with ebook-convert, Python, pandoc and the pypandoc pip package, optionally beautifulsoup4.

Can I resume a run?

Yes, the skill keeps intermediate chunks and metadata and can continue the translation.

Official

Microsoft's utility and MCP server that turn PDF, Word, Excel, PowerPoint, HTML and other files into Markdown for models

MCP serverMedium risk187.4KRepository stars
Editors’ pick

Anthropic's official skill examples: docx, pdf, pptx and xlsx documents, design, MCP builder and the Agent Skills spec

SkillMedium risk178.8KRepository stars
Editors’ pick

A skill that builds editable PPTX decks from PDF, DOCX, URLs and Markdown with native shapes, charts and animations

SkillMedium risk56.8KRepository stars
Editors’ pick

A skill that draws editorial diagrams as standalone HTML and SVG files: architecture, flowcharts, ER, funnels and about forty more types

SkillMedium risk42.6KRepository stars
Foxx AItranslate-book

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.