agentleFS
augchan42augchan42/inkstone/skills/arxiv-search/SKILL.md

arxiv-search

Skill5 starsChanged 5 months agoMITView on GitHub

Search arXiv for papers by topic, author, or ID. Use when finding research, surveying recent publications, or looking up a specific paper.

10 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

4 rules. 0 are common, 2 are distinctive, and 2 are very specific to this project.

  • 0

    Common

    Most of the 10 edited versions we read keep these.

  • 2

    Distinctive

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Search the arXiv API for academic papers.

    line 12
  2. Very specific:

    Default to sortBy=submittedDate&sortOrder=descending for recent papers

    line 120
  3. Very specific:

    Use max_results=10 as default, increase if user wants more

    line 121
  4. Distinctive:

    If the user wants to read a paper's full content, fetch the PDF URL and use the Read tool on it, or use WebFetch on the abstract page for …

    line 130

“Common” is measured: kept by at least 6 in 10 of the 10 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

arXiv Paper Search

Search the arXiv API for academic papers. No authentication required.

When to Use

  • User wants to find papers on a topic
  • User asks about recent research in a field
  • User provides an arXiv ID and wants details
  • User wants to compare papers or find related work

API Details

  • Base URL: https://export.arxiv.org/api/query
  • Auth: None required
  • Rate limit: 1 request per 3 seconds (be polite)
  • Response format: Atom XML

How to Search

By topic/keywords

curl -sL "https://export.arxiv.org/api/query?search_query=all:QUERY&max_results=10&sortBy=submittedDate&sortOrder=descending"

Replace spaces in QUERY with +. For multi-word phrases, use %22phrase%22 for exact match.

By specific field

  • ti: — title
  • au: — author
  • abs: — abstract
  • cat: — category (e.g. cs.AI, cs.CL, stat.ML)
  • all: — all fields

Combine with AND, OR, ANDNOT:

# Papers about transformers in NLP
curl -sL "https://export.arxiv.org/api/query?search_query=ti:transformer+AND+cat:cs.CL&max_results=10&sortBy=submittedDate&sortOrder=descending"

# Papers by a specific author
curl -sL "https://export.arxiv.org/api/query?search_query=au:hinton&max_results=10&sortBy=submittedDate&sortOrder=descending"

By arXiv ID

curl -sL "https://export.arxiv.org/api/query?id_list=2301.07041"

Multiple IDs: id_list=2301.07041,2305.18290

Pagination

Use start parameter:

# Results 11-20
curl -sL "https://export.arxiv.org/api/query?search_query=all:QUERY&start=10&max_results=10&sortBy=submittedDate&sortOrder=descending"

Parsing the Response

The response is Atom XML. Extract these fields from each <entry>:

FieldXML PathNotes
Title<title>May contain line breaks — normalize
Authors<author><name>Multiple entries
Abstract<summary>May contain LaTeX
Published<published>ISO 8601 date
Updated<updated>Latest version date
arXiv ID<id>URL form, extract ID from path
PDF link<link rel="related" title="pdf">Direct PDF URL
Categories<category term="...">Primary + secondary
Comment<arxiv:comment>Page count, conference info

Output Format

Present results as a numbered list:

1. **Title of Paper** (arXiv:2301.07041)
   Authors: First Author, Second Author, et al.
   Published: 2023-01-17 | Categories: cs.CL, cs.AI
   Abstract: First 2-3 sentences of the abstract...
   PDF: https://arxiv.org/pdf/2301.07041

For single paper lookups, show the full abstract.

Common Categories

CodeField
cs.AIArtificial Intelligence
cs.CLComputation and Language (NLP)
cs.CVComputer Vision
cs.LGMachine Learning
cs.SESoftware Engineering
cs.CRCryptography and Security
stat.MLMachine Learning (Stats)
math.OCOptimization and Control
eess.SPSignal Processing
quant-phQuantum Physics

Tips

  • Default to sortBy=submittedDate&sortOrder=descending for recent papers
  • Use max_results=10 as default, increase if user wants more
  • For broad topics, search by category + keywords to reduce noise
  • arXiv IDs after 2007 use the format YYMM.NNNNN (e.g. 2301.07041)
  • Older IDs use subject/YYMMNNN format (e.g. hep-th/9901001)
  • The abstract page is at https://arxiv.org/abs/ID
  • The PDF is at https://arxiv.org/pdf/ID

Reading Full Papers

If the user wants to read a paper's full content, fetch the PDF URL and use the Read tool on it, or use WebFetch on the abstract page for the HTML version.

For the abstract page (lighter weight):

curl -sL "https://arxiv.org/abs/2301.07041"

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.