How do I install the Arxiv Search skill?

Run npx skillmds@latest add sonesuke/arxiv-search in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Arxiv Search safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Arxiv Search?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Arxiv Search free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Arxiv Search?

sonesuke (@sonesuke) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Arxiv Search by sonesuke — Agent Skill

Name: Arxiv Search
Author: sonesuke

File contents

ArXiv Search

Search for papers from arXiv using the arxiv-cli MCP server.

Purpose

Execute paper searches with various filters including query, category, date range, and result limits.

MCP Tool

Uses search_papers MCP tool provided by arxiv-cli.

Usage

Search for papers, then use the returned dataset name to query with Cypher:

search_papers({
  query: "machine learning",
  limit: 20
})
# Returns dataset name like "search_abc123"
# Then query with execute_cypher:
execute_cypher({
  dataset: "search-abc123",
  query: "MATCH (p:papers) RETURN p.id, p.title, p.authors LIMIT 5"
})

CRITICAL:

When the user specifies a number of papers, ALWAYS pass it as the limit parameter to search_papers. Do NOT rely on cypher LIMIT — limit controls how many papers are fetched from the arXiv API.
After searching, always use execute_cypher to retrieve results. Do NOT read the output JSON file directly.

Result Retrieval Patterns

Use these cypher patterns to retrieve search results:

Total count:

MATCH (p:papers) RETURN COUNT(*) AS count

Top 20 papers for overview:

MATCH (p:papers) RETURN p.id, p.title, p.authors, p.published_date LIMIT 20

Papers by specific author:

MATCH (p:papers) WHERE "Smith, John" IN p.authors RETURN p.id, p.title

Date range summary:

MATCH (p:papers) RETURN p.published_date, p.title LIMIT 10

Available Paper Node Fields

Field	Description
`id`	arXiv ID (e.g., "2301.00001")
`title`	Paper title
`authors`	Array of author names
`summary`	Abstract/summary text
`published_date`	Publication date
`url`	arXiv URL
`pdf_url`	Direct PDF link
`description_paragraphs`	Array of paragraph objects (number, id, text)

Filter Examples

Search with category and date filters:

search_papers({
  query: "quantum computing",
  category: "cs.AI",
  after: "2025-01-01",
  limit: 10
})

Search with date range:

search_papers({
  query: "neural network",
  after: "2024-01-01",
  before: "2024-12-31",
  limit: 20
})

Parameters

query (string, required): Free-text search query
limit (number, optional): Maximum number of results (default: 10). Pass the number the user specifies.
category (string, optional): Filter by arXiv category (e.g., "cs.AI", "physics.quant-ph", "math.NA")
after (string, optional): Filter by date after (YYYY-MM-DD)
before (string, optional): Filter by date before (YYYY-MM-DD)

---name: arxiv-searchdescription: Search arXiv for academic papers by query, with optional limit, date, and category filters. Always use this skill for any paper search request — even when specific parameters are provided.---# ArXiv SearchSearch for papers from arXiv using the arxiv-cli MCP server.## PurposeExecute paper searches with various filters including query, category, date range, and result limits.## MCP ToolUses `search_papers` MCP tool provided by arxiv-cli.## UsageSearch for papers, then use the returned `dataset` name to query with Cypher:```search_papers({ query: "machine learning", limit: 20})# Returns dataset name like "search_abc123"# Then query with execute_cypher:execute_cypher({ dataset: "search-abc123", query: "MATCH (p:papers) RETURN p.id, p.title, p.authors LIMIT 5"})```**CRITICAL**:1. When the user specifies a number of papers, ALWAYS pass it as the `limit` parameter to `search_papers`. Do NOT rely on cypher LIMIT — `limit` controls how many papers are fetched from the arXiv API.2. After searching, always use `execute_cypher` to retrieve results. Do NOT read the output JSON file directly.### Result Retrieval PatternsUse these cypher patterns to retrieve search results:**Total count**:```cypherMATCH (p:papers) RETURN COUNT(*) AS count```**Top 20 papers for overview**:```cypherMATCH (p:papers) RETURN p.id, p.title, p.authors, p.published_date LIMIT 20```**Papers by specific author**:```cypherMATCH (p:papers) WHERE "Smith, John" IN p.authors RETURN p.id, p.title```**Date range summary**:```cypherMATCH (p:papers) RETURN p.published_date, p.title LIMIT 10```### Available Paper Node Fields| Field | Description || --- | --- || `id` | arXiv ID (e.g., "2301.00001") || `title` | Paper title || `authors` | Array of author names || `summary` | Abstract/summary text || `published_date` | Publication date || `url` | arXiv URL || `pdf_url` | Direct PDF link || `description_paragraphs` | Array of paragraph objects (number, id, text) |### Filter ExamplesSearch with category and date filters:```search_papers({ query: "quantum computing", category: "cs.AI", after: "2025-01-01", limit: 10})```Search with date range:```search_papers({ query: "neural network", after: "2024-01-01", before: "2024-12-31", limit: 20})```## Parameters- `query` (string, required): Free-text search query- `limit` (number, optional): Maximum number of results (default: 10). Pass the number the user specifies.- `category` (string, optional): Filter by arXiv category (e.g., "cs.AI", "physics.quant-ph", "math.NA")- `after` (string, optional): Filter by date after (YYYY-MM-DD)- `before` (string, optional): Filter by date before (YYYY-MM-DD)

Frequently asked questions

Arxiv Search