Skip to content
Get packs

Guide · Agent skill

How to use the arXiv Paper Search and Download agent skill

Updated · written with AI from the project's own documentation and checked against our catalogue data

The arXiv skill lets an AI agent search arXiv, the public archive of academic preprints, list matching papers with their abstracts, download PDFs into a local folder, and write a short summary for each paper. It is aimed at researchers and students building a literature list. After this guide you will know what the skill does, how to install it, how to phrase requests so it triggers, and what its limits are.

arXiv Paper Search and Downloadwanshuiyin/Auto-claude-code-research-in-sleep · MIT

Quick start

  1. 1Get the skill. Download the ZIP from this page and unzip it so you have a folder containing SKILL.md.
  2. 2Place it where Claude can find it. Move the folder into ~/.claude/skills/ for personal use or .claude/skills/ inside a project. Alternatively upload it under Settings → Capabilities → Skills in the Claude apps.
  3. 3Check Python 3. Make sure python3 runs on your machine, since the skill's commands depend on it.
  4. 4Make a search request. Ask in plain language, for example "search arxiv for retrieval-augmented generation", and the agent will list matching papers in a table.
  5. 5Download the papers you need. Ask to download a paper by its arXiv ID or use the - download directive. PDFs are saved to papers/ by default.
  6. 6Review the summaries. Check each summary's abstract and key contributions, then open the PDF to verify the details you rely on.

What is an agent skill?

An agent skill is a folder containing a SKILL.md file. The file describes a task, the tools the agent may use and the steps to follow. When you make a request that matches the skill's description, the agent loads those instructions and carries out the task.

This skill is defined by a single file, SKILL.md, and its workflow runs shell commands and Python through the agent's Bash access.

What the arXiv skill makes the agent do

Once installed, the agent can search arXiv for papers matching a topic, or fetch one paper directly by its arXiv ID. For each paper it shows the title, authors, dates and abstract. It can download PDFs into a local papers/ folder and produce a short summary per paper.

If a research wiki folder (research-wiki/) exists in the project, the skill also adds the papers to that wiki. The summary's key contributions are extracted from the abstract text only.

  • Search arXiv by topic, returning up to 10 results by default
  • Fetch a specific paper by arXiv ID such as 2301.07041
  • Download PDFs to papers/ or a directory you choose
  • Summarize each paper with its authors, date, categories, abstract and local PDF path

How do you install the arXiv skill?

Download the ZIP for the skill from this page and unzip it. For a personal setup, place the unzipped skill folder inside ~/.claude/skills/. For a single project, place it inside that project's .claude/skills/ folder.

In the Claude apps you can instead upload the skill under Settings → Capabilities → Skills.

  • Personal install: ~/.claude/skills/ (available across your projects)
  • Project install: .claude/skills/ inside the project folder
  • Claude apps: Settings → Capabilities → Skills, then upload the ZIP

How do you trigger the skill with natural requests?

The skill's description lists phrases that should activate it. You can use them directly, and the agent will also recognise close variations of the same intent.

You can also use the argument form shown in the skill's notes, where the query or ID follows the command.

  • "search arxiv for diffusion models for protein design"
  • "fetch arxiv 2301.07041"
  • "download paper 2301.07041"
  • "get paper pdf for <title or ID>"
/arxiv "attention mechanism" - max: 20

Options you can add to a request

The skill accepts a few directives appended to the query. max sets how many results to return, dir sets the folder for PDFs, and download fetches PDFs. Without these, the default is 10 results and the papers/ folder in the current project.

  • - max: N returns up to N results (default 10)
  • - dir: PATH saves PDFs to a custom folder (default papers/)
  • - download downloads the first result's PDF after listing
  • - download: all downloads PDFs for every result
/arxiv "query" - dir: literature/

What does the skill need to run?

The skill runs python3 commands, so Python 3 must be available on the machine. It also needs network access to export.arxiv.org and arxiv.org. It has an optional helper, tools/arxiv_fetch.py, from the wider ARIS toolkit. If that helper is not found, the skill uses an inline Python fallback that does the same queries directly.

The skill's allowed tools are Bash, Read and Write.

  • Python 3
  • Network access to export.arxiv.org and arxiv.org
  • Optional: ARIS tools/arxiv_fetch.py (inline Python fallback used if absent)

Safety notes: scripts and network access

This skill runs scripts and uses the network. It executes Python through Bash, sends search queries to arXiv's API and downloads files from arxiv.org. Downloads are checked: files under 10 KB are rejected as likely error pages, and there is a one-second pause between consecutive downloads.

Review the SKILL.md file before installing, and make sure you are comfortable with the agent running shell commands in your project.

  • Scripts run through Bash in your project directory
  • Queries go to export.arxiv.org; PDFs come from arxiv.org
  • Files smaller than 10 KB are rejected
  • Tools granted: Bash(*), Read, Write

What people use it for

  • Building a literature review by searching a topic and saving the most relevant PDFs
  • Getting a quick list of recent papers on a subject with their abstracts
  • Fetching a paper you already know by its arXiv ID and saving it to a project library
  • Keeping a local paper folder that feeds into a research wiki used with the ARIS toolkit

Frequently asked questions

How do I install the arXiv agent skill?

Download the ZIP from this page and unzip it. Put the folder in ~/.claude/skills/ for personal use or in a project's .claude/skills/ folder. In the Claude apps, you can upload the ZIP under Settings → Capabilities → Skills.

What do I need to run the arXiv skill?

You need Python 3, because the skill runs python3 commands, and network access to export.arxiv.org and arxiv.org. The ARIS arxiv_fetch.py helper is optional, since the skill has an inline Python fallback.

Is the arXiv skill free?

The skill is published under the MIT licence. This page does not list any price, so check the repository for licence details and terms before using it commercially.

Can the skill access paywalled or non-arXiv journal articles?

No. The skill only queries arXiv, so it cannot find or download paywalled journal articles or papers that are not on arXiv.

Are the paper summaries accurate?

The summaries are drawn only from abstract text, so they do not reflect the full paper. Check the PDF before relying on any claim.

Why was my download rejected or why did the search fail?

The skill rejects files under 10 KB because they are usually error pages. Search failures usually come from missing Python 3 or no access to export.arxiv.org and arxiv.org, so check those first.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

This skill suits researchers and students who want a quick, scriptable list of arXiv papers with abstracts and a local PDF library. It is a poor choice if you need full-text analysis, paywalled journals or sources beyond arXiv, and you should verify any claim against the paper itself.

Download the skill