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
npx skills add spring-ai-alibaba/examples --skill arxiv-search -a claude-codeWhat 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-papersso the list stays readable
Example prompts for the agent
- Find recent arXiv papers on protein structure prediction.
- Search arXiv for
genome assembly algorithmsand show the titles with abstracts. - Run
arxiv_search.pyfor “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-code2Manually: put the files in place
~/.claude/skills/arxiv-search/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/arxiv-search/
1Skills CLI (Vercel)
npx skills add spring-ai-alibaba/examples --skill arxiv-search -a codex2Manually: put the files in place
.agents/skills/arxiv-search/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add spring-ai-alibaba/examples --skill arxiv-search -a cursor2Manually: put the files in place
.cursor/skills/arxiv-search/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install spring-ai-alibaba/examples spring-ai-alibaba-agent-example/skills-agent-example/skills/arxiv-search2Manually: put the files in place
.github/skills/arxiv-search/SKILL.md1Skills CLI (Vercel)
npx skills add spring-ai-alibaba/examples --skill arxiv-search -a gemini-cli2Platform CLI
gemini skills install https://github.com/spring-ai-alibaba/examples --path spring-ai-alibaba-agent-example/skills-agent-example/skills/arxiv-searchManually: put the files in place
.devin/skills/arxiv-search/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add spring-ai-alibaba/examples --skill arxiv-search -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.