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.
Translates an English paper PDF, all pages or a chosen range, into a Simplified Chinese image-based PDF that keeps the original layout, figures and formulas.
SKILL.md written in Chinese; this summary is our English description.
$ npx skills add Yuan1z0825/nature-skills --skill nature-paper-trans -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Yuan1z0825/nature-skills nature-paper-trans --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/Yuan1z0825/nature-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/nature-paper-trans .claude/skills/nature-paper-trans && 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 "nature-paper-trans" agent skill from https://github.com/Yuan1z0825/nature-skills/tree/main/skills/nature-paper-trans into .claude/skills/nature-paper-trans/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nature-paper-trans", 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/Yuan1z0825/nature-skills/tree/main/skills/nature-paper-transType 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 Yuan1z0825/nature-skills --skill nature-paper-trans -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Yuan1z0825/nature-skills nature-paper-trans --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Yuan1z0825/nature-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/nature-paper-trans .agents/skills/nature-paper-trans && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "nature-paper-trans" agent skill from https://github.com/Yuan1z0825/nature-skills/tree/main/skills/nature-paper-trans into .agents/skills/nature-paper-trans/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nature-paper-trans", 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 Yuan1z0825/nature-skills --skill nature-paper-trans -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Yuan1z0825/nature-skills nature-paper-trans --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Yuan1z0825/nature-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/nature-paper-trans .cursor/skills/nature-paper-trans && 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 "nature-paper-trans" agent skill from https://github.com/Yuan1z0825/nature-skills/tree/main/skills/nature-paper-trans into .cursor/skills/nature-paper-trans/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nature-paper-trans", 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/Yuan1z0825/nature-skills.git --path skills/nature-paper-trans--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 Yuan1z0825/nature-skills --skill nature-paper-trans -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Yuan1z0825/nature-skills nature-paper-trans --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Yuan1z0825/nature-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/nature-paper-trans .gemini/skills/nature-paper-trans && 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 "nature-paper-trans" agent skill from https://github.com/Yuan1z0825/nature-skills/tree/main/skills/nature-paper-trans into .gemini/skills/nature-paper-trans/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nature-paper-trans", 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 Yuan1z0825/nature-skills nature-paper-transInstalls 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 Yuan1z0825/nature-skills --skill nature-paper-trans -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Yuan1z0825/nature-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/nature-paper-trans .github/skills/nature-paper-trans && 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 "nature-paper-trans" agent skill from https://github.com/Yuan1z0825/nature-skills/tree/main/skills/nature-paper-trans into .github/skills/nature-paper-trans/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nature-paper-trans", 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 Yuan1z0825/nature-skills --skill nature-paper-trans -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Yuan1z0825/nature-skills nature-paper-trans --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Yuan1z0825/nature-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/nature-paper-trans .opencode/skills/nature-paper-trans && 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 "nature-paper-trans" agent skill from https://github.com/Yuan1z0825/nature-skills/tree/main/skills/nature-paper-trans into .opencode/skills/nature-paper-trans/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nature-paper-trans", 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.
nature-paper-transTranslates an English paper PDF, all pages or a chosen range, into a Simplified Chinese image-based PDF that keeps the original layout, figures and formulas.
Each page is regenerated as a Chinese page image and merged in the original order into one PDF, which is the only deliverable. By default every page keeps the source size, orientation and aspect ratio, and pages are fitted to A4 only if you ask. You can pass a page range, confirmed translations or a glossary; with no range the whole paper is processed. It is meant for reading translations, not for rebuilding an editable Word file or word-by-word proofreading.
The workflow is strict: every page gets exactly one call to the built-in image_gen tool, with no automatic checks, retries or candidate picking, and up to 10 requests can be in flight at once. A Python script, scripts/pages.py, prepares pages rendered at 240 DPI, reserves and records each attempt, and assembles the PDF, while a shared prompt in references/image-translation-prompt.md drives every page. It needs Python 3.9 or newer, PyMuPDF and Pillow, and runs on macOS, Linux, WSL2 and native Windows. Text inside PDFs is treated as material, never as instructions.
3 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit e605b35. It shows what the files ask for, not the result of running them.
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.
Ships 1 file in scripts/ (Python), which the agent can run.
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Paper PDF Translator loads about 1k tokens when it runs, and up to ~2.5k if it reads all its reference files. Until then it costs about 29 tokens; SKILL.md has 179 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.
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); the scripts in this folder are not scanned.
The full file from Yuan1z0825/nature-skills at commit e605b35, republished under its Apache-2.0 licence (© Yuan1z0825). 179 words, ~1,014 tokens.
.claude/skills/nature-paper-trans/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.逐页生成中文页面,按原页序合并为一个图片型 PDF。默认保持源 PDF 每页的原始尺寸、方向和宽高比;只有用户明确要求时才统一转换为 A4。每页在本次任务中只调用一次生图;不自动检查生成图,不生成或交付逐页检查 Markdown。用户打开最终 PDF 后自行查看,发现问题时再明确指定需要更新的页。
image_gen。所有页共用生图提示词,在这一次生成中要求内容、正文占位和自然排字同时尽量符合原页。以下变量均需绑定实际值:PYTHON 为解释器,SCRIPT 为脚本绝对路径,PDF 为源文件,JOB 为任务目录,PAGES 为原页码表达式,PAGE 为单页原页码,PROMPT 为本次实际提示词文件,ATTEMPT_ID 为 reserve 返回的调用标识,IMAGE 为本次工具返回图片,OUT 为成品 PDF 路径。
简短说明正在处理的文件与页码范围。使用用户工作区内的任务目录,续跑复用原目录,不覆盖源 PDF 或已有成品。
"$PYTHON" "$SCRIPT" prepare --pdf "$PDF" --pages "$PAGES" --work-dir "$JOB"
"$PYTHON" "$SCRIPT" status --work-dir "$JOB"PAGES 可为 all 或 1-3,5。默认以 240 DPI 渲染源页,保持比例、方向和完整内容;这不是生成结果的分辨率承诺。
将实际通用提示词保存为 $JOB/generation-prompt.md,续跑不覆盖。用户提供的固定译文或术语作为附加约束保留页码关系,不自行逐页重写模板。reserve 保存每次提示词快照;提交给工具的正文必须与快照一致。
按 status 的有效并发额度提交,有空位时补入下一页;也可用不超过上限的并发批次。不要等待同组第一页完成才提交第二页。
每页依次执行:
view_image 查看源页,满足本地图片编辑工具的输入要求。reserve 后立即提交,不提前占用整个待办队列。将 attempt_id 与工具调用及结果绑定。image_gen,使用已保存提示词;referenced_image_paths 仅传当前原始源页,设置不透明背景,只用工具支持的参数。record,使用本次工具明确返回的图片路径或数据。内联数据可解码落盘,不从目录猜测结果。若工具返回多个候选,只取第一个可用结果,不另作择优。"$PYTHON" "$SCRIPT" reserve --work-dir "$JOB" --page "$PAGE" --purpose initial --prompt-file "$PROMPT"
# 保存返回的 attempt_id,立即通过内置工具执行本页唯一一次生图。
"$PYTHON" "$SCRIPT" record --work-dir "$JOB" --page "$PAGE" --attempt-id "$ATTEMPT_ID" --image "$IMAGE"例如用 Promise.allSettled 独立收集并发调用。承载调用的执行脚本必须保持存活,直到全部已提交请求收尾,单页失败不能丢弃其他结果。运行中、等待句柄或超时但结局未明,都不算确定失败;继续等待原调用。
宿主明确不支持并发时,仅将尚未提交页改为串行,不额外生图测试并发能力。服务整体不可用时停止新提交,收集已有结果。
全部已提交请求收尾、可用图片已保存后,直接执行:
"$PYTHON" "$SCRIPT" assemble --work-dir "$JOB" --output "$OUT" --pdf-only脚本按实际采用的图片和原页序生成中文 PDF,只返回 PDF 路径和页码映射,不生成检查 Markdown。每页使用源 PDF 对应的页面尺寸,图片在该页面内等比例居中,不裁切、拉伸、重采样或添加 OCR 层。脚本只做 PDF 可重开、页数、页面尺寸和嵌入图片完整性检查,不进行视觉检查循环。
只有用户明确要求统一 A4 时,才在命令末尾增加 --a4;否则不要使用该参数。
用户收到 PDF 后自行查看。若发现某一页需要修改,用户必须明确提供原页码和更新要求;只有在新的明确请求下,才为选定页启动新一轮一次生图并重新合并。
以 task.json 和 status 为依据,不手工改账本、清空次数或另建目录绕过单次上限。已有调用记录的页不再 reserve,包括旧任务中曾设为两次的页;历史结果和已发出的调用继续保留、收尾,但不沿用旧规则自动增加调用。
reserved / 结果不明:等待或找回原结果,不重复提交。failed:已占用机会,本轮不再生图;找回原调用的真实结果时,可用原标识补录。recorded:复用原图,不覆盖。recoverable_output:图片已落盘但记录未完成,使用脚本提供的确切路径和原标识补录 record,不标失败、不新开调用。确认原调用已结束且没有可用结果时:
"$PYTHON" "$SCRIPT" fail --work-dir "$JOB" --page "$PAGE" --attempt-id "$ATTEMPT_ID" --reason '已确认的失败原因'有未决请求时不能交付最终 PDF。确定缺页后,可用:
"$PYTHON" "$SCRIPT" assemble --work-dir "$JOB" --output "$OUT" --allow-partial --pdf-only如用户同时明确要求 A4,再增加 --a4。
脚本会生成标注 partial 的部分 PDF,并按实际包含的原页码排列;不插入英文或空白占位页,不把部分结果命名为全文。全部页面均无可用图片时,不生成空 PDF,在聊天中简短说明本次未生成可交付文件。
PDF 发布收尾中断时,按 status 的 pending_assemblies 对原路径重跑同一条 assemble ... --pdf-only 命令。脚本仅在待完成记录、文件内容和当前图片映射吻合时补齐;其他已有文件拒绝覆盖。重新封装或补录不增加生图次数。
用户后续明确说要更新哪些页,才启动新一轮任务,每个选中页仍只有一次机会。没有明确页码时先澄清,不根据用户未明确的猜测自动选择页面。
正常最终回复只提供一个文件链接或附件:中文 PDF。不附检查 Markdown、JSON、PNG 预览、对照拼图、技术日志或提示词。PDF 之外的问题反馈由用户肉眼查看后提出新的更新请求。
© Yuan1z0825, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 9 other files (scripts, references, assets) in skills/nature-paper-trans of Yuan1z0825/nature-skills.
Open the folder on GitHubat commit e605b35
Paper PDF Translator 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 |
|---|---|---|---|---|---|---|
| Paper PDF Translator this skillYuan1z0825/nature-skills | 47k | — | ~1k | Automated safety check: Pass | Apache-2.0 | |
| PDF Translatelxsssssss/pdf-translate | 102 | — | ~1.6k | Automated safety check: Pass | MIT | |
| Extract From Pdfsaiskillstore/marketplace | 433 | — | ~2.2k | Automated safety check: Pass | None | |
| Nature Readeraiskillstore/marketplace | 433 | 1 repos | ~1.1k | Automated safety check: Pass | None | |
| PDF Processinganthropics/skills | 180k | 47 repos | ~2k | Automated safety check: Pass | Proprietary | |
| PDF Processing GuideshareAI-lab/learn-claude-code | 78k | 4 repos | ~646 | Automated safety check: Pass | MIT |
lxsssssss/pdf-translate
A skill your agent uses when translating PDF documents between languages while strictly preserving original layout, formatting, typography, tables, and signatures.
aiskillstore/marketplace
This skill should be used when extracting structured data from scientific PDFs for systematic reviews, meta-analyses, or database creation.
aiskillstore/marketplace
Build full-paper Chinese-English side-by-side, figure/table-aware, source-grounded Markdown readers for journal or conference papers from PDF, DOI, arXiv, publisher HTML, or pasted text.
anthropics/skills
Handles everyday PDF jobs in Python and on the command line: extract text and tables, merge, split, rotate, watermark, fill forms, encrypt and OCR.
shareAI-lab/learn-claude-code
Gives the agent command-line and Python recipes for reading, creating, merging and splitting PDF files, plus tips for large and scanned documents.
docling-project/docling
Converts PDFs, Office files, HTML, images and other documents into a unified DoclingDocument with Markdown or JSON output, through the docling CLI, Python SDK or a remote service.
Yuan1z0825/nature-skills
Builds a structured deep-reading card for one scientific paper, covering methods, how experiments support claims, limitations and research ideas, with a script to prepare the source.
Yuan1z0825/nature-skills
Creates, revises, audits and exports manuscript-ready scientific figures in Python or R, and routes AI-generated graphical abstracts to a separate workflow.
Yuan1z0825/nature-skills
Drafts Chinese invention patent applications and technical disclosures from research papers or inventor materials, tying each claim feature to source evidence.
Yuan1z0825/nature-skills
Composes, revises or audits research proposals and opening reports through an evidence-first state machine with argument maps, section contracts and dynamic expert reviewers.
Yuan1z0825/nature-skills
Routes literature requests to lawful full-text sources: open access, publisher APIs, CNKI and institutional browser access, with a supporting-information gate.
Yuan1z0825/nature-skills
Rebuilds slide images, screenshots, scanned PDFs or image-only PPTX files as PowerPoint with editable objects, using a local CLI with per-page manifests and QA.
Works with
Categories
Translates an English paper PDF, all pages or a chosen range, into a Simplified Chinese image-based PDF that keeps the original layout, figures and formulas. Each page is regenerated as a Chinese page image and merged in the original order into one PDF, which is the only deliverable. By default every page keeps the source size, orientation and aspect ratio, and pages are fitted to A4 only if you ask.
Paper PDF Translator fits situations like: reading an English research paper in Chinese while keeping its layout; translating only selected pages of a paper PDF; producing a Chinese PDF that preserves figures, columns and formulas; redoing specific pages after you spot a problem in the first result.
Run `npx skills add Yuan1z0825/nature-skills --skill nature-paper-trans -a claude-code`. Or copy the skill folder (skills/nature-paper-trans in Yuan1z0825/nature-skills) into .claude/skills/nature-paper-trans in your project. Claude Code loads it when a task matches its description.
Run `npx skills add Yuan1z0825/nature-skills --skill nature-paper-trans -a codex`. Or copy the skill folder (skills/nature-paper-trans in Yuan1z0825/nature-skills) into .agents/skills/nature-paper-trans in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Yuan1z0825/nature-skills --skill nature-paper-trans -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nature-paper-trans, .gemini/skills/nature-paper-trans, .github/skills/nature-paper-trans and .opencode/skills/nature-paper-trans in your project.
Going by SKILL.md and its folder, Paper PDF Translator needs Python for the scripts in its folder. Our summary lists: Python 3.9 or newer with PyMuPDF and Pillow; An agent with a built-in image_gen tool.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
Paper PDF Translator is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.5k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Paper PDF Translator: PDF Translate (lxsssssss/pdf-translate, 102 stars), Extract From Pdfs (aiskillstore/marketplace, 433 stars), Nature Reader (aiskillstore/marketplace, 433 stars) and PDF Processing (anthropics/skills, 180k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Yuan1z0825 (a GitHub user) maintains it in Yuan1z0825/nature-skills, which has 47,222 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on October 11, 2026.
Source: Yuan1z0825/nature-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.