Agent skill

Arxiv Translator

by Leey21 in Leey21/arxiv-translator

将 arXiv 论文自动翻译为中文 PDF。触发后按本 skill 四步顺序直接执行,勿长篇规划。用户提供论文标题或 arXiv ID、说「翻译论文」「我想读中文版」等时立即使用。支持多篇论文处理。无需用户手动操作。

MITAuto-check passedResearch & Science

Install Arxiv Translator

skills CLI
$ npx skills add Leey21/arxiv-translator --skill arxiv-translator -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Leey21/arxiv-translator arxiv-translator --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Leey21/arxiv-translator.git skills-src && mkdir -p .claude/skills && cp -r skills-src/arxiv-translator .claude/skills/arxiv-translator && rm -rf skills-src

Use ~/.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/

Facts

Skill name
arxiv-translator
GitHub stars
496
Token cost
~627 tokens
SKILL.md length
121 words
Files
10 (incl. scripts, references)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

将 arXiv 论文自动翻译为中文 PDF。触发后按本 skill 四步顺序直接执行,勿长篇规划。用户提供论文标题或 arXiv ID、说「翻译论文」「我想读中文版」等时立即使用。支持多篇论文处理。无需用户手动操作。

  • Tasks that involve Academic paper search
  • SKILL.md covers 第一步:确定论文 ID, 第二步:获取源码并确定翻译范围, 第三步:翻译 and 第四步:编译与清理, plus 1 more section
  • Runs Python scripts from its folder; calls python3
  • Tasks that involve Translation

What it does

Arxiv Translator is an agent skill from Leey21/arxiv-translator. 将 arXiv 论文自动翻译为中文 PDF。触发后按本 skill 四步顺序直接执行,勿长篇规划。用户提供论文标题或 arXiv ID、说「翻译论文」「我想读中文版」等时立即使用。支持多篇论文处理。无需用户手动操作。

Its SKILL.md is about 630 tokens, which your agent loads only when the skill is triggered. The skill folder holds 12 other files, including scripts and reference files (for example `references/compile-errors.md`, `scripts/cleanup.py` and `scripts/compile.py`).

It sits in Research & Science, covering Academic paper search and Translation. It works with arXiv. The repository describes itself as: arXiv? No. ChineseXiv. The licence is MIT.

When your agent uses it

  • Tasks that involve Academic paper search
  • Tasks that involve Translation

Example prompts

  • “/arxiv-translator”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit dc6318e. 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

    Ships 8 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Arxiv Translator loads about 627 tokens when it runs, and up to ~1.3k if it reads all its reference files. Until then it costs about 31 tokens; SKILL.md has 121 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~31
When it runs · the whole SKILL.md, loaded when a task matches
~627
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.3k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from Leey21/arxiv-translator at commit dc6318e, republished under its MIT licence (© Leey21). 121 words, ~627 tokens.

Download SKILL.mdSave it as .claude/skills/arxiv-translator/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
arxiv-translator
description
将 arXiv 论文自动翻译为中文 PDF。触发后按本 skill 四步顺序直接执行,勿长篇规划。用户提供论文标题或 arXiv ID、说「翻译论文」「我想读中文版」等时立即使用。支持多篇论文处理。无需用户手动操作。

arXiv 论文中文翻译

目标: 将指定论文的 LaTeX 源码译为中文,并编译得到 PDF。

流程: 须严格按下文「第一步」至「第四步」顺序执行,不得擅自省略、合并或调换步骤。

交互: 仅在论文 ID 无法确定、检索结果存在多个需用户择一才可向用户提问;其余情况一律无中断的执行得到最终翻译后的PDF。

翻译: 翻译全部由当前对话模型自身完成,严禁使用外部翻译工具以及下载已有的翻译版本。


第一步:确定论文 ID

  • arXiv URL/ID → 直接提取 ID
  • 论文标题 → 搜索 arXiv / 网页查找 ID;找不到时给出候选让用户确认

第二步:获取源码并确定翻译范围

bash
python3 {SKILL_DIR}/scripts/download.py "{PAPER_ID}" "$OUTPUT_DIR/.tmp_arxiv/{PAPER_ID}"

download.py 一步完成:下载源码 → 解压 → 递归查找 .tex → 定位主文件 → 提取标题。

OUTPUT_DIR 为用户指定的保存路径,未指定则为当前目录

无源码(仅 PDF)则告知用户跳过。

脚本向 stdout 输出三行,格式如下:

WORK_DIR=<源码目录绝对路径>
MAIN_TEX=<主文件相对路径>
PDF_NAME=<论文标题>

第三步:翻译

由当前对话模型直接在原 .tex 文件上进行翻译修改,按以下规则翻译:

  • 翻译范围: 默认只翻正文,不翻附录,但附录中的内容需要得到保留,若同一文件中出现 \appendix,默认只翻该命令之前的内容。用户明确要求“翻译全文”时才翻附录。
  • 必须翻译: 正文叙述、摘要、图表标题、列表项、脚注中的描述文本,以及代码块中的注释。
  • 保留不翻: 数学环境、LaTeX 命令、\cite{}/\ref{}/\label{}、图片路径、URL、代码本体、.bib、人名、机构名、模型名、数据集名。
  • 专有名词: Transformer、Softmax、Token 等通用学术术语保留英文,不要生硬硬译。
  • 标题要求: \title{} 须改为自然中文题名,不保留英文原题或中英并列;输出 PDF 文件名仍使用第二步的 PDF_NAME。
  • 多篇处理: 多篇论文可以分别处理;只有在用户明确要求并行委派时,才开启多个 subagent,否则直接顺序完成。

译后必须做自检:

bash
python3 {SKILL_DIR}/scripts/inspect_tex.py scan "$WORK_DIR" "$MAIN_TEX" body

若用户明确要求“翻译全文”,则改为:

bash
python3 {SKILL_DIR}/scripts/inspect_tex.py scan "$WORK_DIR" "$MAIN_TEX" full

脚本会输出 SUSPECT_COUNT=<数字> 以及若干 SUSPECT=<文件>:<行号>:<片段>。

  • 只要 SUSPECT_COUNT 非 0,就必须逐条回到对应位置进行翻译;
  • 只有 SUSPECT_COUNT=0,或剩余项明确属于“保留不翻”范围时,才可进入第四步。

第四步:编译与清理

编译:

bash
python3 {SKILL_DIR}/scripts/compile.py "$WORK_DIR" "$MAIN_TEX" "$OUTPUT_DIR/$PDF_NAME.pdf"

compile.py 会统一完成以下编译前处理:

  • 若检测到中文且主文件尚无 CJK 支持,自动在主文件 preamble 中补入 LuaLaTeX 所需中文支持;
  • 自动注释掉与 Unicode 编译栈冲突的 fontenc / inputenc;
  • 若源码自带 .bbl,自动将其内联到 \bibliography{...} 位置,避免远端单遍编译后引用显示为 ?;
  • 自动忽略常见编译中间文件与未被源码引用的游离 PDF,避免把无关产物上传到远端编译服务。

编译失败时:读取 stderr 中的错误日志,参考 references/compile-errors.md 修复源码,重新编译(最多重试 2 次)。

编译成功后默认保留 $OUTPUT_DIR/.tmp_arxiv,方便用户检查 PDF 后继续微调翻译源码。只有用户明确要求清理、或你已经完成必要检查且确认不再需要源码时,才调用:

bash
python3 {SKILL_DIR}/scripts/cleanup.py "$OUTPUT_DIR"

如果需要在清理前保留翻译后的 .tex / .bbl,使用:

bash
python3 {SKILL_DIR}/scripts/cleanup.py "$OUTPUT_DIR" "$OUTPUT_DIR/translated-sources"

多篇论文时,所有论文都完成 PDF 编译并保存后再进行中间文件清理。

最后输出 PDF 保存路径。


参考文件

  • references/compile-errors.md:编译常见错误及修复方法

© Leey21, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 9 other files (scripts, references) in arxiv-translator of Leey21/arxiv-translator.

  • SKILL.md
  • references/compile-errors.md
  • scripts/__pycache__/cleanup.cpython-312.pyc
  • scripts/__pycache__/compile.cpython-312.pyc
  • scripts/__pycache__/download.cpython-312.pyc
  • scripts/__pycache__/inspect_tex.cpython-312.pyc
  • scripts/cleanup.py
  • scripts/compile.py
  • scripts/download.py
  • scripts/inspect_tex.py

Open the folder on GitHubat commit dc6318e

Compare with similar skills

Arxiv 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.

Arxiv Translator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Arxiv Translator this skillLeey21/arxiv-translator496—~627Automated safety check: PassMIT
Paper ReadingEdwardxlai/easyread871—~567Automated safety check: PassMIT
Nature Readerjing1312/nature-figure-skill168—~2.8kAutomated safety check: PassMIT
Paper To HTMLysyecust/lecture-to-notes273—~1.3kAutomated safety check: PassCustom licence
Nature Readeraiskillstore/marketplace4301 repos~1.1kAutomated safety check: PassNone
Literature PDF OCR Library BuilderLigphiDonk/Oh-my--paper738—~1.1kAutomated safety check: PassMIT

Similar skills

  • Paper Reading

    Edwardxlai/easyread

    论文共读:用 EasyRead(E:\CursorProject\easyread)这个本地工具读论文。用户给一篇 PDF 或 arXiv 编号时,导入文献库、翻译成中文(后台引擎或对话里的 agent 亲自译);之后边读边讨论,agent 读用户在页面上的笔记和提问,把回答、解释、原文核对提示追加到对应段落旁。用于…

    871 GitHub stars~567 tokensUpdated today
    Research & ScienceAuto-check passed
  • Nature Reader

    jing1312/nature-figure-skill

    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.

    168 GitHub stars~2.8k tokensUpdated 1 mo ago
    Research & ScienceAuto-check passed
  • Paper To HTML

    ysyecust/lecture-to-notes

    Generate a self-contained, beautifully styled HTML analysis of an academic paper.

    273 GitHub stars~1.3k tokensUpdated 6 days ago
    Research & ScienceAuto-check passed
  • Nature Reader

    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.

    430 GitHub starsUsed in 1 repo~1.1k tokens
    Research & ScienceAuto-check passed
  • Literature PDF OCR Library Builder

    LigphiDonk/Oh-my--paper

    Searches and downloads legally accessible academic PDFs, OCRs them to Markdown, and organizes the results into a traceable, AI-readable literature library.

    738 GitHub stars~1.1k tokensUpdated 5 mo ago
    Research & ScienceAuto-check passed
  • Read arXiv Paper

    karpathy/nanochat

    Fetches the TeX source of an arXiv paper from its URL, reads it and writes a markdown summary tied to the nanochat project.

    59k GitHub starsUsed in 1 repo~494 tokens
    Research & ScienceAuto-check passed

Works with

Questions about Arxiv Translator

What does Arxiv Translator do?

将 arXiv 论文自动翻译为中文 PDF。触发后按本 skill 四步顺序直接执行,勿长篇规划。用户提供论文标题或 arXiv ID、说「翻译论文」「我想读中文版」等时立即使用。支持多篇论文处理。无需用户手动操作。. Arxiv Translator is an agent skill from Leey21/arxiv-translator.

When should I use Arxiv Translator?

Arxiv Translator fits situations like: tasks that involve Academic paper search; tasks that involve Translation.

How do I install Arxiv Translator in Claude Code?

Run `npx skills add Leey21/arxiv-translator --skill arxiv-translator -a claude-code`. Or copy the skill folder (arxiv-translator in Leey21/arxiv-translator) into .claude/skills/arxiv-translator in your project. Claude Code loads it when a task matches its description.

How do I install Arxiv Translator in Codex?

Run `npx skills add Leey21/arxiv-translator --skill arxiv-translator -a codex`. Or copy the skill folder (arxiv-translator in Leey21/arxiv-translator) into .agents/skills/arxiv-translator in your project. Codex loads it when a task matches its description.

Can I use Arxiv Translator 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 Leey21/arxiv-translator --skill arxiv-translator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/arxiv-translator, .gemini/skills/arxiv-translator, .github/skills/arxiv-translator and .opencode/skills/arxiv-translator in your project.

What does Arxiv Translator need to run?

Going by SKILL.md and its folder, Arxiv Translator needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Arxiv Translator access the network?

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.

Is Arxiv Translator 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Arxiv Translator use?

Arxiv Translator 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 Arxiv Translator use?

About 627 tokens (SKILL.md is roughly 2.5k 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 696 tokens, read only when the agent opens those files.

What are the alternatives to Arxiv Translator?

Skills that share tags, products or a category with Arxiv Translator: Paper Reading (Edwardxlai/easyread, 871 stars), Nature Reader (jing1312/nature-figure-skill, 168 stars), Paper To HTML (ysyecust/lecture-to-notes, 273 stars) and Nature Reader (aiskillstore/marketplace, 430 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Arxiv Translator?

Leey21 (a GitHub user) maintains it in Leey21/arxiv-translator, which has 496 GitHub stars. The repository was last updated on July 21, 2026.

Source: Leey21/arxiv-translator on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.