Agent skill

General Arxiv Search

by learningmatter-mit in learningmatter-mit/AtomisticSkills

Search and retrieve research papers from ArXiv API for scientific research.

MITAuto-check passedResearch & Science

Install General Arxiv Search

skills CLI
$ npx skills add learningmatter-mit/AtomisticSkills --skill general-arxiv-search -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install learningmatter-mit/AtomisticSkills general-arxiv-search --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/learningmatter-mit/AtomisticSkills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/general-arxiv-search .claude/skills/general-arxiv-search && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
general-arxiv-search
GitHub stars
176
Token cost
~634 tokens
SKILL.md length
178 words
Files
3 (incl. scripts)
Skills in repo
129
Repo updated
First seen
Licence
MIT

At a glance

Search and retrieve research papers from ArXiv API for scientific research.

  • Works in 3 steps: Simple Keyword Search → Advanced Search (Authors, Categories,… → Search in Title
  • Tasks that involve Academic paper search
  • SKILL.md covers Goal, Instructions, Examples and Constraints
  • Runs Python scripts from its folder

What it does

General Arxiv Search is an agent skill from learningmatter-mit/AtomisticSkills. Search and retrieve research papers from ArXiv API for scientific research.

Its SKILL.md is about 630 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `examples/mlip_search_example.json` and `scripts/arxiv_search.py`).

It sits in Research & Science, covering Academic paper search. It works with arXiv. The repository describes itself as: Integrating AtomisticSkills into Agentic IDEs (Cursor, Claude Code, Codex, Google Antigravity, Hermes Agent, etc). The licence is MIT.

When your agent uses it

  • Tasks that involve Academic paper search

Example prompts

  • “/general-arxiv-search”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Simple Keyword Search
  2. Advanced Search (Authors, Categories, Title)
  3. Search in Title

What it can do on your machine

Read from SKILL.md and the folder at commit 6257444. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

General Arxiv Search loads about 634 tokens when it runs. Until then it costs about 24 tokens; SKILL.md has 178 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~24
When it runs · the whole SKILL.md, loaded when a task matches
~634

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from learningmatter-mit/AtomisticSkills at commit 6257444, republished under its MIT licence (© learningmatter-mit). 178 words, ~634 tokens.

Download SKILL.mdSave it as .claude/skills/general-arxiv-search/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
general-arxiv-search
description
Search and retrieve research papers from ArXiv API for scientific research.
metadata.category
general
metadata.venv
cpu

Goal

To search for and retrieve metadata (title, authors, summary, DOI, etc.) of research papers from the ArXiv database using the official ArXiv API. This skill supports keyword, author, category, and title-based searches.

Instructions

Search for papers containing specific keywords across all fields (title, abstract, authors, etc.).

bash
${CLAUDE_SKILL_DIR}/../../venv/run cpu python ${CLAUDE_SKILL_DIR}/scripts/arxiv_search.py "machine learning interatomic potential" --max_results 5 --output mlip_papers.json
2. Advanced Search (Authors, Categories, Title)

Combine multiple criteria to narrow down search results.

bash
${CLAUDE_SKILL_DIR}/../../venv/run cpu python ${CLAUDE_SKILL_DIR}/scripts/arxiv_search.py --authors "Ceder" --categories mtrl-sci --max_results 10 --output ceder_papers.json

Supported Category Shortcuts:

  • mtrl-sci: cond-mat.mtrl-sci (Materials Science)
  • mes-hall: cond-mat.mes-hall (Mesoscale and Nanoscale Physics)
  • comp-phys: physics.comp-ph (Computational Physics)
  • chem-phys: physics.chem-ph (Chemical Physics)
  • ml: cs.LG (Machine Learning)
  • ai: cs.AI (Artificial Intelligence)
3. Search in Title

Restrict the search to only the paper titles.

bash
${CLAUDE_SKILL_DIR}/../../venv/run cpu python ${CLAUDE_SKILL_DIR}/scripts/arxiv_search.py --title "perovskite stability" --max_results 5

Examples

bash
${CLAUDE_SKILL_DIR}/../../venv/run cpu python ${CLAUDE_SKILL_DIR}/scripts/arxiv_search.py "MACE force field" --max_results 3 --output mace_results.json
Searching for Specific Authors in Materials Science
bash
${CLAUDE_SKILL_DIR}/../../venv/run cpu python ${CLAUDE_SKILL_DIR}/scripts/arxiv_search.py --authors "Boris Kozinsky" --categories mtrl-sci --max_results 5

Constraints

  • Rate Limiting: The ArXiv API requires a minimum of 3 seconds between requests. This script includes a small delay, but frequent calls should be avoided.
  • Environment: Requires the cpu environment.
  • Dependencies: Uses feedparser and urllib.
  • Metadata: Results include ID, URL, Title, Authors, Summary, Publication Date, and DOI (if available).

Author: Bowen Deng Contact: GitHub @learningmatter-mit

© learningmatter-mit, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (scripts) in skills/general-arxiv-search of learningmatter-mit/AtomisticSkills.

  • SKILL.md
  • examples/mlip_search_example.json
  • scripts/arxiv_search.py

Open the folder on GitHubat commit 6257444

Compare with similar skills

General Arxiv Search next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

General Arxiv Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
General Arxiv Search this skilllearningmatter-mit/AtomisticSkills176—~634Automated safety check: PassMIT
Read arXiv Paperkarpathy/nanochat58k2 repos~494Automated safety check: PassMIT
Literature Reviewneflibata-feng/MyArxiv-Agent12621 repos~5.9kAutomated safety check: NotesMIT
Citation ManagementK-Dense-AI/claude-scientific-writer2.4k3 repos~3.9kAutomated safety check: NotesMIT
Openalex Databaseneflibata-feng/MyArxiv-Agent12613 repos~3kAutomated safety check: PassCustom licence
Citation Managementneflibata-feng/MyArxiv-Agent12620 repos~8.1kAutomated safety check: NotesMIT

Similar skills

  • Read arXiv Paper

    karpathy/nanochat

    Fetches the TeX source of an arXiv paper from its URL, reads it and writes a markdown summary tied to the nanochat project.

    58k GitHub starsUsed in 2 repos~494 tokens
    Research & ScienceAuto-check passed
  • Literature Review

    neflibata-feng/MyArxiv-Agent

    Conduct comprehensive, systematic literature reviews using multiple academic databases (PubMed, arXiv, bioRxiv, Semantic Scholar, etc.).

    126 GitHub starsUsed in 21 repos~5.9k tokens
    Research & ScienceAuto-check: notes
  • Citation Management

    K-Dense-AI/claude-scientific-writer

    Finds papers in OpenAlex, PubMed and Google Scholar, turns DOIs, PMIDs and arXiv IDs into clean BibTeX, and validates citations for a manuscript or thesis.

    2.4k GitHub starsUsed in 3 repos~3.9k tokens
    Research & ScienceAuto-check: notes
  • Openalex Database

    neflibata-feng/MyArxiv-Agent

    Query and analyze scholarly literature using the OpenAlex database.

    126 GitHub starsUsed in 13 repos~3k tokens
    Research & ScienceAuto-check passed
  • Citation Management

    neflibata-feng/MyArxiv-Agent

    Comprehensive citation management for academic research. An agent skill from neflibata-feng/MyArxiv-Agent.

    126 GitHub starsUsed in 20 repos~8.1k tokens
    Research & ScienceAuto-check: notes
  • Paper Research on arXiv

    XiaomiMiMo/MiMo-Code

    Searches arXiv, fetches metadata, generates BibTeX, downloads PDFs and finds citations and related papers using a bundled Python script.

    14k GitHub starsUsed in 1 repo~1.5k tokens
    Research & ScienceAuto-check passed

More from learningmatter-mit/AtomisticSkills

All 129 skills in this repo
  • Drug Binding Site Definition

    learningmatter-mit/AtomisticSkills

    Define a docking search box (center coordinates + box dimensions in Angstroms) from a co-crystal ligand, binding-site residues, or a saved JSON specification.

    176 GitHub stars~2.9k tokensUpdated yesterday
    Auto-check passed
  • Drug Complex System Builder

    learningmatter-mit/AtomisticSkills

    Build a solvated, charge-neutralized protein-ligand complex for OpenMM molecular dynamics simulation.

    176 GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Drug Pocket Detection

    learningmatter-mit/AtomisticSkills

    Identify and rank ligandable pockets on a protein structure or model using geometry (fpocket) or an ML predictor (P2Rank).

    176 GitHub stars~4k tokensUpdated yesterday
    Auto-check passed
  • Chem Bond Dissociation

    learningmatter-mit/AtomisticSkills

    Calculate homolytic and heterolytic bond dissociation energies (BDEs) for all single bonds in a molecule using MLIPs with RDKit fragmentation.

    176 GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed
  • Chem Conformer Search

    learningmatter-mit/AtomisticSkills

    Generate molecular conformers with RDKit ETKDG, relax with MLIPs, and rank by energy with Boltzmann weighting.

    176 GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Chem DB Mof

    learningmatter-mit/AtomisticSkills

    Query multiple MOF databases (QMOF via MPContribs; ARC-MOF DB7/Majumdar et al.

    176 GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed

Works with

Questions about General Arxiv Search

What does General Arxiv Search do?

Search and retrieve research papers from ArXiv API for scientific research. General Arxiv Search is an agent skill from learningmatter-mit/AtomisticSkills. Search and retrieve research papers from ArXiv API for scientific research.

When should I use General Arxiv Search?

General Arxiv Search fits situations like: tasks that involve Academic paper search.

How do I install General Arxiv Search in Claude Code?

Run `npx skills add learningmatter-mit/AtomisticSkills --skill general-arxiv-search -a claude-code`. Or copy the skill folder (skills/general-arxiv-search in learningmatter-mit/AtomisticSkills) into .claude/skills/general-arxiv-search in your project. Claude Code loads it when a task matches its description.

How do I install General Arxiv Search in Codex?

Run `npx skills add learningmatter-mit/AtomisticSkills --skill general-arxiv-search -a codex`. Or copy the skill folder (skills/general-arxiv-search in learningmatter-mit/AtomisticSkills) into .agents/skills/general-arxiv-search in your project. Codex loads it when a task matches its description.

Can I use General Arxiv Search in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add learningmatter-mit/AtomisticSkills --skill general-arxiv-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/general-arxiv-search, .gemini/skills/general-arxiv-search, .github/skills/general-arxiv-search and .opencode/skills/general-arxiv-search in your project.

What does General Arxiv Search need to run?

Going by SKILL.md and its folder, General Arxiv Search needs Python for the scripts in its folder. Our summary lists: Python 3.

Does General Arxiv Search access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is General Arxiv Search safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does General Arxiv Search use?

General Arxiv Search is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does General Arxiv Search use?

About 634 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to General Arxiv Search?

Skills that share tags, products or a category with General Arxiv Search: Read arXiv Paper (karpathy/nanochat, 58k stars), Literature Review (neflibata-feng/MyArxiv-Agent, 126 stars), Citation Management (K-Dense-AI/claude-scientific-writer, 2.4k stars) and Openalex Database (neflibata-feng/MyArxiv-Agent, 126 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains General Arxiv Search?

learningmatter-mit (a GitHub organization) maintains it in learningmatter-mit/AtomisticSkills, which has 176 GitHub stars. The repository holds 129 skills in this directory. The repository was last updated on October 7, 2026.

Source: learningmatter-mit/AtomisticSkills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.