Agent skill

Paper Lookup

by zLanqing in zLanqing/codex-claude-academic-skills

Search 10 academic paper databases via REST APIs for research papers, preprints, and scholarly articles.

MITAuto-check: notesResearch & Science

Install Paper Lookup

skills CLI
$ npx skills add zLanqing/codex-claude-academic-skills --skill paper-lookup -a claude-code

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

GitHub CLI
$ gh skill install zLanqing/codex-claude-academic-skills paper-lookup --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/zLanqing/codex-claude-academic-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/scientific-toolkit-skill/references/scientific-skills/paper-lookup .claude/skills/paper-lookup && 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-lookup
GitHub stars
4.7k
Used in
2 other repos
Token cost
~2.4k tokens
SKILL.md length
1,128 words
Files
11 (incl. references)
Skills in repo
17
Repo updated
First seen
Licence
MIT

At a glance

Search 10 academic paper databases via REST APIs for research papers, preprints, and scholarly articles.

  • Works in 5 steps: Understand the query -- What is the user… → Select database(s) -- Use the database… → Read the reference file -- Each database… → …
  • Searching for papers
  • SKILL.md covers Core Workflow, Database Selection Guide, Common Identifier Formats and API Keys and Access, plus 3 more sections
  • Needs NCBI_API_KEY and CORE_API_KEY

What it does

Paper Lookup is an agent skill from zLanqing/codex-claude-academic-skills. Search 10 academic paper databases via REST APIs for research papers, preprints, and scholarly articles. Covers PubMed, PMC (full text), bioRxiv, medRxiv, arXiv, OpenAlex, Crossref, Semantic Scholar, CORE, Unpaywall. Use when searching for papers, citations, DOI/PMID lookups, abstracts, full text, open access, preprints, citation graphs, author search, or any scholarly literature query. Triggers on mentions of any supported database or requests like "find papers on X" or "look up this DOI".

Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including reference files (for example `references/arxiv.md`, `references/biorxiv.md` and `references/core.md`).

It sits in Research & Science, covering Academic paper search. It works with Semantic Scholar, arXiv and PubMed. The repository describes itself as: 本仓库包含三个面向学术科研人员的Skills,覆盖从文献阅读、论文写作到科学计算的完整研究工作流。office-academic-skill 负责论文阅读报告与学术 PPT/Word 文档生成;research-writing-skill 提供论文写作、润色与审稿回复辅助;scientific-toolkit-skill 整合 MATLAB/Python… The licence is MIT.

When your agent uses it

  • Searching for papers
  • DOI/PMID lookups
  • Citation graphs
  • Any scholarly literature query

Example prompts

  • “find papers on X”
  • “look up this DOI”
  • “/paper-lookup”

Requirements

  • A credential in NCBI_API_KEY
  • A credential in CORE_API_KEY

Workflow steps

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

  1. Understand the query -- What is the user looking for? A specific paper by DOI? Papers on a topic? An author's publications? Open access…
  2. Select database(s) -- Use the database selection guide below. Many queries benefit from hitting multiple databases -- for example…
  3. Read the reference file -- Each database has a reference file in references/ with endpoint details, query formats, and example calls. Read…
  4. Make the API call(s) -- See the Making API Calls section below for which HTTP fetch tool to use on your platform.
  5. Return results -- Always return

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    Links to these hosts (documentation or services it may open):

    • ncbi.nlm.nih.gov
    • core.ac.uk
    • semanticscholar.org
    • openalex.org

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

  • Credentials

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

    • NCBI_API_KEY
    • CORE_API_KEY
    • S2_API_KEY
    • OPENALEX_API_KEY

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

Context cost

Paper Lookup loads about 2.4k tokens when it runs, and up to ~13k if it reads all its reference files. Until then it costs about 127 tokens; SKILL.md has 1,128 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:106
    2. **Fall back to `.env`** -- check `.env` in the current working directory.

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 zLanqing/codex-claude-academic-skills at commit 7ed6377, republished under its MIT licence (© zLanqing). 1,128 words, ~2,409 tokens.

Download SKILL.mdSave it as .claude/skills/paper-lookup/SKILL.md (or your agent's skills folder). This skill also uses 10 other files; get the full folder from GitHub.
name
paper-lookup
description
Search 10 academic paper databases via REST APIs for research papers, preprints, and scholarly articles. Covers PubMed, PMC (full text), bioRxiv, medRxiv, arXiv, OpenAlex, Crossref, Semantic Scholar, CORE, Unpaywall. Use when searching for papers, citations, DOI/PMID lookups, abstracts, full text, open access, preprints, citation graphs, author search, or any scholarly literature query. Triggers on mentions of any supported database or requests like "find papers on X" or "look up this DOI".
metadata.skill-author
K-Dense Inc.

Paper Lookup

You have access to 10 academic paper databases through their REST APIs. Your job is to figure out which database(s) best serve the user's query, call them, and return the results.

Core Workflow

  1. Understand the query -- What is the user looking for? A specific paper by DOI? Papers on a topic? An author's publications? Open access PDFs? Full text? This determines which database(s) to hit.

  2. Select database(s) -- Use the database selection guide below. Many queries benefit from hitting multiple databases -- for example, searching PubMed for papers and then checking Unpaywall for open access copies.

  3. Read the reference file -- Each database has a reference file in references/ with endpoint details, query formats, and example calls. Read the relevant file(s) before making API calls.

  4. Make the API call(s) -- See the Making API Calls section below for which HTTP fetch tool to use on your platform.

  5. Return results -- Always return:

    • The raw JSON (or parsed XML for arXiv) response from each database
    • A list of databases queried with the specific endpoints used
    • If a query returned no results, say so explicitly rather than omitting it

Database Selection Guide

Match the user's intent to the right database(s).

By Use Case
User is asking about...Primary database(s)Also consider
Papers on a biomedical topicPubMedSemantic Scholar, OpenAlex
Full text of a biomedical articlePMCCORE
Biology preprintsbioRxivSemantic Scholar, OpenAlex
Health/medical preprintsmedRxivSemantic Scholar, OpenAlex
Physics, math, or CS preprintsarXivSemantic Scholar, OpenAlex
Papers across all fieldsOpenAlexSemantic Scholar, Crossref
A specific paper by DOICrossrefUnpaywall, Semantic Scholar
Open access PDF for a paperUnpaywallCORE, PMC
Citation graph (who cites whom)Semantic ScholarOpenAlex
Author's publicationsSemantic ScholarOpenAlex
Paper recommendationsSemantic Scholar--
Full text (any field)COREPMC (biomedical only)
Journal/publisher metadataCrossrefOpenAlex
Funder informationCrossrefOpenAlex
Convert between PMID/PMCID/DOIPMC (ID Converter)Crossref
Recent preprints by datebioRxiv, medRxivarXiv
Cross-Database Queries
User is asking about...Databases to query
Everything about a paper (metadata + citations + OA)Crossref + Semantic Scholar + Unpaywall
Comprehensive literature searchPubMed + OpenAlex + Semantic Scholar
Find and read a paperPubMed (find) + Unpaywall (OA link) + PMC or CORE (full text)
Preprint and its published versionbioRxiv/medRxiv + Crossref
Author overview with citation metricsSemantic Scholar + OpenAlex

When a query spans multiple needs (e.g., "find papers about CRISPR and get me the PDFs"), query the relevant databases in parallel.

Common Identifier Formats

Different databases use different identifier systems. If a query fails, the identifier format may be wrong.

IdentifierFormatExampleUsed by
DOI10.xxxx/xxxxx10.1038/nature12373All databases
PMIDInteger34567890PubMed, PMC, Semantic Scholar
PMCIDPMC + digitsPMC7029759PMC, Europe PMC
arXiv IDYYMM.NNNNN2103.15348arXiv, Semantic Scholar
OpenAlex IDW + digitsW2741809807OpenAlex
Semantic Scholar ID40-char hex649def34f8be...Semantic Scholar
ORCID0000-XXXX-XXXX-XXXX0000-0001-6187-6610OpenAlex, Crossref
ISSNXXXX-XXXX0028-0836Crossref, OpenAlex

Cross-referencing IDs: Semantic Scholar accepts DOI, PMID, PMCID, and arXiv ID via prefixes (e.g., DOI:10.1038/nature12373, PMID:34567890, ARXIV:2103.15348). OpenAlex accepts DOI and PMID via prefixes (doi:10.1038/..., pmid:34567890). Use the PMC ID Converter to translate between PMID, PMCID, and DOI.

API Keys and Access

Most of these databases are fully open. A few benefit from API keys for higher rate limits.

Databases requiring or benefiting from API keys
DatabaseEnv VariableRequired?Registration
NCBI (PubMed, PMC)NCBI_API_KEYNo (3 req/s without, 10 with)https://www.ncbi.nlm.nih.gov/account/settings/
CORECORE_API_KEYYes for full texthttps://core.ac.uk/services/api
Semantic ScholarS2_API_KEYNo (shared pool without)https://www.semanticscholar.org/product/api#api-key-form
OpenAlexOPENALEX_API_KEYRecommendedhttps://openalex.org/settings/api
Fully open databases (no key needed)
DatabaseNotes
bioRxiv / medRxivNo auth, no documented rate limits
arXivNo auth, max 1 request per 3 seconds
CrossrefNo auth; add mailto param for polite pool (2x rate limit)
UnpaywallNo auth; requires email parameter
Loading API keys
  1. Check the environment first -- the key may already be exported (e.g., $NCBI_API_KEY).
  2. Fall back to .env -- check .env in the current working directory.
  3. Proceed without -- most APIs still work at lower rate limits. Tell the user which key is missing and how to get one.
Show full SKILL.md (458 more words)Show less

Making API Calls

Use your environment's HTTP fetch tool to call REST endpoints:

PlatformHTTP Fetch ToolFallback
Claude CodeWebFetchcurl via Bash
Gemini CLIweb_fetchcurl via shell
Windsurfread_url_contentcurl via terminal
CursorNo dedicated fetch toolcurl via run_terminal_cmd
Codex CLINo dedicated fetch toolcurl via shell
ClineNo dedicated fetch toolcurl via execute_command

If the fetch tool fails, fall back to curl via whatever shell tool is available.

Special cases
  • arXiv returns Atom XML, not JSON. Parse it or use curl and extract the relevant fields. Consider piping through a simple parser if available.
  • PMC eFetch returns JATS XML for full text. This is expected -- full text articles are in XML format.
  • Crossref and Unpaywall benefit from including a mailto parameter or email for the polite/fast pool.
Request guidelines
  • For NCBI APIs (PubMed, PMC): max 3 req/sec without key, 10 with key. Make requests sequentially.
  • For arXiv: max 1 request every 3 seconds. Be patient.
  • For Crossref: 5 req/sec (public), 10 req/sec (polite pool with mailto).
  • For other APIs with no strict limits, you can query multiple databases in parallel.
  • If you get HTTP 429 (rate limit), wait briefly and retry once.
Error recovery
  1. Check the identifier format -- use the Common Identifier Formats table. A PMID won't work in arXiv, an arXiv ID won't work in PubMed directly.
  2. Try alternative identifiers -- if a DOI fails in one database, try the title or PMID instead.
  3. Try a different database -- if PubMed returns nothing for a CS paper, try Semantic Scholar or OpenAlex.
  4. Report the failure -- tell the user which database failed, the error, and what you tried instead.

Output Format

Structure your response like this:

## Databases Queried
- **PubMed** -- esearch + esummary for "CRISPR gene therapy"
- **Unpaywall** -- DOI lookup for 10.1038/...

## Results

### PubMed
[raw JSON response or formatted results]

### Unpaywall
[raw JSON response]

If results are very large, present the most relevant portion and note that more data is available. But default to showing the full raw JSON -- the user asked for it.

Available Databases

Read the relevant reference file before making any API call.

Biomedical Literature
DatabaseReference FileWhat it covers
PubMedreferences/pubmed.md37M+ biomedical citations, abstracts, MeSH terms
PMCreferences/pmc.md10M+ full-text biomedical articles (JATS XML), ID conversion
Preprint Servers
DatabaseReference FileWhat it covers
bioRxivreferences/biorxiv.mdBiology preprints (browse by date/DOI, no keyword search)
medRxivreferences/medrxiv.mdHealth sciences preprints (browse by date/DOI, no keyword search)
arXivreferences/arxiv.mdPhysics, math, CS, biology, economics preprints (keyword search, Atom XML)
Multidisciplinary Indexes
DatabaseReference FileWhat it covers
OpenAlexreferences/openalex.md250M+ works, authors, institutions, topics, citation data
Crossrefreferences/crossref.md150M+ DOI metadata, journals, funders, references
Semantic Scholarreferences/semantic-scholar.md200M+ papers, citation graphs, AI-generated TLDRs, recommendations
Open Access & Full Text
DatabaseReference FileWhat it covers
COREreferences/core.md37M+ full texts from OA repositories worldwide
Unpaywallreferences/unpaywall.mdOA status and PDF links for any DOI

© zLanqing, 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 10 other files (references) in scientific-toolkit-skill/references/scientific-skills/paper-lookup of zLanqing/codex-claude-academic-skills.

  • SKILL.md
  • references/arxiv.md
  • references/biorxiv.md
  • references/core.md
  • references/crossref.md
  • references/medrxiv.md
  • references/openalex.md
  • references/pmc.md
  • references/pubmed.md
  • references/semantic-scholar.md
  • references/unpaywall.md

Open the folder on GitHubat commit 7ed6377

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in zLanqing/codex-claude-academic-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Paper Lookup 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 Lookup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Paper Lookup this skillzLanqing/codex-claude-academic-skills4.7k2 repos~2.4kAutomated safety check: NotesMIT
Literature Reviewneflibata-feng/MyArxiv-Agent12620 repos~5.9kAutomated safety check: NotesMIT
Paper Searchopenags/paper-search-mcp2.8k—~1.2kAutomated safety check: NotesMIT
Nature Academic Searchwp-a/nature-academic-search304—~1.4kAutomated safety check: PassMIT
Paper Searchopenags/paper-search-mcp2.8k—~794Automated safety check: NotesMIT
Nature Academic Searchjing1312/nature-figure-skill171—~1.3kAutomated safety check: NotesMIT

Similar skills

  • 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
  • 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 8 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…

    304 GitHub stars~1.4k tokensUpdated 8 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 8 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)…

    171 GitHub stars~1.3k tokensUpdated 1 mo ago
    Research & ScienceAuto-check: notes
  • Paper Search

    dr-dumpling/paper-search-cli

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

    135 GitHub stars~1.1k tokensUpdated 3 mo ago
    Research & ScienceAuto-check passed

More from zLanqing/codex-claude-academic-skills

All 17 skills in this repo
  • Matplotlib

    zLanqing/codex-claude-academic-skills

    Low-level plotting library for full customization. An agent skill from zLanqing/codex-claude-academic-skills.

    4.7k GitHub starsUsed in 17 repos~2.9k tokens
    Auto-check passed
  • Scikit Learn

    zLanqing/codex-claude-academic-skills

    Machine learning in Python with scikit-learn. An agent skill from zLanqing/codex-claude-academic-skills.

    4.7k GitHub starsUsed in 16 repos~3.9k tokens
    Auto-check passed
  • Simpy

    zLanqing/codex-claude-academic-skills

    Process-based discrete-event simulation framework in Python.

    4.7k GitHub starsUsed in 11 repos~3k tokens
    Auto-check passed
  • Networkx

    zLanqing/codex-claude-academic-skills

    Comprehensive toolkit for creating, analyzing, and visualizing complex networks and graphs in Python.

    4.7k GitHub starsUsed in 15 repos~3.2k tokens
    Auto-check passed
  • Seaborn

    zLanqing/codex-claude-academic-skills

    Statistical visualization with pandas integration. An agent skill from zLanqing/codex-claude-academic-skills.

    4.7k GitHub starsUsed in 15 repos~4.9k tokens
    Auto-check passed
  • Statsmodels

    zLanqing/codex-claude-academic-skills

    Statistical models library for Python. An agent skill from zLanqing/codex-claude-academic-skills.

    4.7k GitHub starsUsed in 15 repos~4.9k tokens
    Auto-check passed

Questions about Paper Lookup

What does Paper Lookup do?

Search 10 academic paper databases via REST APIs for research papers, preprints, and scholarly articles. Paper Lookup is an agent skill from zLanqing/codex-claude-academic-skills. Search 10 academic paper databases via REST APIs for research papers, preprints, and scholarly articles.

When should I use Paper Lookup?

Paper Lookup fits situations like: searching for papers; DOI/PMID lookups; citation graphs; any scholarly literature query.

How do I install Paper Lookup in Claude Code?

Run `npx skills add zLanqing/codex-claude-academic-skills --skill paper-lookup -a claude-code`. Or copy the skill folder (scientific-toolkit-skill/references/scientific-skills/paper-lookup in zLanqing/codex-claude-academic-skills) into .claude/skills/paper-lookup in your project. Claude Code loads it when a task matches its description.

How do I install Paper Lookup in Codex?

Run `npx skills add zLanqing/codex-claude-academic-skills --skill paper-lookup -a codex`. Or copy the skill folder (scientific-toolkit-skill/references/scientific-skills/paper-lookup in zLanqing/codex-claude-academic-skills) into .agents/skills/paper-lookup in your project. Codex loads it when a task matches its description.

Can I use Paper Lookup 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 zLanqing/codex-claude-academic-skills --skill paper-lookup -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-lookup, .gemini/skills/paper-lookup, .github/skills/paper-lookup and .opencode/skills/paper-lookup in your project.

What does Paper Lookup need to run?

Going by SKILL.md and its folder, Paper Lookup needs credentials named NCBI_API_KEY, CORE_API_KEY, S2_API_KEY and OPENALEX_API_KEY. Our summary lists: A credential in NCBI_API_KEY; A credential in CORE_API_KEY.

Does Paper Lookup access the network?

SKILL.md names 4 domains. As links in the text: ncbi.nlm.nih.gov, core.ac.uk, semanticscholar.org and openalex.org. This is read from the text; nothing was executed.

Is Paper Lookup safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Paper Lookup use?

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

About 2.4k tokens (SKILL.md is roughly 9.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 11k tokens, read only when the agent opens those files.

What are the alternatives to Paper Lookup?

Skills that share tags, products or a category with Paper Lookup: Literature Review (neflibata-feng/MyArxiv-Agent, 126 stars), Paper Search (openags/paper-search-mcp, 2.8k stars), Nature Academic Search (wp-a/nature-academic-search, 304 stars) and Paper Search (openags/paper-search-mcp, 2.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Paper Lookup?

zLanqing (a GitHub user) maintains it in zLanqing/codex-claude-academic-skills, which has 4,700 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on May 14, 2026.

Source: zLanqing/codex-claude-academic-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.