mcpField
A
arxiv-research

arxiv-research

github.com/ray0907Productivity644 installsUpdated 5w ago
Repository

About arxiv-research

arxiv-research is a research skill for academic readers and researchers, covering arXiv discovery, paper analysis, citation generation, and TikZ figure extraction. Its workflow links paper discovery to structured understanding and source attribution.

Key features

  1. 01Search arXiv and explore citation links
  2. 02Analyze papers with structured prompts
  3. 03Generate citations in multiple styles
  4. 04Extract TikZ figures from LaTeX sources

Use cases

  1. 01Find papers on a research topic
  2. 02Compare papers or assess their evidence
  3. 03Prepare references for a literature review
  4. 04Extract diagrams from paper sources

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ray0907/arxiv-research-skill --skill arxiv-research

After installing, type/arxiv-researchin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

LICENSE
README.md
.gitignore
pyproject.toml
references/
workflows.md
scripts/
cache.py
understand.py
evidence.py
tikz.py
utils.py
connect.py

Details

From the project README

arXiv Research Skill

Systematic academic research through four capabilities that form a knowledge-building loop:

connect -> understand -> evidence
  Find  ->  Comprehend ->  Cite
             tikz (extract figures from LaTeX sources)

Setup

Install dependencies: uv sync

Capabilities

Connect (Knowledge Navigation)

Find relevant papers across arXiv, explore citation networks, and discover related work.

# Search with optional filters
uv run python scripts/connect.py search "transformer attention mechanism" --category cs.LG --limit 20
uv run python scripts/connect.py search "LLM agents" --since 2023-01 --until 2024-06
uv run python scripts/connect.py search "topic" --with-citations --sort citations

# Discover related work
uv run python scripts/connect.py similar "2301.00001" --limit 10
uv run python scripts/connect.py recent cs.AI --days 7
uv run python scripts/connect.py by-author "Yann LeCun"

# Citation network
uv run python scripts/connect.py cited-by "2301.00001" --limit 20
uv run python scripts/connect.py coauthors "Yann LeCun" --limit 20

# Get full paper content (single or batch)
uv run python scripts/connect.py content "2301.00001"
uv run python scripts/connect.py content "2301.00001,2302.00002,2303.00003"
Understand (Meaning Extraction)

Analyze paper content with structured prompts. Pipe paper content from connect.py content into analysis.

uv run python scripts/connect.py content "2301.00001" | uv run python scripts/understand.py analyze quick

Available prompts (uv run python scripts/understand.py list):

PromptPurpose
quickFast structured summary
methodologyDetailed methodology extraction
contributionIdentify and rank contributions
criticalStrengths/weaknesses analysis
compareMulti-paper comparison table
literatureOrganize for literature review
implementationExtract reproduction details
evidenceEvaluate as evidence for a claim
Evidence (Source Attribution)

Generate citations in multiple formats and export for reference managers.

uv run python scripts/evidence.py bibtex "2301.00001"
uv run python scripts/evidence.py apa "2301.00001"
uv run python scripts/evidence.py ris "2301.00001"           # For Zotero/Mendeley/EndNote
uv run python scripts/evidence.py batch "id1,id2,id3" --format bibtex > refs.bib
uv run python scripts/evidence.py batch "id1,id2" --format ris > refs.ris

Formats: bibtex, apa, ieee, acm, chicago, ris

TikZ (Figure Extraction)

Extract TikZ source code from arXiv paper LaTeX sources. Supports tikzpicture, tikzcd, circuitikz, and pgfplots environments. Captures captions, labels, and library dependencies.

uv run python scripts/tikz.py extract "2301.00001"                          # Pure TikZ code
uv run python scripts/tikz.py extract "2301.00001" --format latex > fig.tex  # Compilable LaTeX
uv run python scripts/tikz.py extract "2301.00001,2302.00002" --format json  # Batch as JSON
uv run python scripts/tikz.py list "2301.00001"                              # Summary only

Output formats: tikz (default), latex, json, brief

Workflow Patterns

Multi-step recipes (literature review, finding evidence for a claim): see references/workflows.md.

API Dependencies

ServicePurposeRate LimitAPI Key
arXivPaper search, content1 req/3sNo
Semantic ScholarCitations, similar papers100 req/5minOptional (higher limits)
Jina ReaderFull text extractionGenerousNo

Scripts enforce a fixed delay between requests per service. There is no automatic retry on failure — a 429 or network error returns an empty result rather than retrying.

Error Handling

  • Rate limited: Requests will fail with an empty result, not retry; wait and re-run
  • Paper not found: Verify arXiv ID format (YYMM.NNNNN)
  • No citations: Paper may be too new for Semantic Scholar

File Structure

arxiv-research-skill/
├── SKILL.md              # Agent instructions
├── README.md             # Installation and overview
├── references/
│   └── workflows.md      # Multi-step workflow recipes
└── scripts/
    ├── connect.py        # Knowledge navigation
    ├── understand.py     # Analysis prompts
    ├── evidence.py       # Citation generation
    ├── tikz.py           # TikZ figure extraction
    ├── cache.py          # SQLite caching (~/.cache/arxiv-research/papers.db)
    └── utils.py          # Shared utilities (extractPaperId, cleanText)

Comments

Markdown supported