# PDF Translate

> Translate or diagnose local text-based PDFs in this repository while preserving layout, formulas, tables, figures, styles, rotation, and technical glyphs. Use for PDF translation, incomplete output, visual regressions, or preservation fixes; not for OCR-only scans or complex-script targets.

- Skill: `breslee1707/pdf-translate-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add breslee1707/pdf-translate-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/breslee1707/pdf-translate-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: breslee1707 (https://skillmd.com/u/breslee1707)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/breslee1707/pdf-translate-2

---


# PDF Translate Project Skill

This is the Claude Code adapter for the canonical cross-agent skill.

Before acting:

1. Read `../../../SKILL.md` completely and follow its workflow and boundaries.
2. Read `../../../agent-knowledge/index.md`, then its routed PDF engine,
   regression, and validation files relevant to the request.
3. Resolve commands from the repository root containing `pdf2zh/` and
   `scripts/translate_pdf.py`, not from this adapter directory.

On macOS use `.venv/bin/python` and `bash build-macos.sh`; on Windows use
`.venv\Scripts\python.exe` and `build.ps1`. The preservation behavior and tests
are shared across platforms. Keep the source unchanged, validate rendered
output, and report partial fallbacks honestly.