Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add YuanyuanMa03/academic-research-skills --skill scansci-pdfgit clone --depth 1 https://github.com/YuanyuanMa03/academic-research-skillsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/yuanyuanma03/academic-research-skills/scansci-pdf)<a href="https://agentmods.dev/skills/yuanyuanma03/academic-research-skills/scansci-pdf"><img src="https://agentmods.dev/badge/skills/yuanyuanma03/academic-research-skills/scansci-pdf/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/yuanyuanma03/academic-research-skills/scansci-pdf"><img src="https://agentmods.dev/badge/skills/yuanyuanma03/academic-research-skills/scansci-pdf.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00148 | $0.01837 |
| Opus 5.5 | $0.00059 | $0.00735 |
| Sonnet 5.5 | $0.00030 | $0.00367 |
| Haiku 4.5 | $0.00015 | $0.00184 |
Grade A, and why
scansci-pdf scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 94 lines — stays where its author put it; the contents beside it link to each section on GitHub.
ScanSci PDF — 论文获取 / 引文 / Zotero
本技能桥接开源项目 scansci-pdf（MIT）的 MCP server：20+ 数据源并行竞速，任一成功立即返回；每篇结果都报告实际来源。它取代了本仓库早期的 *-download / *-export / zotero-csl 技能——平台站内检索仍用 cnki-search、pm-search 等技能，拿到条目后交给本技能完成下载、引文与推送。
前置条件 (Prerequisites)
MCP server 需要 Python ≥ 3.11 和 scansci-pdf 命令。安装本插件后若工具列表中没有 scansci_pdf_* 工具，按以下步骤引导（steps 按顺序执行，遇到问题转排障表）：
# 1. 检查 Python 版本（需要 >= 3.11）
python3 --version
# 2a. 推荐：独立 venv 安装（不污染用户环境）
python3 -m venv ~/.scansci-pdf/venv && ~/.scansci-pdf/venv/bin/pip install scansci-pdf
# 2b. 或一行式（需要 uv）
uvx --from scansci-pdf scansci-pdf check
# 3. 环境自检，按 readiness 分级处理
scansci-pdf check
ready：全部就绪，直接走工作流。partial：核心可用、可选组件缺失（浏览器后端、Tor 等），按提示安装，不阻塞下载。limited：缺关键依赖，先完成安装再继续。
安装后需重启宿主（或重载插件）让 MCP server 生效。CLI（scansci-pdf get/search/batch/...）与 MCP 工具能力等价，MCP 不可用时用 CLI 兜底。
工作流 (Workflow)
场景 → 工具路由
| 用户想做什么 | 用什么 |
|---|---|
| 下载单篇（DOI / arXiv / 文章页 URL） | scansci_pdf_download（可带 si=true 拉补充材料、md=true 转 Markdown） |
| 批量下载一份清单（xlsx/csv/txt/bib/APA） | scansci_pdf_parse_list → scansci_pdf_batch_download |
| 验证 / 嗅探一批标识符 | scansci_pdf_prepare_queue(action="verify")；找 OA 副本用 action="resolve_oa" |
| 跨源检索文献（含作者、被引过滤） | scansci_pdf_search（可选 scansci_pdf_sciverse 语义检索） |
| 导出引文 | scansci_pdf_citation（bibtex / ris / endnote） |
| 推送到 Zotero | scansci_pdf_zotero_push（本地 Zotero 需在运行） |
| 机构登录 / 渠道状态 | scansci_pdf_login、scansci_pdf_channel_status、scansci_pdf_schools |
| 环境或下载排障 | `scansci_pdf_diagnostics(check=health |
| 模糊引用（"Wang 2023 CRISPR 那篇"） | 先 scansci_pdf_search 拿候选让用户确认，不要硬猜 DOI |
策略选择（必读）
用户指定了来源 = 只按用户的来，调度不得扩大授权范围：
| 用户说的是 | 策略 |
|---|---|
| "从 Sci-Hub 下载" | scihub_only |
| "优先 scihub" | scihub_first（OA 仍竞速，更快时最终来源可能是 OA） |
| "只要免费合法的" | legal_only（排除 Sci-Hub / LibGen） |
| 未指定 | fastest（默认，全源并行竞速） |
机构通道两条事实（失败大多源于此）
- 登录必须用工具自己打开的浏览器：
scansci_pdf_login打开的可见浏览器窗口才是 cookie 抓取上下文；用户自己浏览器里的登录态、无头模式，都拿不到。 - 出口 IP 决定机构权限：出版商按请求源 IP 判权益。系统级代理会把出口 IP 移出校园网段，静默作废 IP 认证。出版商报"无权限"时，先读错误页上它看到的 IP，再下"学校没订阅"的结论。工具只认
network_proxy/SCANSCI_PDF_PROXY，忽略HTTP_PROXY。
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- today First seen · 94 lines · 148 tokens per session scan A a34e359c3ef0
scansci-pdf is a skill published in the GitHub repository YuanyuanMa03/academic-research-skills (75 stars, last pushed today), licensed MIT. It adds 148 tokens to every session and 1,837 once invoked, about $0.0006 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-10-29.
Other skills, from other repositories
paper2poster-poster
Use when the user wants to turn an academic paper into a conference poster, poster outline, poster copy deck, poster layout brief, poster.yaml style draft, or Paper2Poster-ready generation package. Trigger for paper-to-poster requests involving PDF papers, arXiv links, manuscripts, PPTX posters, conference…
manuscript-optimizer
Use when auditing, restructuring, or revising a research manuscript whose scientific question, claim hierarchy, evidence chain, section logic, figures, terminology, or prose may be unclear or out of sync. Apply before sentence-level polishing, especially for whole drafts, major revisions, resubmissions, overclaiming…
review-article-architecture
Use when writing, restructuring, or auditing a Review, survey, or Perspective rather than a research article, especially a commissioned one written across many sessions. Covers the governing plan document, drift detection, single-definition thesis and field judgements, section-owns-figure allocation, display-item…
write-scientific-manuscript
Diagnose and repair the clarity and logic of manuscript prose, journal-agnostic. Use when a passage is technically correct but hard to follow: buried topic sentences, missing logical bridges, ambiguous referents, abstract noun chains, overloaded sentences, incomplete comparisons with no stated dataset or metric or…
paper-reviewer
Referee-side skill for Nature Portfolio manuscripts: write a referee report, inventory every ask and sub-ask in received comments, grade drafted replies, and test reply readability. Check methodology, statistics, reporting, reproducibility and data/code availability. Preserve referee wording, numbering and order…
figure-planner
Use when designing, restructuring, or auditing manuscript figures and you need to define one main claim per figure, assign panel roles, align legends with the text, or decide what belongs in main figures versus supplement.