Translate Book
deusyu/translate-book
Translate books (PDF/DOCX/EPUB) into any language using parallel sub-agents.
Translate scientific PDFs with preserved math formatting via PDFMathTranslate
Install PDF Math Translate Guide
$ npx skills add wentorai/research-plugins --skill pdf-math-translate-guide -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install wentorai/research-plugins pdf-math-translate-guide --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/wentorai/research-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/tools/ocr-translate/pdf-math-translate-guide .claude/skills/pdf-math-translate-guide && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "pdf-math-translate-guide" agent skill from https://github.com/wentorai/research-plugins/tree/main/skills/tools/ocr-translate/pdf-math-translate-guide into .claude/skills/pdf-math-translate-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pdf-math-translate-guide", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/wentorai/research-plugins/tree/main/skills/tools/ocr-translate/pdf-math-translate-guideType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add wentorai/research-plugins --skill pdf-math-translate-guide -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install wentorai/research-plugins pdf-math-translate-guide --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/wentorai/research-plugins.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/tools/ocr-translate/pdf-math-translate-guide .agents/skills/pdf-math-translate-guide && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "pdf-math-translate-guide" agent skill from https://github.com/wentorai/research-plugins/tree/main/skills/tools/ocr-translate/pdf-math-translate-guide into .agents/skills/pdf-math-translate-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pdf-math-translate-guide", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add wentorai/research-plugins --skill pdf-math-translate-guide -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install wentorai/research-plugins pdf-math-translate-guide --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/wentorai/research-plugins.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/tools/ocr-translate/pdf-math-translate-guide .cursor/skills/pdf-math-translate-guide && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "pdf-math-translate-guide" agent skill from https://github.com/wentorai/research-plugins/tree/main/skills/tools/ocr-translate/pdf-math-translate-guide into .cursor/skills/pdf-math-translate-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pdf-math-translate-guide", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/wentorai/research-plugins.git --path skills/tools/ocr-translate/pdf-math-translate-guide--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add wentorai/research-plugins --skill pdf-math-translate-guide -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install wentorai/research-plugins pdf-math-translate-guide --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/wentorai/research-plugins.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/tools/ocr-translate/pdf-math-translate-guide .gemini/skills/pdf-math-translate-guide && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "pdf-math-translate-guide" agent skill from https://github.com/wentorai/research-plugins/tree/main/skills/tools/ocr-translate/pdf-math-translate-guide into .gemini/skills/pdf-math-translate-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pdf-math-translate-guide", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install wentorai/research-plugins pdf-math-translate-guideInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add wentorai/research-plugins --skill pdf-math-translate-guide -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/wentorai/research-plugins.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/tools/ocr-translate/pdf-math-translate-guide .github/skills/pdf-math-translate-guide && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "pdf-math-translate-guide" agent skill from https://github.com/wentorai/research-plugins/tree/main/skills/tools/ocr-translate/pdf-math-translate-guide into .github/skills/pdf-math-translate-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pdf-math-translate-guide", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add wentorai/research-plugins --skill pdf-math-translate-guide -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install wentorai/research-plugins pdf-math-translate-guide --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/wentorai/research-plugins.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/tools/ocr-translate/pdf-math-translate-guide .opencode/skills/pdf-math-translate-guide && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "pdf-math-translate-guide" agent skill from https://github.com/wentorai/research-plugins/tree/main/skills/tools/ocr-translate/pdf-math-translate-guide into .opencode/skills/pdf-math-translate-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pdf-math-translate-guide", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
pdf-math-translate-guide- GitHub stars
- 298
- Used in
- 1 other repo
- Token cost
- ~1.5k tokens
- SKILL.md length
- 530 words
- Files
- 1
- Skills in repo
- 405
- Repo updated
- First seen
- Licence
- MIT
At a glance
Translate scientific PDFs with preserved math formatting via PDFMathTranslate
- Tasks that involve Translation
- SKILL.md covers Overview, Installation and Setup, Core Features and Research Workflow Integration, plus 2 more sections
- Calls pip; needs OPENAI_API_KEY and DEEPL_AUTH_KEY
- Tasks that involve PDF
What it does
PDF Math Translate Guide is an agent skill from wentorai/research-plugins. Translate scientific PDFs with preserved math formatting via PDFMathTranslate
Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Documents & Office, covering Translation and PDF. The repository describes itself as: 350+ academic research skills, MCP configs, and plugins for Research-Claw and AI agents. The licence is MIT.
When your agent uses it
- Tasks that involve Translation
- Tasks that involve PDF
Example prompts
- “/pdf-math-translate-guide”
Requirements
- Python 3
- A credential in OPENAI_API_KEY
- A credential in DEEPL_AUTH_KEY
What it can do on your machine
Read from SKILL.md and the folder at commit bf44b3c. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
pip
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
github.compypi.org
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
OPENAI_API_KEYDEEPL_AUTH_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
PDF Math Translate Guide loads about 1.5k tokens when it runs. Until then it costs about 26 tokens; SKILL.md has 530 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from wentorai/research-plugins at commit bf44b3c, republished under its MIT licence (© wentorai). 530 words, ~1,476 tokens.
Download SKILL.mdSave it as
.claude/skills/pdf-math-translate-guide/SKILL.md (or your agent's skills folder).- name
- pdf-math-translate-guide
- description
- Translate scientific PDFs with preserved math formatting via PDFMathTranslate
PDFMathTranslate Guide
Overview
PDFMathTranslate is an open-source tool designed specifically for translating scientific and technical PDF documents while preserving mathematical formulas, tables, figures, and the overall layout structure. Traditional PDF translators often mangle equations and destroy formatting, making translated papers difficult to read. PDFMathTranslate solves this problem by intelligently detecting and preserving mathematical content during the translation process.
The tool leverages large language models for high-quality translation while maintaining the integrity of LaTeX-rendered equations, chemical formulas, and complex table structures commonly found in academic publications. It supports translation between dozens of language pairs, making it invaluable for researchers who need to read papers published in languages outside their expertise.
PDFMathTranslate has gained significant traction in the academic community with over 32,000 GitHub stars, reflecting the widespread need for reliable scientific document translation that respects the specialized formatting requirements of research papers.
Installation and Setup
Install PDFMathTranslate using pip in a Python environment (Python 3.8 or higher required):
pip install pdf2zhFor GPU-accelerated processing, install with CUDA support:
pip install pdf2zh[cuda]Configure your translation backend by setting the appropriate environment variable. The tool supports multiple LLM providers:
# Using OpenAI-compatible APIs
export OPENAI_API_KEY=$OPENAI_API_KEY
export OPENAI_BASE_URL=$OPENAI_BASE_URL
# Using Google Translate (free, no key required)
pdf2zh input.pdf -s google
# Using DeepL
export DEEPL_AUTH_KEY=$DEEPL_AUTH_KEY
pdf2zh input.pdf -s deeplYou can also launch the web-based GUI for interactive use:
pdf2zh -gThis starts a Gradio interface where you can upload PDFs and configure translation settings through a browser.
Core Features
PDFMathTranslate provides several capabilities critical for academic workflows:
Formula Preservation: The tool detects and preserves inline and display math environments. Equations rendered in LaTeX, MathML, or image-based formats are identified and left untouched during translation, ensuring mathematical accuracy is maintained.
Layout Retention: The translated output maintains the original page layout including headers, footers, figure positions, table structures, and column formatting. This produces a readable document that mirrors the source paper structure.
Batch Processing: Translate multiple papers at once using wildcard patterns or directory inputs:
# Translate all PDFs in a directory
pdf2zh ./papers/*.pdf -lo zh -li en
# Specify output directory
pdf2zh input.pdf -o ./translated/Dual-Document Output: Each translation generates two files: a fully translated version and a side-by-side bilingual version where original and translated text appear together, useful for verifying translation quality.
Selective Translation: Target specific page ranges to avoid translating references, appendices, or supplementary material:
# Translate only pages 1 through 15
pdf2zh input.pdf -p 1-15Show full SKILL.md (195 more words)Show less
Research Workflow Integration
PDFMathTranslate fits naturally into several academic research scenarios:
Literature Review Acceleration: When conducting systematic reviews across multilingual sources, batch-translate candidate papers to quickly assess relevance before investing time in detailed reading. The preserved formatting means figures and data tables remain interpretable.
Collaboration Across Languages: Research teams spanning multiple countries can share translated versions of key papers while maintaining the mathematical rigor of the original. The bilingual output mode is particularly useful for group discussions where team members have different language proficiencies.
Conference Preparation: When presenting at international conferences, translate your own papers or related works to prepare for questions and discussions in the host language.
Integration with Reference Managers: Combine with Zotero or Mendeley workflows by translating downloaded papers and storing both versions in your reference library:
# Example workflow with a Zotero storage directory
for pdf in ~/Zotero/storage/*/*.pdf; do
pdf2zh "$pdf" -lo zh -li en -o ~/translated_papers/
doneQuality Verification: Always use the bilingual output mode when translation accuracy is critical. Cross-reference translated equations with the original to catch any edge cases where formula detection may have been imprecise.
Configuration and Customization
Fine-tune translation behavior through configuration options:
# Use a specific model for translation
pdf2zh input.pdf -s openai -m gpt-4o
# Set custom font for translated text
pdf2zh input.pdf --font "Noto Sans CJK SC"
# Adjust thread count for parallel processing
pdf2zh input.pdf -t 4For programmatic use, PDFMathTranslate can be integrated into Python scripts:
from pdf2zh import translate
# Basic translation
translate.translate(
files=["paper.pdf"],
lang_out="zh",
lang_in="en",
service="google"
)References
- PDFMathTranslate repository: https://github.com/Byaidu/PDFMathTranslate
- PyPI package: https://pypi.org/project/pdf2zh/
- Supported translation services documentation in the project wiki
© wentorai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/tools/ocr-translate/pdf-math-translate-guide of wentorai/research-plugins.
Open the folder on GitHubat commit bf44b3c
Used in 1 other repository
We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in wentorai/research-plugins, which our catalogue first saw on October 7, 2026.
Compare with similar skills
PDF Math Translate Guide next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| PDF Math Translate Guide this skillwentorai/research-plugins | 298 | 1 repos | ~1.5k | Automated safety check: Pass | MIT | |
| Translate Bookdeusyu/translate-book | 2.1k | — | ~5.5k | Automated safety check: Notes | MIT | |
| PDF Translatebreslee1707/VI-Translate | 676 | — | ~2k | Automated safety check: Pass | AGPL-3.0-only | |
| PDF Translatelxsssssss/pdf-translate | 102 | — | ~1.6k | Automated safety check: Pass | MIT | |
| Print Compatible Book LayoutSaberOnGo/public-domain-books-translation | 267 | — | ~4.1k | Automated safety check: Pass | None | |
| PDF Translatebreslee1707/VI-Translate | 676 | — | ~269 | Automated safety check: Pass | AGPL-3.0 |
Similar skills
PDF Translate
breslee1707/VI-Translate
Translate local PDFs, including safe prose on image-only scans, into Vietnamese or another supported Latin-script language while preserving layout, formulas, tables, and figures.
PDF Translate
lxsssssss/pdf-translate
A skill your agent uses when translating PDF documents between languages while strictly preserving original layout, formatting, typography, tables, and signatures.
Print Compatible Book Layout
SaberOnGo/public-domain-books-translation
A skill your agent uses when designing, translating, reviewing, or fixing LifeBook book/page layout, including print-compatible EPUB typography, Chinese title hierarchy, body rhythm, paragraph…
PDF Translate
breslee1707/VI-Translate
Translate or diagnose local text-based PDFs in this repository while preserving layout, formulas, tables, figures, styles, rotation, and technical glyphs.
PDF To HTML
daymade/claude-code-skills
Converts a PDF into one self-contained, readable HTML file that preserves images, tables, charts and reading order — optionally translating it into another language while keeping every figure.
More from wentorai/research-plugins
All 405 skills in this repoAbstract Writing Guide
wentorai/research-plugins
Craft structured research abstracts that maximize clarity and journal acceptance
Academic Citation Manager
wentorai/research-plugins
Manage academic citations across BibTeX, APA, MLA, and Chicago formats
Academic Paper Summarizer
wentorai/research-plugins
Summarize academic papers with structured extraction of key elements
Academic Study Methods
wentorai/research-plugins
Evidence-based study techniques for academic learning and retention
Academic Tone Guide
wentorai/research-plugins
Adjust writing tone and register for academic audiences and venues
Academic Translation Guide
wentorai/research-plugins
Academic translation, post-editing, and Chinglish correction guide
Related
Categories
Questions about PDF Math Translate Guide
What does PDF Math Translate Guide do?
Translate scientific PDFs with preserved math formatting via PDFMathTranslate. PDF Math Translate Guide is an agent skill from wentorai/research-plugins.
When should I use PDF Math Translate Guide?
PDF Math Translate Guide fits situations like: tasks that involve Translation; tasks that involve PDF.
How do I install PDF Math Translate Guide in Claude Code?
Run `npx skills add wentorai/research-plugins --skill pdf-math-translate-guide -a claude-code`. Or copy the skill folder (skills/tools/ocr-translate/pdf-math-translate-guide in wentorai/research-plugins) into .claude/skills/pdf-math-translate-guide in your project. Claude Code loads it when a task matches its description.
How do I install PDF Math Translate Guide in Codex?
Run `npx skills add wentorai/research-plugins --skill pdf-math-translate-guide -a codex`. Or copy the skill folder (skills/tools/ocr-translate/pdf-math-translate-guide in wentorai/research-plugins) into .agents/skills/pdf-math-translate-guide in your project. Codex loads it when a task matches its description.
Can I use PDF Math Translate Guide in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add wentorai/research-plugins --skill pdf-math-translate-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pdf-math-translate-guide, .gemini/skills/pdf-math-translate-guide, .github/skills/pdf-math-translate-guide and .opencode/skills/pdf-math-translate-guide in your project.
What does PDF Math Translate Guide need to run?
Going by SKILL.md and its folder, PDF Math Translate Guide needs the command-line tools its instructions call (pip) and credentials named OPENAI_API_KEY and DEEPL_AUTH_KEY. Our summary lists: Python 3; A credential in OPENAI_API_KEY; A credential in DEEPL_AUTH_KEY.
Does PDF Math Translate Guide access the network?
SKILL.md names 2 domains. As links in the text: github.com and pypi.org. This is read from the text; nothing was executed.
Is PDF Math Translate Guide safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does PDF Math Translate Guide use?
PDF Math Translate Guide is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does PDF Math Translate Guide use?
About 1.5k tokens (SKILL.md is roughly 5.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to PDF Math Translate Guide?
Skills that share tags, products or a category with PDF Math Translate Guide: Translate Book (deusyu/translate-book, 2.1k stars), PDF Translate (breslee1707/VI-Translate, 676 stars), PDF Translate (lxsssssss/pdf-translate, 102 stars) and Print Compatible Book Layout (SaberOnGo/public-domain-books-translation, 267 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains PDF Math Translate Guide?
wentorai (a GitHub user) maintains it in wentorai/research-plugins, which has 298 GitHub stars. The repository holds 405 skills in this directory. The repository was last updated on June 19, 2026.
Source: wentorai/research-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.