deepxiv
Search and progressively read open-access academic papers through DeepXiv. Use when the user wants layered paper access, section-level reading, trending papers, or DeepXiv-backed literature retrieval.
By wanshuiyin · 372 installs
npx skills add wanshuiyin/auto-claude-code-research-in-sleep --skill deepxiv
Source repository · Upstream listing
DeepXiv Paper Search & Progressive Reading
Search topic or paper ID: $ARGUMENTS
Role & Positioning
DeepXiv is the progressive reading literature source:
Skill Source Best for
/arxiv arXiv API Batch search, PDF download, metadata
/deepxiv DeepXiv SDK Progressive section level reading
/semantic scholar S2 API Published venue metadata, citation counts
/alphaxiv alphaxiv.org Instant LLM optimized summary of one paper, with LaTeX source fallback
Use DeepXiv when you want to avoid loading full papers too early.
Constants
DEEPXIV FETCHER — canonical name deepxiv fetch.py , resolved per
[ shared references/integration contract.md ](../shared references/integration contract.md) §2
(Policy D1 — primary + fallback cascade). If unresolved (canonical
chain exhausted), fall back to the raw deepxiv CLI (documented per
command below).
MAX RESULTS = 10 — Default number of results to return.
Overrides (append to arguments):
/deepxiv "agent memory" max: 5 — top 5 results
/deepxiv "2409.05591" brief — quick paper summary
/deepxiv "2409.05591" head — metadata + section overview
/deepxiv "2409.05591" section: Introduction — read one section only
/deepxiv "trending" days: 14 max: 10 — trending papers
/deepxiv "karpathy" web — DeepXiv web search
/deepxiv "258001" sc — Semantic Scholar metadata by ID
Setup
DeepXiv is optional. If the CLI is not installed, tell the user:
On first use, deepxiv auto registers a free token and stores it in ~/.env .
Workflow
Step 1: Parse Arguments
Parse $ARGUMENTS for:
Query or ID : a paper topic, arXiv ID, or Semantic Scholar ID
max: N : override MAX RESULTS
brief : fetch paper brief
head : fetch metadata and section map
section: NAME : fetch one named section
trending or query trending : fetch trending papers
days: 7 14 30 : trending time window
web : run DeepXiv web search
sc : fetch Semantic Scholar metadata by ID
If the main argument looks like an arXiv ID and no explicit mode is given, default to brief .
Step 2: Locate the Adapter
Resolve $DEEPXIV FETCHER via the canonical strict safe chain (see
[ shared references/integration contract.md ](../shared references/integration contract.md) §2).
Policy D1 cascade: the resolved adapter is preferred; if unresolved
(canonical chain exhausted), fall back to raw deepxiv CLI commands
documented in Step 3.
Step 3: Execute the Minimal Command
Search papers
Fallback:
Brief summary
Fallback:
Section map
Fallback:
Specific section
Fallback:
Trending
Fallback:
Web search
Fallback:
Semantic Scholar metadata
Fallback:
Step 4: Present Results
When searching, present a compact table:
When reading a paper, show:
title
arXiv ID
authors
venue/date if available
TLDR or abstract summary
suggested next step: brief → head → section
Step 5: Escalate Depth Only When Needed
Use this progression:
1. search
2. paper brief
3. paper head
4. paper section
5. full paper only if necessary
Do not jump to full paper reads when a brief or one section answers the question.
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). Ingest papers that were meaningfully
read (brief / head / section / full) during this invocation — mere
search hits without a depth read do not need ingestion:
The helper handles metadata / slug / dedup / page / index / log in one
call — do not handwrite papers/<slug .md . See
[ shared references/integration contract.md ](../shared references/integration contract.md).
Backfill missed ingests with
python3 "$WIKI SCRIPT" sync research wiki/ arxiv ids <id1 ,<id2 ,...
after resolving $WIKI SCRIPT as above.
Key Rules
Prefer the adapter script over raw deepxiv commands when available.
DeepXiv is optional. If unavailable, give the install command and suggest /arxiv or /research lit "topic" sources: web .
Use section level reads to save tokens.
Treat DeepXiv as complementary to /arxiv and /semantic scholar , not a replacement.
If the result overlaps with a published venue paper from Semantic Scholar, keep the richer venue metadata in the final summary.