doc-reader SKILL.md skillA
doc-reader from hanzhangzzz/agent-skills-zh is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add hanzhangzzz/agent-skills-zh/doc-reader@git:20260904.c21f62bPins git:20260904.c21f62b in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- hanzhangzzz/agent-skills-zh
- Path
doc-reader/SKILL.md- Versions recorded
- 5
- Latest version
- git:20260904.c21f62b, committed Sep 4, 2026
- First version recorded
- Aug 31, 2026
- Size
- 3,565 bytes
- Repository stars
- 1
- License
- MIT
Translate an English technical article (web URL) or a local PDF into accurate Chinese, section by section with consistent terminology, keeping 100% of the images, and build a local three-column preview HTML (original · translation · AI slides). Slides are generated through the local Codex CLI built-in imagegen, so no image API key is needed. Use when the user shares an English blog post, paper, docs page or PDF and wants a faithful, side-by-side Chinese version, or says /doc-reader, 翻译这篇文章…
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Doc Reader
**准确是翻译的生命线**。采用章节级翻译策略，在保证精准的同时最大化翻译效率。
## 使用方式
```
# 在线网页
/doc-reader <URL>
/doc-reader <URL> --no-ppt # 跳过幻灯片生成
/doc-reader <URL> --quick # 快速模式，仅翻译不生成预览
# 本地 PDF 文件
/doc-reader <PDF_PATH>
/doc-reader /path/to/document.pdf
```
## 核心能力
1. **章节级翻译** - 以章节为单位翻译，保持上下文连贯，术语全文一致
2. **图片 100% 保留** - 自动下载所有图片，失败时保留原始链接
3. **技术术语精准** - 首次出现标注原文，专有名词保留英文
4. **三栏预览** - 原文/翻译/PPT概要同步滚动
5. **AI 幻灯片生成** - 主 session 无关，通过本机 Codex CLI 的内置 imagegen 并发生成概要图
## 脚本说明
所有脚本位于 `scripts/` 目录：
| 脚本 | 用途 |
|------|------|
| `web_fetcher.py` | 高质量网页抓取，优于 WebFetch 工具 |
| `generate_slides.py` | 并发调用 Codex CLI（默认 4 路），由内置 `$imagegen` 生成整组幻灯片 |
| `build.py` | 构建三栏预览 HTML |
> **Python 依赖**：`pip install html-to-markdown`（`web_fetcher.py` 需要；已适配 3.x 的 ConversionResult API）。首次运行缺库时脚本会 fail-fast 并提示本命令。
**🚨 关键执行规则:**
每次执行 `generate_slides.py` 和 `build.py` 前，**必须**将脚本从本 skill 的 `scripts/` 目录复制到当前工作目录 `output/{slug}/`。`build.py` 还需同目录放置 `marked.min.js`（预览的内嵌渲染库，随 scripts/ 一起复制）。
图片生成要求 `codex` 位于 `PATH`、Codex CLI 已登录，并且当前版本和账号可使用内置 imagegen。安装 CLI 本身不等于已经具备图片生成权限。
脚本依赖相对路径查找文件，必须在输出目录内执行。`SKILL_DIR` 指本 `SKILL.md` 所在目录（全局安装、项目级安装、plugin 缓存目录均适用，不要硬编码绝对路径）：
```bash
# 步骤 7: 生成幻灯片前
…Read the whole file at its exact version.
How to install
mdr add hanzhangzzz/agent-skills-zh/doc-reader@sha256:cfc70ae3ad41bde6The line at the top of this page pins the label git:20260904.c21f62b, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_o7pnmfphzajmdp2u)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Aug 31, 2026 and Sep 4, 2026, about one every day.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260904.c21f62b latest | 2026-09-04 | c21f62b | 3,565 B | A | view · diff |
| git:20260904.bf5b055 | 2026-09-04 | bf5b055 | 3,456 B | A | view · diff |
| git:20260901.4d9bf39 | 2026-09-01 | 4d9bf39 | 3,267 B | A | view · diff |
| git:20260831.985b51d | 2026-08-31 | 985b51d | 3,160 B | A | view · diff |
| git:20260831.7488d8e | 2026-08-31 | 7488d8e | 3,136 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (3565 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
hanzhangzzz/agent-skills-zh · 1 stars · license MIT · pushed 2026-10-29 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_o7pnmfphzajmdp2u GET https://markdownregistry.com/api/v1/resolve?ref=hanzhangzzz/agent-skills-zh/doc-reader GET https://markdownregistry.com/api/v1/blob/cfc70ae3ad41bde644afeb5122f3c99ec5268f34afbdced8a19096513973ad77
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.
More from hanzhangzzz/agent-skills-zh
Every file in hanzhangzzz/agent-skills-zh