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.