К основному содержанию
скилл CX Codex

literature-search · gaasher — скилл для Claude Code: что делает и как установить

Скилл literature-search ищет научные статьи через Semantic Scholar и arXiv, обходит граф цитирований и достаёт полные тексты без внешних библиотек.

MIT ★ 185 обновлён 2026-06-30

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add gaasher/Agent-Loop-Skills
/plugin install agent-loops@agent-loop-skills
Открыть на GitHub

Что делает literature-search

Скилл добавляет автономную утилиту tools/lit_search.py, которой пользуются агентные циклы для поиска академических источников и проверки новизны идей. Ядро работает через Semantic Scholar и arXiv, возвращает только JSON и обходится стандартной библиотекой Python. Если сервис недоступен, скрипт возвращает статус ошибки, чтобы агент переключился на встроенный веб-поиск.

Команды делятся на смысловой поиск по базам, извлечение точных цитат, чтение исходных публикаций с arXiv в HTML или LaTeX и навигацию по ссылкам в обе стороны. При необходимости подключаются OpenAlex, Perplexity Sonar для развёрнутых ответов и сервис bgpt.pro для извлечения метрик экспериментов.

Для запуска скрипта обязателен Python 3.9+. Базовый поиск по Semantic Scholar и arXiv не требует авторизации, а дополнительные ключи скилл советует держать в локальном файле keys.env в корне проекта.

Какие задачи решает

  • найти релевантные научные статьи и препринты с их аннотациями
  • проверить новизну гипотезы по графу цитирований
  • извлечь точные числовые данные из текста публикации без вычитывания всей статьи
  • загрузить полный текст статьи с arXiv в формате LaTeX или HTML
  • собрать синтез ответов на исследовательский вопрос через Perplexity Sonar

Примеры запросов агенту

  • Найди через literature-search недавние статьи по квантованию LLM за 2023 год с минимум 10 цитированиями
  • Изучи граф цитирований для статьи с идентификатором 10.1145/3318464.3389700 в направлении references
  • Достань точные результаты бенчмарков из статьи arxiv:2305.18290 через команду fulltext

Как установить literature-search

1Через маркетплейс плагинов

/plugin marketplace add gaasher/Agent-Loop-Skills
/plugin install agent-loops@agent-loop-skills

Команда ставит плагин agent-loops целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add gaasher/Agent-Loop-Skills --skill literature-search -a claude-code

3Вручную: положить файлы

~/.claude/skills/literature-search/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/literature-search/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о literature-search

Как установить literature-search в Claude Code?

Выполните в консоли команду npx skills add gaasher/Agent-Loop-Skills --skill literature-search -a claude-code. Также можно подключить каталог через /plugin marketplace add gaasher/Agent-Loop-Skills и установить пакет командой /plugin install agent-loops@agent-loop-skills.

Что делает literature-search?

Инструмент выполняет поиск по Semantic Scholar и arXiv, достаёт цитаты, обходит связи между работами и отдаёт структурированный JSON для агентных пайплайнов.

Нужны ли API-ключи для работы со скиллом?

Базовые запросы к Semantic Scholar и скачивание статей с arXiv работают без ключей. Дополнительные токены вроде OPENROUTER_API_KEY или BGPT_API_KEY нужны только для команд ask и расширенного парсинга через bgpt.pro.

Исходный текст

SKILL.md · MIT
---
name: literature-search
description: >
  Use when a loop needs scholarly literature — paper discovery, novelty checks, full-text snippet
  search, citation-graph traversal, single-paper reads, or experimental-result extraction. A shared,
  stdlib-only CLI (`tools/lit_search.py`) over Semantic Scholar + arXiv (plus optional OpenAlex,
  Perplexity Sonar, bgpt.pro), all JSON. Not a loop itself: install it alongside the loops and let any
  of them call it instead of vendoring their own copy. Degrades to the caller's WebSearch/WebFetch.
compatibility: Requires Python 3.9+
metadata:
  version: "0.1.0"
---

# Literature Search (shared toolchain)

This skill is **not a loop** — it is the literature-retrieval dependency several loops use for paper
discovery and novelty checks. It bundles `tools/lit_search.py` (a stdlib-only entrypoint) and the
`tools/lit/` package: Semantic Scholar (S2) for semantic search + snippets + the citation graph and
arXiv for full-text reads (the keyless core), plus optional OpenAlex, Perplexity Sonar (`ask`), and
bgpt.pro (`bgpt`) when their keys are set. Every subcommand prints JSON; on a terminal failure it
prints `{"error","fallback"}` and exits non-zero so the caller degrades to its built-in
**WebSearch/WebFetch**. No installs, Python ≥3.9.

## How a loop uses it

A consuming loop resolves these once at setup and reuses them:
- **`<lit_skill_dir>`** — where this skill is installed. After `cp -r loops/* ~/.claude/skills/` it
  sits as a **sibling** of the calling loop, e.g. `~/.claude/skills/literature-search/` (adjust per
  host). If it cannot be resolved, the caller falls back to WebSearch/WebFetch — depending on it never
  hard-breaks a loop, it only enriches it.
- **`<lit>`** — the literature CLI as a **single command token**: `<lit_skill_dir>/tools/lit_search.py`.
  The entrypoint is executable and carries a `#!/usr/bin/env python3` shebang, so it runs directly with
  no `python3` prefix. To reuse a cache across calls, append `--cache-dir <sandbox_root>/literature/.cache`
  **after the subcommand** (a per-subcommand flag, not global).
- **`<lit_py>`** — only needed for the **fallback** form on a host that doesn't honour the execute bit:
  `<lit_py> <lit_skill_dir>/tools/lit_search.py`, with `<lit_py> = python3` (any ≥3.9 interpreter).

> **Invoke `<lit>` as one command — keep it a single shell token.** In particular **zsh does not
> word-split unquoted variables**, so storing the two-word `python3 .../lit_search.py` in a variable and
> calling `$VAR` tries to exec one long (nonexistent) filename. Use the executable single-token form
> above, call the script path directly, or split explicitly (`${=VAR}` in zsh).

## Subcommands

| Subcommand | Use |
|---|---|
| `<lit> search "<q>" [--year 2020-] [--min-citations N] [--limit N] [--source s2\|openalex\|both] [--sort relevance\|citations\|recent]` | semantic discovery — related papers (titles, TLDR, abstract, citations, arxiv_id). Defaults to `--source s2` (relevance); add `openalex`/`both` to widen discovery |
| `<lit> snippet "<q>" [--limit N]` | full-text passage search — pinpoint a verbatim fact/number without reading a paper |
| `<lit> cite <paperId> --direction references\|citations\|recommend` | walk the citation graph (backward / forward / "more like this") |
| `<lit> fulltext <arxivId> [--mode auto\|latex\|pdf]` | deep-read one paper's methods/results (HTML > LaTeX > PDF) |
| `<lit> ask "<question>" [--model sonar\|sonar-pro\|sonar-reasoning]` | Perplexity Sonar synthesis — a cited high-level answer (needs `OPENROUTER_API_KEY`; else use WebSearch) |
| `<lit> bgpt "<q>" [--num N] [--days-back N]` | bgpt.pro structured experimental-result/limitations extraction (free for 50 results, then `BGPT_API_KEY`) |
| `<lit> keys [--init]` | report which API keys are present (booleans only); `--init` writes/extends `keys.env` |

The S2 + arXiv core (`search`/`snippet`/`cite`/`fulltext`) needs no keys. The optional extras
(`search --source openalex|both`, `ask`, `bgpt`) widen discovery and synthesis when their keys are set.

## API keys (the shared convention — optional, never block)

This skill is the canonical home for the project's key convention (it is the installed code that
implements it). Keys live in **one gitignored `keys.env` at the project root** (the nearest `.git`
ancestor of the working dir, else the CWD), shared by every skill in the project.

- Plain `KEY=VALUE` lines; `#` comments; blank lines ignored; `0600` perms.
- **A real OS environment variable always wins** over the file (CI/power users can just `export`).
- **All keys are optional** — a missing key degrades that one feature gracefully, down to WebSearch.
- **Secrets never enter the conversation** — the user edits `keys.env` themselves; skills read only
  presence as booleans, never values.

Onboarding flow: `<lit> keys` (report what's present) → `<lit> keys --init` (create/append slots,
append-only, never overwrites; prints the path) → user opens `keys.env` and pastes the keys they want
(in-session: `! $EDITOR ./keys.env`) → `<lit> keys` again, then proceed. Never block on keys.

- **`S2_API_KEY`** (free) — the one most worth setting; a dedicated 1 req/s for `search`/`snippet`/`cite`.
- **`OPENALEX_EMAIL`** (free, any email) — OpenAlex "polite pool" for faster `--source openalex|both`.
- **`OPENROUTER_API_KEY`** (paid) — enables `ask` (Perplexity Sonar); without it `ask` is disabled.
- **`BGPT_API_KEY`** (free for 50 results, then paid) — enables `bgpt` beyond the free tier.

## Constraints
- **Stdlib only** — never add a dependency or assume one is installed; it must run under bare `python3`.
- **Self-contained** — everything lives under this folder; no `../` escapes, no `docs/` links.
- **Fail closed to a fallback** — on any source error, emit `{"error","fallback"}` and exit non-zero
  rather than raising, so callers degrade cleanly.

© gaasher · MIT · gaasher/Agent-Loop-Skills

Похожие скиллы

Все скиллы по теме «Наука и исследования» →

Сначала — literature-search от других авторов.

literature-search lingzhi227 Скилл literature-search для Claude Code ищет научные статьи в Semantic Scholar, arXiv и OpenAlex, возвращает структурированный список с авторами, годом, цитированиями и BibTeX. CX Codex +1 2 700установок literature-search yorkeccak Скилл literature-search для Claude Code ищет научные статьи сразу в PubMed, arXiv, bioRxiv и medRxiv по запросу на обычном языке. Запускается из агента одной командой, возвращает полные тексты и ссылки на иллюстрации. CX Codex +1 605установок literature-review lingzhi227 Скилл literature-review составляет обзор научной литературы через диалог с экспертными персонами. Помогает структурировать источники и выявить пробелы при старте нового исследования. CX Codex +1 4 100установок Paper Search adamamer20 MCP-сервер Paper Search ищет научные статьи в arXiv, PubMed, bioRxiv, medRxiv, Google Scholar, Semantic Scholar, IACR и CrossRef, скачивает PDF и достаёт текст для обзора литературы. CX Codex +1 59 106установок academic-search hongluu92 Скилл academic-search помогает искать научные статьи и репозитории через ArXiv, Semantic Scholar и GitHub с точной фильтрацией. CX Codex +1 1установок systematic-literature-review bytedance Скилл systematic-literature-review для Claude Code собирает обзор по нескольким научным статьям и сопоставляет их выводы. Ищет публикации на arXiv и оформляет отчёт с цитатами. CX Codex +1 2 500установок deep-research lingzhi227 Скилл deep-research для Claude Code и Codex. Проводит систематический обзор научной литературы по теме: ищет статьи, читает их, собирает базу и пишет итоговый отчёт вместо пары ссылок из поиска. CX Codex +1 2 000установок academic-research-synthesizer davila7 Субагент academic-research-synthesizer на базе Sonnet ищет научные публикации на arXiv и Semantic Scholar, проверяет рецензирование и собирает обзор литературы со ссылками и оценкой надёжности. CX Codex 520установок

Из того же набора26

Весь набор →
data-analysis Скилл data-analysis исследует набор данных через проверяемые гипотезы и собирает отчёт с подтверждёнными числами. Запускайте его для открытого анализа, а не для поиска причины уже известной ошибки. CX Codex +1 ★ 185звёзд репо red-team Скилл red-team находит слабые места в фильтрах контента, классификаторах и API методом состязательного тестирования — генерирует атакующие вводы и собирает каталог отказов. CX Codex +1 ★ 185звёзд репо prompt-optimize Скилл prompt-optimize для Claude Code итеративно улучшает готовый промпт по команде оценки и сохраняет только правки, повышающие метрику. CX Codex +1 ★ 185звёзд репо anomaly-investigation Скилл anomaly-investigation ищет причину уже замеченного скачка, падения или выброса в данных. Он проверяет версии по очереди и фиксирует подтверждение в журнале расследования. CX Codex +1 ★ 185звёзд репо power-analysis Скилл power-analysis для Claude Code рассчитывает размер выборки для двухгруппового сравнения и помогает подготовить пререгистрацию. Включается при планировании A/B-теста, простого RCT или оценки двух моделей до сбора данных. CX Codex +1 ★ 185звёзд репо claim-verify Скилл claim-verify проверяет числовые утверждения из черновика отчёта по исходным данным. Находит расхождения, тестирует выводы на выбросы и уточняет формулировки перед публикацией. CX Codex +1 ★ 185звёзд репо literature-survey Скилл literature-survey для Claude Code строит обзор исследований в виде матрицы источников и утверждений. Он подключается для поиска согласий, противоречий и пробелов по вопросу. CX Codex +1 ★ 185звёзд репо optimize-loop Скилл optimize-loop гоняет цикл правок с жёстким гейтом корректности и метрикой, которую надо снизить: рефакторинг модуля под зелёные тесты или ускорение SQL-запроса с тем же набором строк. CX Codex +1 ★ 185звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой