arxiv_deep_reader

Name: arxiv_deep_reader
Author: aurora-1412

Description

利用python，指定某个arxiv_id/url，基于 LLM Agent 对这篇arxiv论文进行分类与深度阅读，直接print打印阅读笔记

README (SKILL.md)

快速开始

1. 配置 `.env`

cp .env.example .env   # 或直接编辑 .env

确定你已经配置了：

LLM_API_KEY — OpenAI 或兼容 API 的密钥
LLM_BASE_URL — API 地址

2. 运行

uv venv
uv pip install -r "{baseDir}/requirements.txt"

# 单篇论文模式：指定 arxiv_id 或 URL
uv run python "{baseDir}/main.py" --arxiv-id 2401.12345
uv run python "{baseDir}/main.py" --arxiv-id https://arxiv.org/abs/2401.12345
uv run python "{baseDir}/main.py" --arxiv-id https://arxiv.org/pdf/2401.12345.pdf

# 指定以特定类别阅读
uv run python "{baseDir}/main.py" --arxiv-id xxxx --category yyy

# 查看所有类别
uv run python "{baseDir}/main.py" --list

添加新的阅读分类

在 skills/ 下新建文件夹，包含两个文件：

skills/your_new_category/
├── _metadata.md        # 分类描述（告诉 Classifier 什么论文属于这个类别）
└── reading_prompt.md   # 阅读指南（告诉 Reader Agent 重点关注什么）

重启即可自动识别，无需修改任何代码。

Python包

LangChain 1.x — Agent 框架（基于 LangGraph）
LangChain OpenAI — LLM 接口（兼容 DeepSeek 等 OpenAI-compatible API）
arxiv — 官方 Python 库
arxiv-to-prompt 获取arxiv论文latex源码

Usage Guidance

This skill appears coherent and implements the advertised functionality, but review the following before installing: - Secrets and data flow: you must provide LLM_API_KEY and LLM_BASE_URL — the tool will send full paper text (including LaTeX) to that LLM provider. Only use an API/key you trust and do not supply keys for services you do not want to see this data. - Binary requirement mismatch: registry lists 'uv' as required, but the code requires a Python runtime (and pip). Ensure you have a suitable Python interpreter and understand what the 'uv' wrapper is in your environment. - Dependencies: installation uses requirements.txt (pip). Inspect requirements.txt and the 'arxiv-to-prompt' package on PyPI before installing to confirm they are legitimate and to decide whether to pin versions. - .env file: the repository includes a .env template with ARXIV_* defaults and a default LLM_BASE_URL. Double-check and override these values as needed; do not accidentally commit your API key into version control. If you are comfortable with the LLM provider and the Python/pip install process, the skill is reasonable to run. If you want extra assurance, review the requirements and the upstream PyPI packages before installation.

Capability Analysis

Type: OpenClaw Skill Name: arxiv-reader Version: 1.0.3 The OpenClaw Arxiv Paper Reader skill bundle is classified as benign. All code and documentation align with the stated purpose of fetching, classifying, and deeply reading arXiv papers using an LLM agent. The skill uses standard Python libraries (`langchain`, `arxiv`, `requests`, `python-dotenv`, `arxiv-to-prompt`), interacts with the arXiv API, and configures an LLM client using provided environment variables (e.g., `LLM_API_KEY`). While the skill's design involves loading markdown files (`_metadata.md`, `reading_prompt.md`) into the LLM agent's prompts, which represents a potential prompt injection surface, the content of these files within the bundle is benign and directly guides the agent's paper analysis, without any instructions for unauthorized actions, data exfiltration, or system compromise. No evidence of malicious execution, persistence mechanisms, or obfuscation was found.

Capability Assessment

ℹ Purpose & Capability

The skill's code and SKILL.md match the description: it fetches arXiv papers, parses LaTeX, and calls an LLM to produce notes. However, the registry metadata lists only 'uv' as a required binary while the implementation clearly needs a Python runtime (it runs main.py and uses pip). Also the code reads ARXIV_* configuration values from .env (ARXIV_CATEGORIES, ARXIV_MAX_RESULTS, FETCH_LOOKBACK_DAYS) which are not listed in requires.env — these are non-secret config values but represent a small metadata mismatch.

✓ Instruction Scope

SKILL.md instructs creating a .env and running commands via the 'uv' wrapper; runtime instructions are limited to fetching/arXiv parsing and LLM calls. The code reads only project files (skills/, prompts/, .env) and fetches content from arXiv and the configured LLM endpoint; it does not access system-wide secrets or unrelated files. It will send paper text (including parsed LaTeX) to the LLM provider — expected for this functionality.

ℹ Install Mechanism

There is no formal install spec in the registry (instruction-only install), but the repository includes requirements.txt and the SKILL.md tells users to run 'uv pip install -r requirements.txt'. That means dependencies will be installed from PyPI (moderate risk compared to no install spec). Also the requirements include an unversioned 'arxiv-to-prompt' entry — you may wish to inspect that package on PyPI before installing.

ℹ Credentials

The declared required env vars (LLM_API_KEY, LLM_BASE_URL, LLM_TEMPERATURE, LLM_MAX_TOKENS) are proportional to an LLM-based reader; LLM_API_KEY is the primary credential as expected. Two small notes: (1) config.py also reads ARXIV_* and FETCH_LOOKBACK_DAYS from .env but these are not listed in requires.env (they are not secrets but are configuration values). (2) The skill will transmit full paper text (and parsed LaTeX) to the configured LLM endpoint — if you use a third-party LLM service, you are sending content to that service and should be comfortable with that data flow.

✓ Persistence & Privilege

The skill does not request permanent 'always' inclusion and does not change other skills or system-level settings. It runs as a normal user-level Python program and does not request elevated privileges.

Version History

v1.0.3

- Switched from Python/conda to uv for environment creation and package installation. - Updated all usage and setup instructions to use uv commands. - Updated required binary from python to uv in metadata. p.s.: prompts are Chinese default, you can change it to English manually.

v1.0.2

Version 1.0.2 - Updated SKILL.md with a new metadata block for better environment and dependency specification. - Simplified and clarified the Quick Start section, using variable placeholders for reproducibility. - Streamlined instructions to focus on single-paper reading and category specification. - Removed the workflow and project structure details from documentation for a more concise guide. - Added clear requirements for essential environment variables.

v1.0.1

- README.md removed from the project. - No functional or code changes in this version. - Project documentation and usage instructions are now provided in SKILL.md.

v1.0.0

arxiv-reader v1.0.0 Changelog - Initial release of the ArXiv Reader Skill. - Reads arXiv papers by ID or URL and outputs raw markdown notes via a Python script. - Supports specifying paper categories and listing available categories. - Allows users to add custom categories with specific metadata and reading prompts. - Setup instructions and usage examples included for easy configuration.

Metadata

Slug arxiv-reader

Version 1.0.3

License —

All-time Installs 25

Active Installs 25

Total Versions 4

Frequently Asked Questions

What is arxiv_deep_reader?

利用python，指定某个arxiv_id/url，基于 LLM Agent 对这篇arxiv论文进行分类与深度阅读，直接print打印阅读笔记. It is an AI Agent Skill for Claude Code / OpenClaw, with 946 downloads so far.

How do I install arxiv_deep_reader?

Run "/install arxiv-reader" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is arxiv_deep_reader free?

Yes, arxiv_deep_reader is completely free (open-source). You can download, install and use it at no cost.

Which platforms does arxiv_deep_reader support?

arxiv_deep_reader is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created arxiv_deep_reader?

It is built and maintained by Aurora-1412 (@aurora-1412); the current version is v1.0.3.

More Skills