# zotero-paper-reader

Находит статью в библиотеке Zotero по названию, автору или теме, вытаскивает PDF и переводит его в markdown, чтобы агент прочитал текст и разобрал его.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 606 установок · ★ 10
- Автор: FuZhiyu
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/FuZhiyu/ResearchProjectTemplate/tree/HEAD/ProjectExample/.claude/skills/zotero-paper-reader/SKILL.md
- Обновлён: 2025-12-05
- HTML: https://affpapa.org/nevibecode/skills/zotero-paper-reader

## Что делает

Скилл ведёт всю цепочку сам. Сначала ищет запись в Zotero через MCP-инструменты, показывает найденные варианты, если совпадений несколько, и берёт `item_key` выбранной статьи. Потом запрашивает вложения, находит файл с типом `application/pdf` и передаёт его ключ скрипту `get_zotero_pdf.py`.

Скрипт запускается через `uv run python` и сначала проверяет локальное хранилище `~/Zotero/storage/`, а если файла там нет — скачивает его из веб-библиотеки по API. Дальше PDF уходит в скилл `mistral-pdf-to-markdown`, и готовый markdown ложится в `Notes/PaperInMarkdown/` под именем вида `Author_Year_Title.md`. Картинки из статьи попадают в подпапку `images/`.

Для веб-библиотеки нужны `ZOTERO_API_KEY`, `ZOTERO_LIBRARY_TYPE` и `ZOTERO_LIBRARY_ID` в `Notes/.env`, для конвертации — ключ Mistral там же. Локальная библиотека работает только если в настройках Zotero включён локальный API. Статьи на 40k токенов и больше читаются частями, иначе контекст переполнится.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add FuZhiyu/ResearchProjectTemplate --skill zotero-paper-reader -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/zotero-paper-reader/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/zotero-paper-reader/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add FuZhiyu/ResearchProjectTemplate --skill zotero-paper-reader -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/zotero-paper-reader/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add FuZhiyu/ResearchProjectTemplate --skill zotero-paper-reader -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/zotero-paper-reader/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install FuZhiyu/ResearchProjectTemplate zotero-paper-reader
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/zotero-paper-reader/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add FuZhiyu/ResearchProjectTemplate --skill zotero-paper-reader -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/FuZhiyu/ResearchProjectTemplate --path ProjectExample/.claude/skills/zotero-paper-reader
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/zotero-paper-reader/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add FuZhiyu/ResearchProjectTemplate --skill zotero-paper-reader -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/FuZhiyu/ResearchProjectTemplate/tree/HEAD/ProjectExample/.claude/skills/zotero-paper-reader/SKILL.md

## Когда брать
- найти статью в Zotero по фамилии автора или теме
- получить PDF из локального хранилища или веб-библиотеки
- перевести PDF в markdown с картинками
- разобрать abstract и ключевые разделы большой статьи
- сложить конспекты статей в одну папку с понятными именами

## Примеры запросов агенту
- Прочитай статью «Are Intermediary Constraints Priced» из моей библиотеки Zotero
- Найди в Zotero работы Du за 2023 год и разбери abstract
- Сконвертируй эту статью из Zotero в markdown и сохрани в `Notes/PaperInMarkdown/`

## Похожие
- [anysearch](https://affpapa.org/nevibecode/skills/anysearch.md) — скилл · 38500 установок
- [academic-paper](https://affpapa.org/nevibecode/skills/academic-paper.md) — скилл · 10800 установок
- [nature-figure](https://affpapa.org/nevibecode/skills/nature-figure.md) — скилл · 18800 установок
- [academic-paper-reviewer](https://affpapa.org/nevibecode/skills/academic-paper-reviewer.md) — скилл · 9800 установок
- [nature-polishing](https://affpapa.org/nevibecode/skills/nature-polishing.md) — скилл · 17500 установок
- [nature-citation](https://affpapa.org/nevibecode/skills/nature-citation.md) — скилл · 15600 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md