Skip to main content
skill CX Codex

arxiv-search · spring-ai-alibaba — Claude Code skill: search arXiv preprints

arxiv-search searches arXiv for preprints and returns titles with abstracts. Handy when you need papers that have not reached a journal yet.

Apache-2.0 1 installs ★ 2,933 updated 2026-07-01

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add spring-ai-alibaba/examples --skill arxiv-search -a claude-code
Open on GitHub

What arxiv-search does

The skill hands your agent a Python script, arxiv_search.py, which queries arXiv with a search string. Results come back sorted by relevance, each entry a title followed by its abstract, with blank lines between them.

Call the script by its full path inside the skills directory. --max-papers caps the list; leave it out and you get 10. No key, no signup: the script talks to arXiv directly. Run the agent from a virtualenv and you must use that environment's interpreter, .venv/bin/python.

One catch: the arxiv package has to be there. Without it the script halts and tells you to install it, so run python3 -m pip install arxiv before the first search. Also remember what arXiv holds — preprints, and some have not been peer-reviewed, which matters once the list lands in a paper or a report.

What it helps with

  • pull recent preprints on a topic before journal publication
  • find machine learning papers applied to biological problems
  • check whether a method exists outside PubMed
  • get titles and abstracts from one command
  • trim the output with --max-papers so the list stays readable

Example prompts for the agent

  • Find recent arXiv papers on protein structure prediction.
  • Search arXiv for genome assembly algorithms and show the titles with abstracts.
  • Run arxiv_search.py for “single cell RNA-seq” and keep the default ten results.

How to install arxiv-search

1Skills CLI (Vercel)

npx skills add spring-ai-alibaba/examples --skill arxiv-search -a claude-code

2Manually: put the files in place

~/.claude/skills/arxiv-search/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/arxiv-search/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about arxiv-search

How do I install arxiv-search in Claude Code?

Run npx skills add spring-ai-alibaba/examples --skill arxiv-search -a claude-code. The skill file lands at ~/.claude/skills/arxiv-search/SKILL.md. Then install the arxiv Python package.

What does arxiv-search do?

It runs a Python script that queries arXiv and returns matching preprints as titles plus abstracts, ordered by relevance.

Do I need an API key?

No. Access through the script is open; what you do need is the arxiv package installed for the Python interpreter that runs it.

Source text

SKILL.md · Apache-2.0
---
name: arxiv-search
description: Search arXiv preprint repository for papers in physics, mathematics, computer science, quantitative biology, and related fields, Instructions for searching arXiv papers using Python script and shell tool. Read SKILL.md to learn the workflow.
---

# arXiv Search Skill

This skill provides access to arXiv, a free distribution service and open-access archive for scholarly articles in physics, mathematics, computer science, quantitative biology, quantitative finance, statistics, electrical engineering, systems science, and economics.

## When to Use This Skill

Use this skill when you need to:
- Find preprints and recent research papers before journal publication
- Search for papers in computational biology, bioinformatics, or systems biology
- Access mathematical or statistical methods papers relevant to biology
- Find machine learning papers applied to biological problems
- Get the latest research that may not yet be in PubMed

## How to Use

The skill provides a Python script that searches arXiv and returns formatted results.

### Basic Usage

**Note:** Always use the absolute path from your skills directory (shown in the system prompt above).

If running deepagents from a virtual environment:
```bash
.venv/bin/python [YOUR_SKILLS_DIR]/arxiv-search/arxiv_search.py "your search query" [--max-papers N]
```

Or for system Python:
```bash
python3 [YOUR_SKILLS_DIR]/arxiv-search/arxiv_search.py "your search query" [--max-papers N]
```

Replace `[YOUR_SKILLS_DIR]` with the absolute skills directory path from your system prompt (e.g., `~/.deepagents/agent/skills` or the full absolute path).

**Arguments:**
- `query` (required): The search query string (e.g., "neural networks protein structure", "single cell RNA-seq")
- `--max-papers` (optional): Maximum number of papers to retrieve (default: 10)

### Examples

Search for machine learning papers:
```bash
.venv/bin/python ~/.deepagents/agent/skills/arxiv-search/arxiv_search.py "deep learning drug discovery" --max-papers 5
```

Search for computational biology papers:
```bash
.venv/bin/python ~/.deepagents/agent/skills/arxiv-search/arxiv_search.py "protein folding prediction"
```

Search for bioinformatics methods:
```bash
.venv/bin/python ~/.deepagents/agent/skills/arxiv-search/arxiv_search.py "genome assembly algorithms"
```

## Output Format

The script returns formatted results with:
- **Title**: Paper title
- **Summary**: Abstract/summary text

Each paper is separated by blank lines for readability.

## Features

- **Relevance sorting**: Results ordered by relevance to query
- **Fast retrieval**: Direct API access with no authentication required
- **Simple interface**: Clean, easy-to-parse output
- **No API key required**: Free access to arXiv database

## Dependencies

This skill requires the `arxiv` Python package. The script will detect if it's missing and show an error.

**If you see "Error: arxiv package not installed":**

If running deepagents from a virtual environment (recommended), use the venv's Python:
```bash
.venv/bin/python -m pip install arxiv
```

Or for system-wide install:
```bash
python3 -m pip install arxiv
```

The package is not included in deepagents by default since it's skill-specific. Install it on-demand when first using this skill.

## Notes

- arXiv is particularly strong for:
    - Computer science (cs.LG, cs.AI, cs.CV)
    - Quantitative biology (q-bio)
    - Statistics (stat.ML)
    - Physics and mathematics
- Papers are preprints and may not be peer-reviewed
- Results include both recent uploads and older papers
- Best for computational/theoretical work in biology

© spring-ai-alibaba · Apache-2.0 · spring-ai-alibaba/examples

Similar skills

All skills for Science and research →

arxiv-search by other authors comes first.

arxiv-search yorkeccak arxiv-search searches arXiv preprints across physics, math, and computer science using natural language via Valyu. Useful for tracking research before peer review. CX Codex +1 1,100installs literature-search-arxiv google-deepmind literature-search-arxiv searches arXiv for papers and preprints, returns metadata and abstracts, and downloads full text as PDF, HTML or LaTeX source. CX Codex +1 3,700installs arxiv wanshuiyin Searches arXiv, downloads PDFs into a local folder and writes a short summary. Handy when you need literature on a topic without leaving the chat. CX Codex +1 628installs pp-arxiv Hiten Shah pp-arxiv — a skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode that connects to the public arXiv Atom API to search and fetch preprint metadata. No API key needed. CX Codex +1 407installs arxiv-watcher sundial-org The arxiv-watcher skill searches ArXiv for recent papers by keyword, author, or category and delivers concise summaries. Use it to track the latest research on a topic or get a daily digest of papers in your field. CX Codex +1 145installs ArXiv Scout shawnnygoh ArXiv Scout searches arXiv, extracts text from PDFs, and tracks citations through Semantic Scholar. No API key required; gather research materials and build literature reviews in seconds. CX Codex +1 3,426installs arxiv-viewer actionbook arxiv-viewer is a Claude Code skill for research workflows that searches, downloads, and reads academic papers from arXiv using its official API and ar5iv HTML pages. CX Codex +1 133installs

Project sponsors

Companies that keep this analytics open