Back to Skills

literature-search

Search academic literature using Semantic Scholar, arXiv, and OpenAlex APIs. Returns structured JSONL with title, authors, year, venue, abstract, citations, and BibTeX. Use when the user needs to find papers, check related work, or build a bibliography.

199stars23forksUpdated 7/8/2026

Security Assessment

Safe(100/100)
Security Score100/100

About literature-search

literature-search finds relevant academic papers by querying several scholarly databases and returning a single, structured result set. Semantic Scholar is the primary source (strong for machine-learning and AI work and able to emit BibTeX), arXiv surfaces the latest preprints, OpenAlex adds the broadest free coverage with no API key, and CrossRef provides DOI-based lookup across the widest range of document types. Results are emitted as JSONL carrying title, authors, year, venue, abstract, citation counts, and BibTeX, and are finally presented as a table plus detailed entries keyed for citation.

Use it when finding papers, checking related work, or assembling a bibliography. The workflow expands the user's request into two to four complementary queries, runs Semantic Scholar first, adds arXiv for very recent preprints and optionally OpenAlex for breadth, then merges and deduplicates the JSONL files into one set. Candidates are ranked by a weighted blend of citations (0.3), recency (0.3), venue quality (0.2), and relevance (0.2), with venues bucketed into tiers: Tier 1 includes NeurIPS, ICML, ICLR, ACL, and CVPR, while workshops and arXiv preprints are flagged as preprints.

Helper scripts cover the full pipeline: per-database search, merge and dedup via paper_db.py, BibTeX generation with bibtex_manager.py, and download_arxiv_source.py to pull a paper's source .tex files by title or arXiv id. It sits upstream of related skills for citation management, literature review, and related-work writing, and complements deep-research and novelty-assessment.

FAQ

Which databases does it search?

Semantic Scholar (primary, best for ML/AI and includes BibTeX), arXiv (latest preprints), OpenAlex (broadest, free, no API key), and CrossRef (DOI-based lookup across the widest type coverage).

What format are results returned in?

Structured JSONL with title, authors, year, venue, abstract, citations, and BibTeX; final results are presented as a table plus detailed entries with BibTeX keys, always noting preprint status.

How are papers ranked?

By a weighted blend: citations 0.3, recency 0.3, venue quality 0.2, and relevance 0.2, with venues grouped into quality tiers.

Do I need an API key?

Semantic Scholar uses an S2 API key read from a keys file, while OpenAlex and CrossRef require no API key.

Can it fetch a paper's source files?

Yes. download_arxiv_source.py retrieves arXiv .tex source by title or --arxiv-id, and bibtex_manager.py generates a .bib file from the merged results.

All Files

4 files
scripts/download_arxiv_source.py8.0 KB
View
SKILL.md3.1 KB
View
scripts/search_openalex.py6.7 KB
View
scripts/search_crossref.py8.7 KB
View

Install literature-search

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill