Agent skill

Paper Search

by dr-dumpling in dr-dumpling/paper-search-cli

学术文献检索与论文获取调度器,基于 paper-search CLI,而不是 MCP server. An agent skill from dr-dumpling/paper-search-cli.

MITAuto-check passedResearch & Science

Install Paper Search

skills CLI
$ npx skills add dr-dumpling/paper-search-cli --skill paper-search -a claude-code

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

GitHub CLI
$ gh skill install dr-dumpling/paper-search-cli paper-search --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/dr-dumpling/paper-search-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/paper-search .claude/skills/paper-search && 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/

Facts

Skill name
paper-search
GitHub stars
135
Token cost
~1.1k tokens
SKILL.md length
242 words
Files
4 (incl. references)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

学术文献检索与论文获取调度器,基于 paper-search CLI,而不是 MCP server. An agent skill from dr-dumpling/paper-search-cli.

  • Works in 2 steps: 先做… → 用户确认条目或任务明确需要 PDF 后,再做…
  • Tasks that involve Academic paper search
  • SKILL.md covers 快速自检, 功能地图, 默认工作流 and 验证与输出边界, plus 2 more sections
  • Calls npm and git; needs EASYSCHOLAR_KEY and SEMANTIC_SCHOLAR_API_KEY

What it does

Paper Search is an agent skill from dr-dumpling/paper-search-cli. 学术文献检索与论文获取调度器,基于 paper-search CLI,而不是 MCP server。 用于:搜索论文、查找相似研究、做文献综述初筛、验证 PMID/DOI、下载论文 PDF、 调用 Crossref/OpenAlex/PubMed/PMC/Europe PMC/arXiv/bioRxiv/medRxiv/Semantic Scholar/CORE/OpenAIRE/DBLP/ACM/USENIX/OpenReview/IACR 等来源, 使用 Semantic Scholar Open Access snippet 索引检索论文正文片段中的方法学细节, 通过 Semantic Scholar Graph API 查询已知论文的施引文献和参考文献, 以及通过 EasyScholar 查询期刊影响因子、JCR/SSCI 分区、中科院分区、JCI、ESI、预警和等级指标。 当用户提到“搜文献”“找论文”“文献检索”“search papers”“find papers”“literature search” “查一下有没有相关研究”“帮我找几篇参考文献”“看看别人怎么做的”“别人怎么写” “Methods…

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/capability-routing.md`, `references/cli-contract.md` and `references/management-layer.md`).

It sits in Research & Science, covering Academic paper search. It works with Semantic Scholar, arXiv, Model Context Protocol and PubMed. The repository describes itself as: Agent-friendly CLI for academic paper, journal metric search and paper download. The licence is MIT.

When your agent uses it

  • Tasks that involve Academic paper search

Example prompts

  • “search papers”
  • “find papers”
  • “literature search”
  • “/paper-search”

Requirements

  • Node.js
  • A credential in EASYSCHOLAR_KEY
  • A credential in SEMANTIC_SCHOLAR_API_KEY

Workflow steps

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

  1. 先做 metadata_search:检索和核验文献条目,确认题名、作者、年份、期刊、DOI、PMID/PMCID、URL、摘要线索和相关性。
  2. 用户确认条目或任务明确需要 PDF 后,再做 pdf_discovery:下载选中的已核验条目;下载失败项记录原因,不阻塞其他条目。

What it can do on your machine

Read from SKILL.md and the folder at commit d202649. 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

    Shell commands in SKILL.md call:

    • npm
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm and git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • EASYSCHOLAR_KEY
    • SEMANTIC_SCHOLAR_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Paper Search loads about 1.1k tokens when it runs, and up to ~6.6k if it reads all its reference files. Until then it costs about 203 tokens; SKILL.md has 242 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~203
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.6k

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 dr-dumpling/paper-search-cli at commit d202649, republished under its MIT licence (© dr-dumpling). 242 words, ~1,139 tokens.

Download SKILL.mdSave it as .claude/skills/paper-search/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
paper-search
description
学术文献检索与论文获取调度器,基于 paper-search CLI,而不是 MCP server。 用于:搜索论文、查找相似研究、做文献综述初筛、验证 PMID/DOI、下载论文 PDF、 调用 Crossref/OpenAlex/PubMed/PMC/Europe PMC/arXiv/bioRxiv/medRxiv/Semantic Scholar/CORE/OpenAIRE/DBLP/ACM/USENIX/OpenReview/IACR 等来源, 使用 Semantic Scholar Open Access snippet 索引检索论文正文片段中的方法学细节, 通过 Semantic Scholar Graph API 查询已知论文的施引文献和参考文献, 以及通过 EasyScholar 查询期刊影响因子、JCR/SSCI 分区、中科院分区、JCI、ESI、预警和等级指标。 当用户提到“搜文献”“找论文”“文献检索”“search papers”“find papers”“literature search” “查一下有没有相关研究”“帮我找几篇参考文献”“看看别人怎么做的”“别人怎么写” “Methods 里怎么做的”“Methods 写法”“方法学写法对照”“下载论文 PDF” “验证 PMID”“验证 DOI”“正文片段检索”“snippet search”“方法学细节检索” “影响因子”“IF”“JCR 分区”“中科院分区”“期刊分区”“期刊等级” “目标期刊指标”“journal metrics”等任务时使用。 此 skill 只负责指导 agent 调用 paper-search CLI;API key 必须通过 paper-search setup、 paper-search config、.env 或环境变量配置,绝不要写入 Skill 文件。

Paper Search CLI

你是学术文献检索调度器。本 Skill 是 Routing Skill:负责把用户意图路由到 paper-search CLI,并维护证据、密钥和下载边界。优先通过 paper-search CLI 完成论文检索、元数据核验、施引/参考文献扩展、正文片段检索、期刊指标查询和 PDF 获取;不要把本 Skill 当作密钥、cookie、账号或下载策略的存储位置。

Reference 读取规则:

  • 需要确认安装、配置、doctor、smoke、Skill 同步或健康状态时,读 references/management-layer.md。
  • 需要在搜索、期刊指标、PDF 获取、正文片段检索之间做路由时,读 references/capability-routing.md。
  • 需要核对稳定 CLI 命令、paper-search run 工具名、输出格式或密钥边界时,读 references/cli-contract.md。
  • 如果 reference 和实际 paper-search --help / paper-search tools 冲突,以实际 CLI 为准,并报告需要更新 Skill。

快速自检

第一次使用、环境不确定,或用户问“现在能用哪些能力”时:

bash
command -v paper-search
paper-search doctor --pretty

需要给用户一份可读健康报告时:

bash
paper-search doctor --format text

安装缺失时先说明缺失;用户要求安装时再执行:

bash
npm install -g paper-search-cli
paper-search setup
paper-search doctor --pretty

用户问“如何更新”、安装后怀疑 Skill 过期,或 doctor/skills status 显示 Skill 不同步时,先区分包本体更新和 Skill 同步;不要只运行 skills update。完整流程查看 references/management-layer.md 的 Package Update And Capability Setup。

普通用户更新:

bash
npm install -g paper-search-cli@latest
paper-search skills update --targets agents --pretty
paper-search doctor --pretty

本地维护者更新:

bash
git pull
npm install
npm run build
npm install -g .
paper-search skills update --targets agents --pretty
paper-search doctor --pretty

缺少 API key 或 email 时,不要让用户在聊天里发送密钥;提示用户用 paper-search setup 或 paper-search config 在本机配置。

功能地图

本 Skill 只有五个文献主功能。doctor、smoke、config、skills 是管理层命令,不属于文献任务本身。

用户意图能力名首选入口关键边界
搜论文、找相关研究、验证 DOI/PMID、做文献初筛metadata_searchpaper-search search 集成入口 / paper-search run search_* 精确工具入口只返回和核验论文元数据;Sci-Hub 不属于搜索源
查询已知论文的施引文献或参考文献citation_expansionpaper-search run get_paper_citations / paper-search run get_paper_references需要已知 paperId、DOI 或 arXiv ID;不是关键词检索
查影响因子、JCR/SSCI/中科院分区、JCI、ESI、预警、期刊等级journal_metricspaper-search journal-metrics / paper-search run query_journal_metrics这是期刊指标查询,不是论文检索;需要 EASYSCHOLAR_KEY
获取或下载已确认论文的 PDFpdf_discoverypaper-search download / paper-search run download_with_fallback先核验论文身份,再下载;Sci-Hub 是默认开启的最后 fallback
在论文正文片段中找 Methods/参数/写法线索body_snippet_searchpaper-search run search_semantic_snippets查 Semantic Scholar OA snippet 索引;需要 SEMANTIC_SCHOLAR_API_KEY;不是完整全文解析

默认工作流

开放式文献任务使用 Two-Stage Paper Workflow:

  1. 先做 metadata_search:检索和核验文献条目,确认题名、作者、年份、期刊、DOI、PMID/PMCID、URL、摘要线索和相关性。
  2. 用户确认条目或任务明确需要 PDF 后,再做 pdf_discovery:下载选中的已核验条目;下载失败项记录原因,不阻塞其他条目。

Direct Paper Request 可以跳过广泛发现:用户给出单个 DOI、PMID、PMCID、arXiv ID 或已核验清单并明确要求下载时,先核验目标身份,再进入下载。

验证与输出边界

关键论文输出前尽量验证:

bash
paper-search run search_pubmed --arg query="37654321[PMID]" --arg maxResults=1 --pretty
paper-search run get_paper_by_doi --arg doi="10.xxxx/xxxxx" --pretty
paper-search run search_crossref --arg query="full paper title" --arg maxResults=3 --pretty

规则:

  • 不凭模型记忆编造 PMID、DOI、期刊、年份或作者。
  • PMID 必须能被 PubMed 查询确认;DOI 必须能被 DOI 查询或 Crossref/OpenAlex/Semantic Scholar 结果支持。
  • 同一论文的 PMID、DOI、题名、第一作者和年份应一致;不一致时标记为可疑。
  • config / doctor 输出应视为已脱敏,但不要复述、保存或写入任何原始密钥。

常见失败处理

场景处理
CLI 不存在提示安装 npm install -g paper-search-cli
API key 缺失提示运行 paper-search setup;不要索要或保存 key
EasyScholar key 缺失提示运行 paper-search setup EASYSCHOLAR_KEY;不要让用户在聊天中发送 SecretKey
429 限流降低 --max-results,换平台,或提示配置可选 key
0 结果放宽关键词,换英文同义词,换平台,或用 --sources 扩展
下载失败优先开放获取来源和 download_with_fallback,报告失败原因
用户要求完整正文先下载 PDF;再交给当前环境可用的 PDF/MinerU 解析流程

不属于本 Skill 的事

  • 不管理 Zotero、Obsidian 或其他文献库。
  • 不写论文正文,不做语言润色。
  • 不把 API key、token、cookie 写入 Skill、README 或回复。

© dr-dumpling, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in skills/paper-search of dr-dumpling/paper-search-cli.

  • SKILL.md
  • references/capability-routing.md
  • references/cli-contract.md
  • references/management-layer.md

Open the folder on GitHubat commit d202649

Compare with similar skills

Paper Search 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.

Paper Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Paper Search this skilldr-dumpling/paper-search-cli135—~1.1kAutomated safety check: PassMIT
Paper Searchopenags/paper-search-mcp2.8k—~1.2kAutomated safety check: NotesMIT
Nature Academic Searchwp-a/nature-academic-search301—~1.4kAutomated safety check: PassMIT
Paper Searchopenags/paper-search-mcp2.8k—~794Automated safety check: NotesMIT
Nature Academic Searchjing1312/nature-figure-skill168—~1.3kAutomated safety check: NotesMIT
Ai4scholar ResearchDrchronx/ai-agent-research-starter-kit137—~1.4kAutomated safety check: PassCustom licence

Similar skills

  • Paper Search

    openags/paper-search-mcp

    Search, download, and read academic papers from 20+ sources (arXiv, PubMed, Semantic Scholar, CrossRef, etc).

    2.8k GitHub stars~1.2k tokensUpdated 7 days ago
    Research & ScienceAuto-check: notes
  • Nature Academic Search

    wp-a/nature-academic-search

    A skill your agent uses when users ask to 找文献、做文献检索、查论文、查临床试验、核验引用、去重文献、设计 PubMed/MeSH 检索式、追踪上下游引文、解析 DOI/PMID/PMCID/arXiv/OpenAlex/Semantic Scholar/NCT ID, 或导出 RIS、BibTeX、NBIB、ENW;also use for…

    301 GitHub stars~1.4k tokensUpdated 7 days ago
    Research & ScienceAuto-check passed
  • Paper Search

    openags/paper-search-mcp

    Search, download, and read academic papers through the paper-search MCP tools (mcppaper-search), covering arXiv, PubMed, bioRxiv, Semantic Scholar, Crossref, OpenAlex and 15+ other sources.

    2.8k GitHub stars~794 tokensUpdated 7 days ago
    Research & ScienceAuto-check: notes
  • Nature Academic Search

    jing1312/nature-figure-skill

    Multi-source literature search, citation verification, MeSH search strategy, citation file management (.nbib/.ris/.bib conversion), and reference management (BibTeX, related articles, ID conversion)…

    168 GitHub stars~1.3k tokensUpdated 1 mo ago
    Research & ScienceAuto-check: notes
  • Ai4scholar Research

    Drchronx/ai-agent-research-starter-kit

    Use AI4Scholar for real scholarly literature tasks through MCP or the OpenClaw plugin: paper search, Google Scholar/Semantic Scholar/PubMed/arXiv/bioRxiv/medRxiv queries, PDF download and reading…

    137 GitHub stars~1.4k tokensUpdated 4 mo ago
    Research & ScienceAuto-check passed
  • Literature Review

    neflibata-feng/MyArxiv-Agent

    Conduct comprehensive, systematic literature reviews using multiple academic databases (PubMed, arXiv, bioRxiv, Semantic Scholar, etc.).

    126 GitHub starsUsed in 20 repos~5.9k tokens
    Research & ScienceAuto-check: notes

Questions about Paper Search

What does Paper Search do?

学术文献检索与论文获取调度器,基于 paper-search CLI,而不是 MCP server. An agent skill from dr-dumpling/paper-search-cli. Paper Search is an agent skill from dr-dumpling/paper-search-cli.

When should I use Paper Search?

Paper Search fits situations like: tasks that involve Academic paper search.

How do I install Paper Search in Claude Code?

Run `npx skills add dr-dumpling/paper-search-cli --skill paper-search -a claude-code`. Or copy the skill folder (skills/paper-search in dr-dumpling/paper-search-cli) into .claude/skills/paper-search in your project. Claude Code loads it when a task matches its description.

How do I install Paper Search in Codex?

Run `npx skills add dr-dumpling/paper-search-cli --skill paper-search -a codex`. Or copy the skill folder (skills/paper-search in dr-dumpling/paper-search-cli) into .agents/skills/paper-search in your project. Codex loads it when a task matches its description.

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

What does Paper Search need to run?

Going by SKILL.md and its folder, Paper Search needs the command-line tools its instructions call (npm and git) and credentials named EASYSCHOLAR_KEY and SEMANTIC_SCHOLAR_API_KEY. Our summary lists: Node.js; A credential in EASYSCHOLAR_KEY; A credential in SEMANTIC_SCHOLAR_API_KEY.

Does Paper Search access the network?

SKILL.md contains no URLs. Its commands use npm and git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Paper Search 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 Paper Search use?

Paper Search 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 Paper Search use?

About 1.1k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.4k tokens, read only when the agent opens those files.

What are the alternatives to Paper Search?

Skills that share tags, products or a category with Paper Search: Paper Search (openags/paper-search-mcp, 2.8k stars), Nature Academic Search (wp-a/nature-academic-search, 301 stars), Paper Search (openags/paper-search-mcp, 2.8k stars) and Nature Academic Search (jing1312/nature-figure-skill, 168 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Paper Search?

dr-dumpling (a GitHub user) maintains it in dr-dumpling/paper-search-cli, which has 135 GitHub stars. The repository was last updated on June 22, 2026.

Source: dr-dumpling/paper-search-cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.