Description

Search and download research papers from arXiv.org - Research skill for OpenClaw agents

README (SKILL.md)

ArXiv Research Skill

Name: ArXiv Research
Author: nantes

Search and download scientific papers from arXiv.org - the largest free distribution of scientific preprints.

What it does

Search papers by keywords, titles, abstracts
Download PDFs directly
Filter by category (physics, cs, math, etc.)
Get metadata including authors, dates, categories

Installation

# Install Python dependency
pip install arxiv

Usage

Search for papers

# Basic search
python arxiv_search.py search "quantum computing"

# With max results
python arxiv_search.py search "machine learning" --max 10

# With category filter (physics, cs, math, q-bio, etc.)
python arxiv_search.py search "neural networks" --cats cs,stat

Download a paper

# By arXiv ID
python arxiv_search.py download "2310.12345"

Python API

from arxiv import search, download

# Search
results = search("simulation hypothesis", max_results=5)
for paper in results:
    print(f"{paper.title} - {paper.pdf_url}")

# Download
paper.download("/path/to/save")

Examples

Search for consciousness papers: python arxiv_search.py search "consciousness" --max 5
Find physics papers: python arxiv_search.py search "quantum" --cats physics --max 10
Download paper: python arxiv_search.py download "1706.03762" (Attention is All You Need)

Notes

arXiv is free and open
Papers are preprints - may not be peer-reviewed
Great for staying current with research

Usage Guidance

This skill appears to do what it says: search arXiv and download PDFs. Before installing, consider: 1) the skill requires you to pip install the third-party 'arxiv' package — confirm you trust that package and its source (PyPI). 2) The script will create and write PDFs to ~/Downloads/arxiv; ensure you are comfortable with that write location. 3) Documentation inconsistencies exist (duplicate files, differing version numbers, and a SKILL.md that references a missing PowerShell wrapper); these are likely packaging/documentation issues, not malicious signs, but you may want to get a clean single-file package or inspect the repository yourself. 4) If you run this in a sensitive environment, restrict network access or review the 'arxiv' package source to be extra cautious.

Capability Analysis

Type: OpenClaw Skill Name: arxiv-research Version: 1.0.0 The skill bundles (both 'arxiv-research' and 'arxiv-osiris' variants, which share identical Python code) are designed to search and download research papers from arXiv.org. The `arxiv_search.py` script uses the legitimate `arxiv` Python library and includes explicit input validation (`is_valid_arxiv_id`) to prevent path traversal and injection attacks when handling arXiv IDs for file downloads. Papers are downloaded to a standard user 'Downloads/arxiv' directory. There is no evidence of data exfiltration, unauthorized execution, persistence mechanisms, or malicious prompt injection attempts in the `SKILL.md` files. The functionality is clearly aligned with its stated purpose.

Capability Assessment

✓ Purpose & Capability

Name/description (search and download papers from arXiv) match the included Python code and SKILL.md. Required binary is only python and the metadata/prompted pip dependency is the arxiv library — all appropriate for this purpose. Minor bookkeeping inconsistencies exist: duplicate copies of the same Python file under different paths and mismatched version fields (registry lists 1.0.0 while _meta.json shows 1.0.4), but these are not security-critical.

ℹ Instruction Scope

SKILL.md instructions only cover installing the 'arxiv' Python package and running the provided script or using the Python API. The runtime instructions do not read unrelated files or environment variables nor send data to unexpected endpoints. Note: one SKILL.md variant references PowerShell wrapper names (arxiv.ps1, Windows-style examples) that are not included — this is an inconsistency in documentation but not a malicious behavior.

✓ Install Mechanism

There is no automated install spec; the skill is instruction-only and asks the user to pip install the public 'arxiv' package. No downloads from arbitrary URLs or archive extraction are present.

✓ Credentials

The skill requires no environment variables, credentials, or config paths. It writes downloaded PDFs to a Downloads/arxiv directory under the user's home — a reasonable, proportional filesystem access for a download tool.

✓ Persistence & Privilege

The skill is not always-enabled and does not request elevated or persistent platform privileges. It does not modify other skills or system-wide agent settings.

Version History

v1.0.0

Initial release of arxiv-research skill. - Search and filter scientific papers from arXiv.org by keywords, title, abstract, and category. - Download PDFs directly using arXiv ID. - Retrieve paper metadata such as authors, publication dates, and categories. - Includes both command-line and Python API instructions for searching and downloading papers. - Supports category filtering for targeted research (e.g., CS, physics, math).

Metadata

Slug arxiv-research

Version 1.0.0

License —

All-time Installs 12

Active Installs 10

Total Versions 1

Frequently Asked Questions

What is ArXiv Research?

Search and download research papers from arXiv.org - Research skill for OpenClaw agents. It is an AI Agent Skill for Claude Code / OpenClaw, with 1300 downloads so far.

How do I install ArXiv Research?

Run "/install arxiv-research" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is ArXiv Research free?

Yes, ArXiv Research is completely free (open-source). You can download, install and use it at no cost.

Which platforms does ArXiv Research support?

ArXiv Research is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created ArXiv Research?

It is built and maintained by Ivan Cetta (@nantes); the current version is v1.0.0.

More Skills

ArXiv Research