zotero-paper-reader — скилл для Claude Code: читает статьи из Zotero
Находит статью в библиотеке Zotero по названию, автору или теме, вытаскивает PDF и переводит его в markdown, чтобы агент прочитал текст и разобрал его.
npx skills add FuZhiyu/ResearchProjectTemplate --skill zotero-paper-reader -a claude-codeЧто делает 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 токенов и больше читаются частями, иначе контекст переполнится.
Какие задачи решает
- найти статью в Zotero по фамилии автора или теме
- получить PDF из локального хранилища или веб-библиотеки
- перевести PDF в markdown с картинками
- разобрать abstract и ключевые разделы большой статьи
- сложить конспекты статей в одну папку с понятными именами
Примеры запросов агенту
- Прочитай статью «Are Intermediary Constraints Priced» из моей библиотеки Zotero
- Найди в Zotero работы Du за 2023 год и разбери abstract
- Сконвертируй эту статью из Zotero в markdown и сохрани в
Notes/PaperInMarkdown/
Как установить zotero-paper-reader
1Через Skills CLI (Vercel)
npx skills add FuZhiyu/ResearchProjectTemplate --skill zotero-paper-reader -a claude-code2Вручную: положить файлы
~/.claude/skills/zotero-paper-reader/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/zotero-paper-reader/
1Через Skills CLI (Vercel)
npx skills add FuZhiyu/ResearchProjectTemplate --skill zotero-paper-reader -a codex2Вручную: положить файлы
.agents/skills/zotero-paper-reader/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add FuZhiyu/ResearchProjectTemplate --skill zotero-paper-reader -a cursor2Вручную: положить файлы
.cursor/skills/zotero-paper-reader/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install FuZhiyu/ResearchProjectTemplate zotero-paper-reader2Вручную: положить файлы
.github/skills/zotero-paper-reader/SKILL.md1Через Skills CLI (Vercel)
npx skills add FuZhiyu/ResearchProjectTemplate --skill zotero-paper-reader -a gemini-cli2Командой платформы
gemini skills install https://github.com/FuZhiyu/ResearchProjectTemplate --path ProjectExample/.claude/skills/zotero-paper-readerВручную: положить файлы
.devin/skills/zotero-paper-reader/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add FuZhiyu/ResearchProjectTemplate --skill zotero-paper-reader -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о zotero-paper-reader
Как установить zotero-paper-reader в Claude Code?
Выполните npx skills add FuZhiyu/ResearchProjectTemplate --skill zotero-paper-reader -a claude-code. Скилл окажется в ~/.claude/skills/zotero-paper-reader/SKILL.md.
Что делает zotero-paper-reader?
Ищет статью в Zotero, достаёт её PDF, конвертирует в markdown и читает текст, чтобы выдать метаданные, краткое содержание abstract и основные выводы.
Что нужно настроить перед первым запуском?
Для веб-библиотеки — ZOTERO_API_KEY, ZOTERO_LIBRARY_TYPE и ZOTERO_LIBRARY_ID в Notes/.env, плюс ключ Mistral для конвертации PDF. С локальной библиотекой достаточно включить локальный API в настройках Zotero.
