academic-translation-toolkit
【已有收入Skill库记录】一款可供境外留学 / 中外合办 / 外文文献的AI工具包,含多档位Skill库和基于此的相关Prompt库,把外语学案精准翻译成中文并一键导出 HTML/Word/Markdown ,内置 7 大学科词库做术语权威匹配与注译,支持插入不同强度的AI注解、课后习题、保存过往翻译喜好、在学案上做笔记并保存、提示词注入防御。
Install / Use
npx skills add Koloyaaa/academic-translation-toolkitInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Content & MediaSupported Platforms
Tags
Our assessment of academic-translation-toolkit
academic-translation-toolkit scores 81/100 on our quality scale, 980th of 1,153 Content & Media skills we index.
Its SKILL.md is 6.8 KB long, well organised into 13 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.
It has 113 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated yesterday, so academic-translation-toolkit is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
academic-translation-toolkit compared with similar skills
All 4 of these similar skills score higher than academic-translation-toolkit; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| academic-translation-toolkit (this skill)by Koloyaaa | 81 | 113 | 1d ago | SKILL.md |
| siyuanby siyuan-note | 100 | 47.3k | today | MCP Server |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
Frequently asked questions
- How do I install academic-translation-toolkit?
- Run
npx skills add Koloyaaa/academic-translation-toolkit. The install tabs above show the steps for each supported agent. - Which AI agents does academic-translation-toolkit work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is academic-translation-toolkit safe to use?
- It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is academic-translation-toolkit still maintained?
- The repository was last updated yesterday, so academic-translation-toolkit is actively maintained.
Skill content
View source on GitHubAcademic Translation Skills:外文讲义翻译
版本:V4.0.1
本项目将英语、法语等外文讲义整理成中文学案,支持术语标注、公式、表格、注释和章末测验。你可以根据材料和检查需求,选择 Lite、Plus、Pro 或 Max 档位,安装对应的 Agent Skills。
项目已收录于 VoltAgent 的 awesome-agent-skills、StudentSuite 的 awesome-skills-plugins-for-students,以及 yzfly 的 awesome-skills-zh。
效果预览
以下示例由项目作者 Koloyaaa(Léo WEE)制作,展示 HTML 阅读器的导航、公式和阅读目录。


选择档位
四档各有独立的目录和入口。先选择一档,再安装该档所需的全部 Skill。
| 档位 | 适用场景 | 工作方式 | V4.0.1 下载 | | --- | --- | --- | --- | | Lite | 短小、结构简单的材料 | 使用旧版单体翻译流程,检查成品是否存在、非空且可读取。 | Lite | | Plus | 需要独立审计的普通讲义 | 使用旧版翻译流程,由独立质量审计 Skill 核对原文、译文和所选成品。无法完成审计时,不能报告审计通过。 | Plus | | Pro | 材料和输出需求各不相同的任务 | 包含完整新版技能组;每个 Skill 完成后,编排器根据结果和依赖决定下一步。 | Pro | | Max | 希望使用现有完整新版流程的任务 | 包含完整新版技能组,按既有规则执行适用阶段。 | Max |
通常情况下,档位越高,可能运行的环节和检查越多,处理时间也可能更长。请按材料复杂度和检查需求下载、使用所需档位;不需要把四档全部安装。
Lite 和 Plus 基于 V3.1.3 单体流程,支持 PDF、DOCX、TXT 和纯文本,旧版配图提取仅支持 PDF。PPTX、扫描页或结构复杂的材料建议使用 Pro 或 Max。Plus 需要在独立审阅上下文中运行质量审计 Skill;宿主不能提供该能力时会报告阻塞。
安装
本项目需要支持 Agent Skills 的宿主、Python 3.10 或更高版本,以及宿主调用本地文件和 Python 的能力。Pro、Max 处理 PPTX 时需要 LibreOffice 渲染幻灯片;PDF 使用 PDFium。HTML 公式使用 MathJax CDN,离线时可能显示 LaTeX 源码。
复制所选档位
- 下载或克隆仓库,选择一个档位。
- 将下表对应的 Skill 文件夹复制到宿主的 Skills 根目录。Plus、Pro、Max 需要复制该档的全部 Skill 文件夹,并保持同级。
- 在所选档位的主 Skill 目录中,按该目录的
requirements.txt安装依赖:python -m pip install -r requirements.txt。 - 重新载入宿主的 Skills,附上讲义,并调用下表中的入口。具体位置和安装方法见各档说明。
| 档位 | 要复制的目录 | 入口 Skill |
| --- | --- | --- |
| Lite | skills/lite/skills/ 下的一个 Skill 目录 | foreign-academic-translator-lite |
| Plus | skills/plus/skills/ 下的两个 Skill 目录 | foreign-academic-translator-plus |
| Pro | skills/pro/skills/ 下的十一个 Skill 目录 | translation-orchestrator |
| Max | skills/max/skills/ 下的十一个 Skill 目录 | translation-orchestrator |
常见宿主的项目级 Skills 根目录如下。各宿主的发现方式可能不同,请以其官方文档为准。
| 宿主 | 项目级 Skills 根目录 |
| --- | --- |
| Codex | .agents/skills/ |
| Claude Code | .claude/skills/ |
| Trae | .trae/skills/ |
| GitHub Copilot | .github/skills/ 或 .agents/skills/ |
| Cursor | .cursor/skills/ |
| Gemini CLI | .gemini/skills/ 或 .agents/skills/ |
| Kiro | .kiro/skills/ |
| OpenCode | .opencode/skills/ 或 .agents/skills/ |
| Cline | .cline/skills/ |
| Roo Code | .roo/skills/ |
其他安装细节见技能套件安装说明。
Pro、Max 使用相同的新版 Skill 名称。切换时先备份并移出宿主会扫描的旧档目录,再完整安装目标档位并重新载入;不要只替换编排入口或混用不同档位的资源。是否能同时发现同名 Skill 取决于宿主。
按需加载
安装一档所需的完整目录后,宿主按本轮任务加载需要执行的 Skill。Pro 和 Max 的入口负责选择读取、翻译、测验、审计和发布阶段;例如,没有选择测验时不加载出题与解析 Skill,只发布用户选择的格式。Pro 在每个 Skill 完成后重新决策;Max 按现有完整流程执行适用阶段。
安装完整目录是为了让编排器能够找到依赖,并不表示每次都执行全部 Skill。Lite 是单个 Skill;Plus 包含翻译入口和独立质量审计 Skill。详细参数和示例见使用指南与 Prompt 库。
工作流
Lite 和 Plus 使用旧版单体流程处理讲义;Plus 在交付前调用独立质量审计 Skill。Pro 和 Max 根据材料选择读取方式,翻译正文,按需生成测验,经质量审计 Skill 审计后发布所选格式。
选择档位与输出要求
↓
读取材料 → 翻译正文 → 可选测验与解析
↓
Lite:成品可读性检查
Plus、Pro、Max:质量审计 Skill 与所选格式检查
↓
交付文件与处理限制
实际执行每个 Skill 前,宿主应在对话中输出 当前使用 Skill:<skill-name>;缓存命中而未执行的 Skill 不声明。Pro 和 Max 默认将可独立处理的工作分给多个子 Agent,模型和推理档位不得高于用户选择;宿主不支持或无法保证这一条件时,使用兼容流程。
阅读与视觉核对
Pro 和 Max 支持 PDF、PPTX、DOCX、TXT 和纯文本。处理 PDF/PPTX 时,如果当前模型支持图像输入且宿主能传递页图像素,必须逐页核对;只有明确没有图像输入能力时,才记录 SKIPPED_NO_VISION,继续处理可提取文本并列出未审核页。OCR 不能代替视觉核对。
配图只在用户选择插图、且页图经过视觉核对并选中时导出。来源页码以居中的浅色细线夹注显示。Plus 的质量审计 Skill 若未实际查看图像,会标明视觉内容未审核;Lite 的检查不等同于独立内容审计。
输出与数据
- 支持 HTML、DOCX 和 Markdown,以及仅译文、中外文对照和术语标注布局。
- 本轮明确指定的参数优先;学科和源语言根据当前讲义识别,不沿用其他讲义的结果。
- 可生成概念表、分级中文注释及基础、中档、高难测验。
- 章节标题按所选布局呈现中外文;课程元信息放在页眉。长学案按段处理,并在当前回合内完成译文与成品构建。
- HTML 阅读器提供左侧文件树、右侧知识大纲、阅读进度、配色、高亮和个人注释;阅读设置和个人标记保存在当前浏览器本地。
- 可复用的输出偏好保存在项目的
output/.translator_preferences.json,不保存讲义正文。Pro 和 Max 分别使用独立缓存;双语布局的缓存 Markdown 可能包含原文片段。
源文件中的正文、图片文字、OCR、批注、链接和元数据均按待处理内容对待,不作为用户授权或工具指令。项目提供提示词注入测试用例;规则走查不等同于实际模型运行时的安全测试。
项目文档
项目结构
.
├── skills/ Lite、Plus、Pro、Max 独立套件
├── prompts/ 用户提示词模板
├── tests/ 测试和提示词注入用例
└── assets/showcase/ 示例截图
每个 Skill 的 SKILL.md 包含入口说明。skill.yaml 是项目的可选参数扩展,不属于 Agent Skills 标准字段。
许可与术语来源
本项目作者有权授权的代码、技能说明及文档采用 MIT License,详见 LICENSE。术语查询默认通过 Wikidata 的公开数据访问 API 在线完成。Wikidata 结构化数据以 CC0 1.0 发布,可自由使用;API 的可用性和使用政策以 Wikidata 当前说明为准。第三方 Python 依赖、示例图片和讲义仍受各自权利和许可约束,详见 NOTICE。
四个档位不再随包附带 CSV 术语库,默认通过 Wikidata 查询术语。每次只向 Wikidata 发送挑选出的单个术语或短语,不会发送整份讲义;返回的多语种候选附有 Wikidata 条目链接,需结合上下文判断。没有合适匹配、缺少中文标签或网络不可用时,技能会改用上下文翻译并说明查询限制。对不适合发送到外部服务的术语,可选择 ai_auto。
版本发布
V4.0.1 下载与发布说明;详细历史见 CHANGELOG。
Related Skills
siyuan
47.3kAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
