Translate Book AI Skill for Openclaw

A sophisticated multi-agent pipeline that translates entire books across multiple formats while maintaining term consistency through automated glossary management.

deusyu
v1.0.0
Apr 28, 2026
0
1.2k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install translate-book

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install translate-book using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Translate Book AI Skill?

The translate-book skill is a professional-grade document localization tool designed for the Openclaw Skills ecosystem. It orchestrates a complex workflow that converts complex document formats like PDF, EPUB, and DOCX into Markdown chunks for processing. By leveraging parallel sub-agents, it bypasses context window limitations and significantly accelerates the translation of full-length books.

At its core, this skill prioritizes consistency and formatting. It uses a specialized glossary system to ensure that proper nouns, technical terms, and character names remain uniform throughout the entire text. It is ideal for developers and researchers who need to localize technical literature or long-form content without losing the original layout or structural integrity.

Translate Book AI Skill Use Cases

  • Translating technical PDF whitepapers into multiple languages while preserving complex Markdown tables and image references.
  • Localizing EPUB novels using a consistent glossary to ensure character names do not drift across chapters.
  • Converting business DOCX reports into high-quality localized versions for international stakeholders.
  • High-speed batch translation of document libraries using parallel LLM sub-agents.

How Translate Book AI Skill Works

  1. The skill identifies the source file path and target language parameters provided by the user.
  2. It preprocesses the input file by converting it into a series of smaller Markdown chunks and generating a manifest for tracking.
  3. A glossary is automatically built by sampling key sections of the book to identify proper nouns and recurring domain-specific terms.
  4. Parallel sub-agents are spawned, each responsible for translating a single chunk using the established glossary and specific translation rules.
  5. Translation metadata, such as newly discovered entities or alias hypotheses, is merged back into the main glossary after each batch.
  6. The skill verifies the completeness of all chunks and performs retries if any translations are missing or malformed.
  7. Finally, it merges the translated chunks and utilizes tools like Pandoc and Calibre to generate the final book in PDF, EPUB, or DOCX formats.

Translate Book AI Skill Setup

To utilize this skill within the Openclaw Skills framework, ensure your environment has the necessary binaries installed for document conversion and processing:

# Install Python 3 and document conversion tools
sudo apt-get install python3 pandoc calibre

# Ensure ebook-convert is available in your PATH for EPUB and PDF generation
ebook-convert --version

The skill relies on internal scripts located in the base directory to handle the parallel orchestration and glossary merging logic.

Translate Book AI Skill Data Schema & Taxonomy

The skill organizes its workflow within a temporary directory named {filename}_temp/ using the following structure:

File Type Description
chunk*.md The original source text broken into manageable segments.
output_chunk*.md The individual translated segments produced by sub-agents.
glossary.json A structured V2 schema file containing terms, categories, and translation mappings.
manifest.json A tracking file used to validate the integrity and completion status of the pipeline.
config.txt Stores book metadata including the original title and target language settings.
output.md The final merged Markdown file before conversion to binary formats.

Translate Book AI Skill Advanced Features

  • Parallel Batching: Supports configurable concurrency to optimize translation speed while respecting API rate limits.
  • Automated Glossary V2: Features term frequency counting and alias-to-source mapping to prevent entity drift.
  • Intelligent Meta-Merging: A transactional decision-making system allows the agent to refine translations based on sub-agent feedback.
  • Format Versatility: Built-in support for generating web-ready HTML with floating TOCs, alongside standard ebook formats.
  • Robust Error Handling: Includes a verification layer that checks for 0-byte files and automates retries for failed chunks.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins python3pandocebook-convert
Github Stars: 0
forks: 0

Featured*