Description

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

README (SKILL.md)

ArXiv Skill

Name: Arxiv Osiris
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
.\arxiv.ps1 -Action search -Query "quantum computing"

# With max results
.\arxiv.ps1 -Action search -Query "machine learning" -MaxResults 10

# With category filter (physics, cs, math, q-bio, etc.)
.\arxiv.ps1 -Action search -Query "neural networks" -Categories "cs,stat"

Download a paper

# By arXiv ID
.\arxiv.ps1 -Action download -ArxivId "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: arxiv.ps1 -search "consciousness" -max 5
Find physics papers: arxiv.ps1 -search "quantum" -cats "physics" -max 10
Download paper: arxiv.ps1 -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 using the Python arxiv package. Before installing or running it: 1) Be aware the SKILL.md examples reference a PowerShell script (arxiv.ps1) while the distributed file is a Python script (arxiv_search.py) — use the Python script or update wrappers accordingly. 2) The arXiv ID validation logic in the code is slightly odd and may reject some valid IDs; if you rely on automated downloads, review/patch is_valid_arxiv_id. 3) Run pip install arxiv from a controlled environment (virtualenv) and audit the pip package source if you have strict supply-chain requirements. 4) Because the skill will download PDFs into ~/Downloads/arxiv, consider running it in a sandbox or adjusting the download directory if you prefer a different location. If you need higher assurance, request provenance (homepage/source repo) from the publisher or inspect the code locally before use.

Capability Analysis

Type: OpenClaw Skill Name: arxiv-osiris Version: 1.0.4 The skill bundle is designed to search and download research papers from arXiv.org using the `arxiv` Python library. The `SKILL.md` provides clear instructions and dependency declarations without any prompt injection attempts. The `arxiv_search.py` script includes input validation for arXiv IDs to prevent path traversal, and downloads files to a standard user download directory. While there's a minor bug in the `is_valid_arxiv_id` function that might reject some valid arXiv IDs, this makes the validation more restrictive and does not introduce a security vulnerability. There is no evidence of malicious intent such as data exfiltration, unauthorized execution, or persistence mechanisms.

Capability Assessment

✓ Purpose & Capability

Name/description claim: search and download from arXiv. The code uses the arxiv Python client to search and download PDFs and exposes the expected functionality. Required binary (python) and the SKILL.md's pip dependency (arxiv) align with the stated purpose.

ℹ Instruction Scope

SKILL.md describes searching, filtering, and downloading via a script and Python API only; it does not instruct reading unrelated files or exfiltrating data. However, documentation examples reference a PowerShell script named arxiv.ps1 and different CLI flags than the provided Python script (arxiv_search.py). That mismatch is a documentation/integration inconsistency and could confuse users or lead to running the wrong wrapper.

✓ Install Mechanism

No install spec in registry (instruction-only); SKILL.md recommends pip install arxiv which is appropriate. There are no downloads from arbitrary URLs or extract steps. This is low-risk for installation.

✓ Credentials

The skill requires no environment variables, no credentials, and no config paths. That is proportional to its function (public arXiv access). The code writes downloads into the user's Downloads/arxiv directory (uses HOME), which is expected for a download tool.

✓ Persistence & Privilege

The skill is not forced always-on (always:false) and does not request elevated or persistent privileges. It does not modify other skills or global agent settings.

Version History

v1.0.4

Security fix: Added arXiv ID validation to prevent path traversal attacks

v1.0.3

Removed reference to Protocol SIM-PI-01

v1.0.2

Minor fix: Improved error handling and added version check

v1.0.1

- Updated internal logic in arxiv_search.py. - No user-facing changes or documentation updates in this version.

v1.0.0

Initial release of arxiv-osiris - Search and download research papers from arXiv.org by keyword, title, or abstract. - Filter search results by category (e.g., physics, cs, math). - Download PDFs of papers directly by arXiv ID. - Retrieve detailed metadata including authors, dates, and categories. - Supports command-line (PowerShell) and Python API usage. - Requires Python and the `arxiv` package.

Metadata

Slug arxiv-osiris

Version 1.0.4

License —

All-time Installs 5

Active Installs 5

Total Versions 5

Frequently Asked Questions

What is Arxiv Osiris?

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

How do I install Arxiv Osiris?

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

Is Arxiv Osiris free?

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

Which platforms does Arxiv Osiris support?

Arxiv Osiris is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Arxiv Osiris?

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

More Skills

Arxiv Osiris