Translate Pdf

This does exactly what it says: pulls text from a PDF, lets you provide translations in a JSON file, then rebuilds the PDF with your translated text while keeping the original colors, backgrounds, and layout intact. The two-script workflow is straightforward. You extract strings, translate them however you want, then apply them back. It supports the usual suspects for fonts: Latin scripts, simplified and traditional Chinese, Japanese, and Korean. The output preserves styling better than most translation tools that just give you plain text or reformatted documents. Good for when you need a translated PDF that actually looks like the original instead of a mess.

install copies · 90 days. Times the install command was copied on this site in the last 90 days, bots filtered.: 6
skills.sh installs: 1.2K
GitHub stars: 24
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add wshuyi/translate-pdf-skill --skill translate-pdf --agent claude-code

Installs into .claude/skills of the current project.

Files

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

SKILL.md on GitHub

Details

Repository: github.com/wshuyi/translate-pdf-skill
Categories: Frontend Development, Release Management, Office & Documents
First seen: Apr 16, 2026