Arxiv

arXiv Paper Search & Download

Search topic or arXiv paper ID: $ARGUMENTS

Constants

• PAPER_DIR - Local directory to save downloaded PDFs. Default: papers/ in the current project directory.
• MAX_RESULTS = 10 - Default number of search results.
• FETCH_SCRIPT - tools/arxiv_fetch.py relative to the ARIS install, or the same path relative to the current project. Fall back to inline Python if not found.

> Overrides (append to arguments): > - /arxiv "attention mechanism" - max: 20 - return up to 20 results > - /arxiv "2301.07041" - download - download a specific paper by ID > - /arxiv "query" - dir: literature/ - save PDFs to a custom directory > - /arxiv "query" - download: all - download all result PDFs

Workflow

Step 1: Parse Arguments

Parse $ARGUMENTS for directives:

• Query or ID: main search term or a bare arXiv ID such as 2301.07041 or cs/0601001
• - max: N: override MAX_RESULTS (e.g., - max: 20)
• - dir: PATH: override PAPER_DIR (e.g., - dir: literature/)
• - download: download the first result's PDF after listing
• - download: all: download PDFs for all results

If the argument matches an arXiv ID pattern (YYMM.NNNNN or category/NNNNNNN), skip the search and go directly to Step 3.

Step 2: Search arXiv

Locate the fetch script:

SCRIPT=$(python3 -c "
import pathlib
candidates = [
    pathlib.Path('tools/arxiv_fetch.py'),
    pathlib.Path.home() / '.claude' / 'skills' / 'arxiv' / 'arxiv_fetch.py',
]
for p in candidates:
    if p.exists():
        print(p)
        break
" 2>/dev/null)

If SCRIPT is found, run:

python3 "$SCRIPT" search "QUERY" --max MAX_RESULTS

If SCRIPT is not found, fall back to inline Python:

python3 -  10 KB (reject smaller files - likely an error HTML page)
- Add a 1-second delay between consecutive downloads to avoid rate limiting
- Report: `Downloaded: papers/2301.07041.pdf (842 KB)`

### Step 5: Summarize

For each paper (downloaded or fetched by API):

```markdown
## [Title]

- **arXiv**: [ID] - [abs_url]
- **Authors**: [full author list]
- **Date**: [published]
- **Categories**: [cs.LG, cs.AI, ...]
- **Abstract**: [full abstract]
- **Key contributions** (extracted from abstract):
  - [contribution 1]
  - [contribution 2]
  - [contribution 3]
- **Local PDF**: papers/[ID].pdf (if downloaded)

Step 6: Update Research Wiki (if active)

Required when research-wiki/ exists in the project; skip silently otherwise. When the wiki dir exists, resolve $WIKI_SCRIPT per the canonical chain at [shared-references/wiki-helper-resolution.md](../shared-references/wiki-helper-resolution.md) (Variant B — warn-and-skip), then ingest every paper returned by this invocation:

if [ -d research-wiki/ ]; then
  cd "$(git rev-parse --show-toplevel 2>/dev/null || pwd)" || exit 1
  ARIS_REPO="${ARIS_REPO:-$(awk -F'\t' '$1=="repo_root"{print $2; exit}' .aris/installed-skills.txt 2>/dev/null)}"
  WIKI_SCRIPT=".aris/tools/research_wiki.py"
  [ -f "$WIKI_SCRIPT" ] || WIKI_SCRIPT="tools/research_wiki.py"
  [ -f "$WIKI_SCRIPT" ] || { [ -n "${ARIS_REPO:-}" ] && WIKI_SCRIPT="$ARIS_REPO/tools/research_wiki.py"; }
  [ -f "$WIKI_SCRIPT" ] || {
    echo "WARN: research_wiki.py not found; arxiv results delivered, wiki ingest skipped. Fix: bash tools/install_aris.sh, export ARIS_REPO, or cp /tools/research_wiki.py tools/." >&2
    WIKI_SCRIPT=""
  }
  if [ -n "$WIKI_SCRIPT" ]; then
    for each arxiv_id in results:
        python3 "$WIKI_SCRIPT" ingest_paper research-wiki/ \
            --arxiv-id ""
  fi
fi

The helper handles metadata fetch, slug, dedup, page creation, index rebuild, and log append in a single call — do not handwrite papers/.md. See [shared-references/integration-contract.md](../shared-references/integration-contract.md) for the canonical-helper rule. Missed ingests can be backfilled later with python3 "$WIKI_SCRIPT" sync research-wiki/ --arxiv-ids ,,... after resolving $WIKI_SCRIPT as above.

Step 7: Final Output

Summarize what was done:

• Found N papers for "query"
• Downloaded: papers/2301.07041.pdf (842 KB) (for each download)
• Wiki-ingested N papers (if research-wiki/ was present)
• Any warnings (rate limit hit, file too small, already exists)

Suggest follow-up skills:

/research-lit "topic"     - multi-source review: Zotero + Obsidian + local PDFs + web
/novelty-check "idea"     - verify your idea is novel against these papers

Key Rules

• Always show the arXiv ID prominently - users need it for citations and reproducibility
• Verify downloaded PDFs: file must be > 10 KB; warn and delete if smaller
• Rate limit: wait 1 second between consecutive PDF downloads; retry once after 5 seconds on HTTP 429
• Never overwrite an existing PDF at the same path - skip it and report "already exists"
• Handle both arXiv ID formats: new (2301.07041) and old (cs/0601001)
• PAPER_DIR is created automatically if it does not exist
• If the arXiv API is unreachable, report the error clearly and suggest using /research-lit with - sources: web as a fallback

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: raja21068
• Source: raja21068/AutoResearch
• License: MIT

Install and usage instructions live in the source repository linked above.