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 www.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:
Authentication is handled by the third party deepxiv sdk CLI using
DEEPXIV TOKEN . In [SDK 1.2.2](https://pypi.org/project/deepxiv sdk/1.2.2/),
a command that needs a token auto registers one if none is configured and saves
it to ~/.env . With python dotenv installed, the CLI also loads ~/.env and
the current project's .env on startup. Providing DEEPXIV TOKEN in the CLI's
environment skips automatic registration and token saving, but does not disable
that file loading. This skill does not need to read those files or display tokens;
leave authentication to the CLI.
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.