arxiv-viewer — скилл для Claude Code: что делает и как установить
Скилл arxiv-viewer ищет, скачивает и читает научные статьи с arXiv через официальный API и HTML-страницы ar5iv.
Apache-2.0 133 установок ★ 1 632 обновлён 2026-10-19
npx skills add actionbook/actionbook --skill arxiv-viewer -a claude-codeЧто делает arxiv-viewer
Скилл подключает к агенту три источника данных. Метаданные и простой поиск по авторам или категориям он забирает напрямую через arXiv API. Свежие публикации и тренды читаются через веб-интерфейс arxiv.org с помощью субагента browser-fetcher, а полные тексты и формулы открываются в HTML-разметке ar5iv.org через html-reader.
Для чтения конкретных разделов или списков литературы скилл разбирает HTML-селекторы вместо парсинга тяжеловесных PDF. Скачивание самих файлов идёт напрямую через команду curl.
При запуске браузерных субагентов для arXiv или ar5iv агент обязан дождаться их завершения: параллельный вызов стандартного веб-поиска во время работы браузера прямо запрещён правилами скилла.
Какие задачи решает
- Найти научные статьи по автору, заголовку или категории
- Сгенерировать структурированный отчёт по номеру препринта
- Извлечь формулы, таблицы или список источников из HTML-версии статьи
- Проверить список свежих препринтов в выбранной дисциплине
Примеры запросов агенту
- /arxiv-viewer:search ti:transformer AND cat:cs.CL
- /arxiv-viewer:report 2301.07041
- /arxiv-viewer:figures 2301.07041
Как установить arxiv-viewer
1Через Skills CLI (Vercel)
npx skills add actionbook/actionbook --skill arxiv-viewer -a claude-code2Вручную: положить файлы
~/.claude/skills/arxiv-viewer/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/arxiv-viewer/
1Через Skills CLI (Vercel)
npx skills add actionbook/actionbook --skill arxiv-viewer -a codex2Вручную: положить файлы
.agents/skills/arxiv-viewer/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add actionbook/actionbook --skill arxiv-viewer -a cursor2Вручную: положить файлы
.cursor/skills/arxiv-viewer/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install actionbook/actionbook playground/arxiv-viewer/skills/arxiv-viewer2Вручную: положить файлы
.github/skills/arxiv-viewer/SKILL.md1Через Skills CLI (Vercel)
npx skills add actionbook/actionbook --skill arxiv-viewer -a gemini-cli2Командой платформы
gemini skills install https://github.com/actionbook/actionbook --path playground/arxiv-viewer/skills/arxiv-viewerВручную: положить файлы
.devin/skills/arxiv-viewer/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add actionbook/actionbook --skill arxiv-viewer -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об arxiv-viewer
Как установить arxiv-viewer в Claude Code?
Выполните в терминале команду npx skills add actionbook/actionbook --skill arxiv-viewer -a claude-code. Файл конфигурации сохранится по пути ~/.claude/skills/arxiv-viewer/SKILL.md.
Что делает этот скилл?
Он автоматизирует работу с репозиторием arXiv: ищет статьи по фильтрам, забирает аннотации, парсит HTML-копии через ar5iv и формирует отчёты с выводами.
Зачем скиллу сервис ar5iv.org?
Сервис ar5iv переводит статьи arXiv в веб-страницы. Благодаря этому агент читает отдельные главы, таблицы и библиографию по CSS-селекторам без разбора громоздких PDF.
Исходный текст
SKILL.md · Apache-2.0
---
name: arxiv-viewer
description: View, search, and download academic papers from arXiv. Supports API queries, web scraping via Actionbook, and HTML paper reading via ar5iv. Use when user asks about arxiv papers, academic papers, research papers, paper summaries, latest papers, or wants to search/download/read papers.
---
# arXiv Viewer
Access, search, download, and read academic papers from arXiv using a hybrid API + Actionbook approach.
## Architecture Overview
```
┌─────────────────────────────────────────────────────────────┐
│ arxiv-viewer │
├─────────────────┬─────────────────┬─────────────────────────┤
│ arXiv API │ arxiv.org Web │ ar5iv.org │
│ (WebFetch) │ (Actionbook) │ (Actionbook) │
├─────────────────┼─────────────────┼─────────────────────────┤
│ • Metadata │ • Latest list │ • Read sections │
│ • Search │ • Trending │ • Extract figures │
│ • By ID lookup │ • Advanced │ • Extract citations │
│ │ search form │ • Get outline │
└─────────────────┴─────────────────┴─────────────────────────┘
```
## Tool Priority
**By Feature:**
| Feature | Primary Tool | Fallback |
|---------|--------------|----------|
| Paper metadata | WebFetch (API) | browser-fetcher |
| Search | WebFetch (API) | browser-fetcher |
| Latest papers | browser-fetcher (Actionbook) | WebFetch (API) |
| Trending | browser-fetcher (Actionbook) | - |
| Advanced search | browser-fetcher (Actionbook) | WebFetch (API) |
| Read HTML section | html-reader (Actionbook) | Read (PDF) |
| Download PDF | Bash (curl) | - |
## Workflow Rules
### ⚠️ Agent Waiting Rule
**After launching browser-fetcher or html-reader agents:**
1. ✅ **MUST wait for ALL agents to complete**
2. ⛔ **DO NOT** use WebFetch/WebSearch while waiting
3. ✅ Only use fallback tools after agents have failed
---
## Data Sources
### 1. arXiv API (WebFetch)
**Best for:** Quick metadata lookup, simple search
```
Base URL: http://export.arxiv.org/api/query
```
| Parameter | Description |
|-----------|-------------|
| search_query | Search with field prefixes (ti:, au:, abs:, cat:) |
| id_list | Comma-separated arXiv IDs |
| max_results | 1-2000 (default: 10) |
| sortBy | relevance / submittedDate / lastUpdatedDate |
**Field Prefixes:** `ti:` (title), `au:` (author), `abs:` (abstract), `cat:` (category), `all:` (all)
**Boolean Operators:** `AND`, `OR`, `ANDNOT` (UPPERCASE)
### 2. arxiv.org Web (Actionbook + agent-browser)
**Best for:** Latest papers, trending, advanced search UI
| Page | Action ID | Use Case |
|------|-----------|----------|
| Latest list | `arxiv.org/list/{category}/recent` | Recent submissions |
| Advanced search | `arxiv.org/search/advanced` | Complex filters |
| Homepage | `arxiv.org/` | Trending/announcements |
**Workflow:**
```
1. search_actions("arxiv list recent")
2. get_action_by_id(action_id) → selectors
3. agent-browser open URL
4. agent-browser get text <selector>
5. Return results
```
### 3. ar5iv.org HTML Papers (Actionbook + agent-browser)
**Best for:** Reading specific sections, extracting figures/citations
```
HTML Paper URL: https://ar5iv.org/html/{arxiv_id}
```
| Element | Selector | Description |
|---------|----------|-------------|
| Title | `.ltx_title` | Paper title |
| Authors | `.ltx_authors` | Author list |
| Abstract | `.ltx_abstract` | Abstract text |
| Sections | `section` | All sections |
| Section title | `h2.ltx_title`, `h3.ltx_title` | Section headings |
| Paragraphs | `.ltx_para` | Paragraph content |
| Figures | `figure.ltx_figure` | Figures with captions |
| Tables | `table.ltx_tabular` | Data tables |
| Equations | `.ltx_equation` | Math equations |
| Bibliography | `.ltx_bibliography` | Reference list |
| Single citation | `.ltx_bibitem` | Individual reference |
**Workflow:**
```
1. search_actions("ar5iv section")
2. get_action_by_id(action_id) → selectors
3. agent-browser open ar5iv.org/html/{id}
4. agent-browser get text <section_selector>
5. Return section content
```
---
## URL Patterns
| Purpose | URL |
|---------|-----|
| arXiv Abstract | `https://arxiv.org/abs/{id}` |
| arXiv PDF | `https://arxiv.org/pdf/{id}.pdf` |
| arXiv API | `http://export.arxiv.org/api/query?id_list={id}` |
| ar5iv HTML | `https://ar5iv.org/html/{id}` |
| ar5iv Abstract | `https://ar5iv.org/abs/{id}` |
## arXiv ID Formats
| Format | Example |
|--------|---------|
| New (2007+) | `2301.07041` |
| With version | `2301.07041v2` |
| Old | `cs.AI/0612345` |
## Common Categories
| Code | Field |
|------|-------|
| `cs.AI` | Artificial Intelligence |
| `cs.CL` | Computation and Language (NLP) |
| `cs.CV` | Computer Vision |
| `cs.LG` | Machine Learning |
| `cs.SE` | Software Engineering |
| `stat.ML` | Statistical ML |
---
## Feature Matrix
| Command | Data Source | Agent |
|---------|-------------|-------|
| `/arxiv-viewer:paper` | API | paper-fetcher |
| `/arxiv-viewer:search` | API | search-executor |
| `/arxiv-viewer:download` | Direct URL | - |
| `/arxiv-viewer:latest` | arxiv.org | browser-fetcher |
| `/arxiv-viewer:trending` | arxiv.org | browser-fetcher |
| `/arxiv-viewer:read` | ar5iv.org | html-reader |
| `/arxiv-viewer:outline` | ar5iv.org | html-reader |
| `/arxiv-viewer:figures` | ar5iv.org | html-reader |
| `/arxiv-viewer:citations` | ar5iv.org | html-reader |
| `/arxiv-viewer:report` | API + ar5iv | paper-summarizer |
---
## Output Formats
### Paper Info
```
## {Title}
**arXiv:** {id}
**Authors:** {author1}, {author2}, ...
**Categories:** {cat1}, {cat2}
**Published:** {date}
### Abstract
{abstract}
**Links:** [Abstract]({abs_url}) | [PDF]({pdf_url}) | [HTML]({ar5iv_url})
```
### Section Content
```
## {Section Title}
{section content}
---
*Source: ar5iv.org/html/{id}*
```
### Paper Report (AI Generated)
**Command:** `/arxiv-viewer:report {arxiv_id}` or `/arxiv-viewer:report {paper_title}`
**Purpose:** Generate a comprehensive, well-formatted paper report with AI-generated analysis.
**Output Format:**
```markdown
---
> **🤖 AI Generated Content**
> Author: Powered by ActionBook
---
# {Paper Title}
**Paper Information**
| Field | Content |
|-------|---------|
| arXiv ID | {id} |
| Authors | {authors} |
| Affiliations | {affiliations} |
| Published | {date} |
| Categories | {categories} |
---
## 📋 Abstract
{abstract_summary}
---
## 🎯 Problem Statement
{problem_statement}
---
## 💡 Key Contributions
1. {contribution_1}
2. {contribution_2}
3. {contribution_3}
---
## 🔬 Method Overview
{method_summary}
---
## 📊 Experimental Results
{experimental_results}
---
## 🌟 Why It Matters
{significance}
---
## 🔗 Links
- [arXiv Abstract](https://arxiv.org/abs/{id})
- [PDF Download](https://arxiv.org/pdf/{id}.pdf)
- [HTML Version](https://ar5iv.org/html/{id})
---
> This report was automatically generated by AI based on the original paper content.
> **Powered by ActionBook** | Generated: {timestamp}
```
**Workflow:**
```
1. Fetch paper metadata via arXiv API
2. Read full paper content from ar5iv.org HTML
3. Extract key sections (abstract, intro, method, results)
4. Generate structured report with AI analysis
5. Add ActionBook branding header and footer
```
**Report Sections:**
| Section | Source | Description |
|---------|--------|-------------|
| Paper Information | API metadata | Basic paper information |
| Abstract | Abstract | Summary of abstract |
| Problem Statement | Introduction | Problem statement extracted |
| Key Contributions | Introduction | Key contributions listed |
| Method Overview | Method section | Technical approach summary |
| Experimental Results | Experiments | Key results and metrics |
| Why It Matters | Analysis | AI-generated significance |
## Rate Limiting
- arXiv API: 3 second delay between requests
- ar5iv.org: Respect server load
- agent-browser: One page at a time
© actionbook · Apache-2.0 · actionbook/actionbook