translate-pdf
Translate PDF documents to any language while preserving original structure, layout, and styling (colors, backgrounds, positions). Use when user wants to: (1) translate a PDF to another language, (2) convert PDF from one language to another, (3) create translated version of PDF document. Triggers: "translate PDF", "PDF翻译", "把PDF翻译成", "translate this PDF to Chinese/English/Japanese", "翻译成中文/英文"
How do I install this agent skill?
npx skills add https://github.com/wshuyi/translate-pdf-skill --skill translate-pdfIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a safe utility for translating PDF documents by extracting text and re-inserting translated strings. It uses the reputable pymupdf library for all operations and runs locally without network access. No malicious patterns or security risks were identified during the analysis.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
3/3 files flagged
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
PDF Translation
Translate PDF text while preserving structure, colors, and background styling.
Workflow
Step 1: Extract texts
python {skill_path}/scripts/extract_texts.py <input.pdf>
Review output to see all unique text strings in the PDF.
Step 2: Create translation mapping
Translate each text to target language. Create JSON file:
{
"Original Text 1": "Translated 1",
"Original Text 2": "Translated 2"
}
Save as translations.json next to input PDF.
Step 3: Apply translations
python {skill_path}/scripts/translate_pdf.py <input.pdf> translations.json <output.pdf> --font <fontname>
Font options:
| Font | Language |
|---|---|
helv | Latin (English, Spanish, Portuguese, French, German, etc.) |
china-ss | Simplified Chinese |
china-ts | Traditional Chinese |
japan | Japanese |
korea | Korean |
Output naming
Append language suffix: filename_EN.pdf, filename_ZH.pdf, filename_JA.pdf
Tips
- Keep proper nouns, abbreviations, technical terms unchanged when appropriate
- CJK fonts auto-scale to 90% for better fit
- Use transparent fill to preserve original background colors
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/wshuyi/translate-pdf-skill/translate-pdf">View translate-pdf on skillZs</a>