lit-pdf-zotero SKILL.md skillA
lit-pdf-zotero from qiaomiaojoe/ai-academic-workflow is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add qiaomiaojoe/ai-academic-workflow/lit-pdf-zotero@git:20261102.a9ed8b4Pins git:20261102.a9ed8b4 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- qiaomiaojoe/ai-academic-workflow
- Path
skills/lit-pdf-zotero/SKILL.md- Versions recorded
- 5
- Latest version
- git:20261102.a9ed8b4, committed Nov 2, 2026
- First version recorded
- Jul 17, 2026
- Size
- 7,098 bytes
- Repository stars
- 10
- License
- a license file GitHub does not identify
文献 PDF 获取 + Zotero 入库 + 可视化（乔淼PhD · AI学术训练营 · AI学术工作流）。对一份文献清单批量：确认 DOI/CNKI ID → 补全引用数 → 多渠道找 PDF 落盘（OA/preprint/sd-download/wos-download/cnki-download）→ 入一个 Zotero Collection（层级和 PXYV 节点记在标签里，不建子集合；含 extra 元数据）→ 生成金字塔分布图 + PXYV 罗盘投影双图 HTML。Trigger on："把这批文献下载 PDF 入库 Zotero"、"文献入库+可视化"、"batch download PDFs and import to Zotero"、"入 Zotero 并画文献金字塔"。.
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
# Lit PDF + Zotero · 获取 PDF → 入库 → 可视化
对一份文献清单（最好是 `lit-pyramid` 的分层清单；无分层也能跑，只是没有层级标签、图 1 跳过）执行四步。
## 调用约定（独立运行）
- 输入：文献清单（分层表 / 普通表 / DOI 列表均可）+ Zotero Collection 名（默认 = 项目名或用户给的短名）。
- 落盘（默认当前工作目录）：PDF 存PDF 文件夹（在项目里按 AGENTS.md 的「文件放哪」表：工作站项目是 文献/PDF/，旧项目 02_文献/pdf_download/；独立运行默认 pdf_download/，或用户给的文件夹），命名 AuthorYear.pdf；最终清单写 `文献清单.md`；可视化写 `[slug]-visualization.html`。
- 工具适配：Zotero MCP 不可用 → 只做 PDF + 清单落盘，并告知手动导入方式；下载工具按环境可用性挑。
- **调用方覆盖约定**：调用方（工作台 prompt / 用户）显式给出的参数、输入路径、落盘路径与工具选择，一律覆盖本 skill 的默认；但本 skill 的方法步骤、硬约束与停点不可被省略或稀释——调用方若要求跳过某硬约束，以本 skill 为准并提示冲突。
## Step 1 · 确认 DOI / URL / CNKI ID
英文论文 → DOI；中文论文 → CNKI ID + 期刊+期号；经典专著 → 出版商 URL 或 DOI；非学术来源 → URL。
## Step 2 · 补全引用数
英文用 OpenAlex API（`https://api.openalex.org/works/doi:{DOI}` 取 `cited_by_count`）或 Google Scholar；中文用 `cnki` skill 的 `verify` 或 `detail`（取 `cited`）。清单里已有的不重采。
## Step 3 · 查找 PDF 并落盘
- 英文优先 `sd-download` / `wos-download` → Open Access（Unpaywall / OpenAlex / 出版商 OA）→ 作者自存档 → preprint（arXiv / SSRN / OSF）
- 中文用 `cnki-download`（要求已登录）
- 找不到的标 "no-pdf"；**不从可疑来源硬凑**。
最终清单落盘（下游文献分析在 Zotero 不可用时的兜底元数据）：
…Read the whole file at its exact version.
How to install
mdr add qiaomiaojoe/ai-academic-workflow/lit-pdf-zotero@sha256:887f882025c4bcfcThe line at the top of this page pins the label git:20261102.a9ed8b4, 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_dwe2jnm5ziw45gxx)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Jul 17, 2026 and Nov 2, 2026, about one every 27 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261102.a9ed8b4 latest | 2026-11-02 | a9ed8b4 | 7,098 B | A | view · diff |
| git:20261031.310c480 | 2026-10-31 | 310c480 | 6,900 B | A | view · diff |
| git:20261023.c385d52 | 2026-10-23 | c385d52 | 5,507 B | A | view · diff |
| git:20261014.5e2faed | 2026-10-14 | 5e2faed | 4,716 B | A | view · diff |
| git:20260717.efc442f | 2026-07-17 | efc442f | 4,378 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 (7098 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
qiaomiaojoe/ai-academic-workflow · 10 stars · license a license file GitHub does not identify · pushed 2026-11-03 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_dwe2jnm5ziw45gxx GET https://markdownregistry.com/api/v1/resolve?ref=qiaomiaojoe/ai-academic-workflow/lit-pdf-zotero GET https://markdownregistry.com/api/v1/blob/887f882025c4bcfc3f87bb406d18d62362b9803b9b0b3db4bc317adf81c47c05
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.