arxiv

Search arXiv, fetch paper metadata, and download PDFs into a local library.

52|Updated Apr 24, 2026
One-click install
npx skills add https://github.com/Immortalqx/my_codex_skills --skill arxiv-immortalqx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: arxiv
Source: https://github.com/Immortalqx/my_codex_skills/tree/main/arxiv
Command: npx skills add https://github.com/Immortalqx/my_codex_skills --skill arxiv-immortalqx

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Finding and saving academic papers from arXiv normally requires manual browsing, copying metadata, and downloading PDFs one by one. This Skill automates the entire flow: search by topic or arXiv ID, retrieve structured metadata, and save PDFs into a local paper library. ## Core Features & Use Cases - arXiv Search: Query the arXiv Atom API by keyword or paper ID and get structured results with title, authors, abstract, categories, and links. - PDF Download: Download papers by ID into a configurable directory, with duplicate skipping, size validation, and rate-limit retry handling. - Paper Summaries: Produce formatted summaries with key contributions, citation-ready arXiv IDs, and local PDF paths. - Use Case: Ask for papers on "attention mechanism", review the top 10 results in a table, then download the most relevant PDFs into a papers/ folder for your literature review. ## Quick Start Use the arxiv skill to search for recent papers on retrieval-augmented generation and download the top three PDFs into my papers folder.

Frequently Asked Questions about arxiv

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search arXiv papers from the command line?

Run the bundled helper with a query: python scripts/arxiv_fetch.py search "attention mechanism" --max 10. It queries the arXiv Atom API and prints JSON results with IDs, titles, authors, abstracts, and PDF links.

How to download an arXiv paper PDF by ID?

Use the download command with the paper ID: python scripts/arxiv_fetch.py download 2301.07041 --dir papers. The script creates the directory, saves the PDF, skips files that already exist, and rejects downloads smaller than 10 KB.

Does the arXiv API support old-style paper IDs?

Yes, both new-style IDs like 2301.07041 and legacy IDs like cs/0601001 are supported. Legacy IDs are saved with the slash replaced by an underscore, such as cs_0601001.pdf.

Why does my arXiv download fail or return a tiny file?

arXiv rate-limits requests with HTTP 429, and error pages can be returned instead of PDFs. The script retries once after 5 seconds on 429 responses and rejects any downloaded file smaller than 10 KB as a likely error page.

What are the limitations of the arXiv API search?

The API returns metadata and abstracts only, not full-text search inside papers. Results are sorted by relevance with a configurable max count, and very broad queries may need pagination via the start offset parameter.