Agent skill

Translate

A skill your agent uses when the user wants to translate paper markdown, full papers, or batches into another language while preserving formulas, code blocks, and images.

MITAuto-check passedDocuments & Office

Install Translate

skills CLI

$ npx skills add ZimoLiao/scholaraio --skill translate -a claude-code

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

GitHub CLI

$ gh skill install ZimoLiao/scholaraio translate --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/ZimoLiao/scholaraio.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/translate .claude/skills/translate && 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/

Paste into Claude Code

Install the "translate" agent skill from https://github.com/ZimoLiao/scholaraio/tree/main/.claude/skills/translate into .claude/skills/translate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "translate", 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

$skill-installer install https://github.com/ZimoLiao/scholaraio/tree/main/.claude/skills/translate

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

skills CLI

$ npx skills add ZimoLiao/scholaraio --skill translate -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install ZimoLiao/scholaraio translate --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ZimoLiao/scholaraio.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/translate .agents/skills/translate && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "translate" agent skill from https://github.com/ZimoLiao/scholaraio/tree/main/.claude/skills/translate into .agents/skills/translate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "translate", 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.

skills CLI

$ npx skills add ZimoLiao/scholaraio --skill translate -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install ZimoLiao/scholaraio translate --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ZimoLiao/scholaraio.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/translate .cursor/skills/translate && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "translate" agent skill from https://github.com/ZimoLiao/scholaraio/tree/main/.claude/skills/translate into .cursor/skills/translate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "translate", 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

$ gemini skills install https://github.com/ZimoLiao/scholaraio.git --path .claude/skills/translate

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add ZimoLiao/scholaraio --skill translate -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install ZimoLiao/scholaraio translate --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ZimoLiao/scholaraio.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/translate .gemini/skills/translate && rm -rf skills-src

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

Paste into Gemini CLI

Install the "translate" agent skill from https://github.com/ZimoLiao/scholaraio/tree/main/.claude/skills/translate into .gemini/skills/translate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "translate", 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.

GitHub CLI

$ gh skill install ZimoLiao/scholaraio translate

Installs 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).

skills CLI

$ npx skills add ZimoLiao/scholaraio --skill translate -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/ZimoLiao/scholaraio.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/translate .github/skills/translate && rm -rf skills-src

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

Paste into GitHub Copilot

Install the "translate" agent skill from https://github.com/ZimoLiao/scholaraio/tree/main/.claude/skills/translate into .github/skills/translate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "translate", 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.

skills CLI

$ npx skills add ZimoLiao/scholaraio --skill translate -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install ZimoLiao/scholaraio translate --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ZimoLiao/scholaraio.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/translate .opencode/skills/translate && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "translate" agent skill from https://github.com/ZimoLiao/scholaraio/tree/main/.claude/skills/translate into .opencode/skills/translate/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "translate", 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.

Facts

Skill name: translate
GitHub stars: 577
Token cost: ~693 tokens
SKILL.md length: 152 words
Files: 1
Skills in repo: 43
Repo updated: Sep 25, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

A skill your agent uses when the user wants to translate paper markdown, full papers, or batches into another language while preserving formulas, code blocks, and images.

Works in 12 steps: 检测论文原文语言（基于字符集启发式检测） → 如果已是目标语言，跳过 → 将 Markdown 按段落边界分块（保留代码块和公式完整性） → …
The user wants to translate paper markdown
SKILL.md covers 配置, 执行逻辑, 工作流程 and 进度与续翻, plus 1 more section
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Translate is an agent skill from ZimoLiao/scholaraio. Use when the user wants to translate paper markdown, full papers, or batches into another language while preserving formulas, code blocks, and images.

Its SKILL.md is about 690 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office, covering Translation. The repository describes itself as: Scholar All-In-One: A research infrastructure for AI agents. The licence is MIT.

When your agent uses it

The user wants to translate paper markdown
Batches into another language while preserving formulas

Example prompts

“/translate”

Workflow steps

12 steps, taken from the first numbered list in SKILL.md.

检测论文原文语言（基于字符集启发式检测）
如果已是目标语言，跳过
将 Markdown 按段落边界分块（保留代码块和公式完整性）
通过 LLM 逐块翻译，保留所有格式标记
单篇翻译会并发请求多个分块，但只按原顺序推进最终输出
在论文目录下创建临时工作目录（如 .translate_zh/），将每块分别写入 parts/*.md
状态写入 state.json / chunks.json；失败块会记录错误并在下次续翻时单独补跑
每个分块带超时重试和指数退避
若已有连续成功前缀，则同步刷新 paper_{lang}.md，方便中途查看已完成部分
若指定 --portable，则额外复制一份到 workspace/_system/translation-bundles//，并复制 images/ 以保证脱离原目录后图片仍可用
若前面某块失败但后面某些块已成功，这些成功块仍会保留在临时工作目录里；下次续翻时会跳过已成功块，只补失败或未完成的块
全部完成后删除临时工作目录，并在 meta.json 中记录翻译元数据

What it can do on your machine

Read from SKILL.md and the folder at commit 777628b. 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
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash and yaml).
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

Translate loads about 693 tokens when it runs. Until then it costs about 40 tokens; SKILL.md has 152 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~40
When it runs · the whole SKILL.md, loaded when a task matches: ~693

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from ZimoLiao/scholaraio at commit 777628b, republished under its MIT licence (© ZimoLiao). 152 words, ~693 tokens.

Download SKILL.mdSave it as .claude/skills/translate/SKILL.md (or your agent's skills folder).

name: translate
description: Use when the user wants to translate paper markdown, full papers, or batches into another language while preserving formulas, code blocks, and images.

论文翻译

将论文 Markdown 翻译为目标语言（默认中文），保留 LaTeX 公式、代码块、图片引用和 Markdown 格式。翻译结果保存为论文目录内的 paper_{lang}.md，原文保持不变；如需可携带分享，可额外导出到 workspace/_system/translation-bundles/<Author-Year-Title>/。

当前实现支持：

单篇翻译时按 config.translate.concurrency 并发请求多个分块，并在终端显示块级进度
在论文目录下创建临时工作目录，按块写入 parts/*.md
网络抖动时对单块做超时重试与指数退避（默认最多 5 次尝试）
中途中断后可从临时工作目录继续续翻
--force 会清理旧的临时翻译目录并从头重新翻译
--portable 会额外生成 workspace/_system/translation-bundles/<Author-Year-Title>/paper_{lang}.md 和对应的 images/

配置

config.yaml 中可设置默认行为：

yaml

translate:
  auto_translate: false   # 入库时是否自动翻译（默认关闭）
  target_lang: zh          # 目标语言（zh/en/ja/ko/de/fr/es）
  chunk_size: 4000         # 分块大小（字符数）
  concurrency: 20          # 总翻译并发预算（单篇时用于 chunk 并发，批量时会在论文间分摊）

每次调用时可通过 CLI 参数覆盖默认值。

执行逻辑

单篇翻译

bash

scholaraio translate "<paper-id>" [--lang zh] [--force] [--portable]

批量翻译

bash

scholaraio translate --all [--lang zh] [--force] [--portable]

查看翻译

bash

scholaraio show "<paper-id>" --layer 4 --lang zh

作为 pipeline 步骤

bash

scholaraio pipeline --steps toc,l3,translate

注意：translate 默认不在预设（full/ingest/enrich/reindex）中；可通过 --steps 显式指定。若 config.translate.auto_translate=true 且 pipeline 包含 inbox 步骤，translate 会在 papers 阶段自动注入。

工作流程

检测论文原文语言（基于字符集启发式检测）
如果已是目标语言，跳过
将 Markdown 按段落边界分块（保留代码块和公式完整性）
通过 LLM 逐块翻译，保留所有格式标记
单篇翻译会并发请求多个分块，但只按原顺序推进最终输出
在论文目录下创建临时工作目录（如 .translate_zh/），将每块分别写入 parts/*.md
状态写入 state.json / chunks.json；失败块会记录错误并在下次续翻时单独补跑
每个分块带超时重试和指数退避
若已有连续成功前缀，则同步刷新 paper_{lang}.md，方便中途查看已完成部分
若指定 --portable，则额外复制一份到 workspace/_system/translation-bundles/<Author-Year-Title>/，并复制 images/ 以保证脱离原目录后图片仍可用
若前面某块失败但后面某些块已成功，这些成功块仍会保留在临时工作目录里；下次续翻时会跳过已成功块，只补失败或未完成的块
全部完成后删除临时工作目录，并在 meta.json 中记录翻译元数据

进度与续翻

单篇翻译会输出：

总块数
当前块进度（如 翻译进度: 3/12）
中断位置
是否可续翻

如果中途中断：

bash

scholaraio translate "<paper-id>" --lang zh

会自动检测论文目录下的临时翻译工作目录（如 .translate_zh/），并从未完成或失败的块继续。

如果想忽略已有部分结果并重新开始：

bash

scholaraio translate "<paper-id>" --lang zh --force

会删除旧的临时翻译目录和旧的 paper_zh.md，从头重新翻译。

示例

用户说："把这篇英文论文翻译成中文" -> 执行 scholaraio translate "<paper-id>" --lang zh

用户说："把所有论文翻译成中文" -> 执行 scholaraio translate --all --lang zh

用户说："看这篇论文的中文版" -> 执行 scholaraio show "<paper-id>" --layer 4 --lang zh

用户说："重新翻译这篇论文" -> 执行 scholaraio translate "<paper-id>" --force

用户说："上次翻译到一半断了，继续翻" -> 直接执行 scholaraio translate "<paper-id>" --lang zh

用户说："给我一份可以单独发给别人的译文，别丢图" -> 执行 scholaraio translate "<paper-id>" --lang zh --portable

Files

Just SKILL.md in .claude/skills/translate of ZimoLiao/scholaraio.

Open the folder on GitHubat commit 777628b

Compare with similar skills

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

Translate compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Translate this skillZimoLiao/scholaraio	577	—	~693	Automated safety check: Pass	MIT	15 days ago
PDF Translatelxsssssss/pdf-translate	102	—	~1.6k	Automated safety check: Pass	MIT	2 days ago
Persian Writingali2000hos/persian-writing	368	—	~4.4k	Automated safety check: Warn	MIT	6 days ago
Audit WhitepapersFlorianBruniaux/claude-code-ultimate-guide	6.1k	—	~3.8k	Automated safety check: Pass	CC-BY-SA-4.0	3 days ago
Public Domain Epub PipelineSaberOnGo/public-domain-books-translation	267	—	~4.6k	Automated safety check: Pass	None	5 days ago
Azure AI Translation Document Pymicrosoft/skills	3.1k	5 repos	~2.6k	Automated safety check: Pass	MIT	yesterday

Similar skills

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.
102 GitHub stars~1.6k tokensUpdated 2 days ago
Documents & OfficeAuto-check passed
Persian Writing
ali2000hos/persian-writing
Write natural, human-sounding Persian (Farsi) and build correct right-to-left Persian deliverables.
368 GitHub stars~4.4k tokensUpdated 6 days ago
Documents & OfficeAuto-check: warnings
Audit Whitepapers
FlorianBruniaux/claude-code-ultimate-guide
Audits version freshness, French and English parity and metadata of whitepapers and recap cards in the claude-code-ultimate-guide repo, with optional fix suggestions.
6.1k GitHub stars~3.8k tokensUpdated 3 days ago
Documents & OfficeAuto-check passed
Public Domain Epub Pipeline
SaberOnGo/public-domain-books-translation
A skill your agent uses when creating, reviewing, or maintaining public-domain book translation projects and EPUB pipeline templates in this repository.
267 GitHub stars~4.6k tokensUpdated 5 days ago
Documents & OfficeAuto-check passed
Azure AI Translation Document Py
microsoft/skills
Official
Azure AI Document Translation SDK for batch translation of documents with format preservation.
3.1k GitHub starsUsed in 5 repos~2.6k tokens
Documents & OfficeAuto-check passed
Quasi Coder
github/awesome-copilot
Official
Expert 10x engineer skill for interpreting and implementing code from shorthand, quasi-code, and natural language descriptions.
40k GitHub starsUsed in 1 repo~3.9k tokens
Documents & OfficeAuto-check passed

Questions about Translate

What does Translate do?

A skill your agent uses when the user wants to translate paper markdown, full papers, or batches into another language while preserving formulas, code blocks, and images. Translate is an agent skill from ZimoLiao/scholaraio. Use when the user wants to translate paper markdown, full papers, or batches into another language while preserving formulas, code blocks, and images.

When should I use Translate?

Translate fits situations like: the user wants to translate paper markdown; batches into another language while preserving formulas.

How do I install Translate in Claude Code?

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

How do I install Translate in Codex?

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

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

What does Translate need to run?

SKILL.md names no scripts, command-line tools or credentials: Translate is instructions for the agent only.

Does Translate 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 Translate 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. Review the folder before installing.

What licence does Translate use?

Translate 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 Translate use?

About 693 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Translate?

Skills that share tags, products or a category with Translate: PDF Translate (lxsssssss/pdf-translate, 102 stars), Persian Writing (ali2000hos/persian-writing, 368 stars), Audit Whitepapers (FlorianBruniaux/claude-code-ultimate-guide, 6.1k stars) and Public Domain Epub Pipeline (SaberOnGo/public-domain-books-translation, 267 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Translate?

ZimoLiao (a GitHub user) maintains it in ZimoLiao/scholaraio, which has 577 GitHub stars. The repository holds 43 skills in this directory. The repository was last updated on September 25, 2026.

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

Install Translate

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

论文翻译

配置

执行逻辑

单篇翻译

批量翻译

查看翻译

作为 pipeline 步骤

工作流程

进度与续翻

示例

Files

Compare with similar skills

Similar skills

More from ZimoLiao/scholaraio

Related

Questions about Translate