# bib-search-citation

Ищет записи в локальной библиотеке BibTeX или BibLaTeX, включая выгрузки Zotero, и собирает из них сниппеты цитирования для LaTeX или Typst.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1700 установок · ★ 519
- Автор: bahayonghang
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/bahayonghang/academic-writing-skills/tree/HEAD/academic-writing-skills/bib-search-citation/SKILL.md
- Обновлён: 2026-10-15
- HTML: https://affpapa.org/nevibecode/skills/bib-search-citation

## Что делает

Скилл работает с одним локальным файлом `.bib`. Запрос можно задать компактной строкой с фильтрами прямо в `--query`, отдать готовую спецификацию через `--spec-json` или сохранить её в файл и переиспользовать через `--spec-file`. Внутри два скрипта: `search_bib.py` разбирает библиотеку, фильтрует, ранжирует и формирует цитаты, `preview_bib_search.py` рисует компактный человекочитаемый отчёт по уже готовому JSON.

Фильтровать можно по годам, авторам, типу записи, наличию полей и по тому, что встречается в полях вроде `keywords`, `abstract` или `annotation`. Сортировка — по релевантности, году или названию, вывод — в LaTeX, Typst или в обоих форматах. Сырой BibTeX скилл отдаёт только по запросу, когда нужен точный экспорт или ручная проверка.

Ранжирование по совпадению слов с формулировкой утверждения ничего не доказывает: скилл сам предупреждает, что лексическое пересечение не подтверждает поддержку тезиса. Валидацию цитат уже внутри `.tex` или `.typ` проекта он тоже не делает, это задача другого модуля. Ещё нужен `uv`, иначе скрипты не запустятся.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add bahayonghang/academic-writing-skills --skill bib-search-citation -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add bahayonghang/academic-writing-skills --skill bib-search-citation -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add bahayonghang/academic-writing-skills --skill bib-search-citation -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install bahayonghang/academic-writing-skills bib-search-citation
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add bahayonghang/academic-writing-skills --skill bib-search-citation -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/bahayonghang/academic-writing-skills --path academic-writing-skills/bib-search-citation
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add bahayonghang/academic-writing-skills --skill bib-search-citation -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/bahayonghang/academic-writing-skills/tree/HEAD/academic-writing-skills/bib-search-citation/SKILL.md

## Когда брать
- найти в references.bib статьи по теме за последние годы
- собрать сниппеты \cite{} для выбранных записей
- отфильтровать выгрузку Zotero по аннотации или ключевым словам
- проверить наличие DOI и arXiv ID у записи
- достать точный BibTeX одной записи для ручной сверки

## Примеры запросов агенту
- Найди в `references.bib` статьи про mamba forecasting за 2024 год и дальше, выдай 5 штук с цитатами в LaTeX и Typst
- Отфильтруй записи Zotero, у которых в `annotation` упомянут код, и покажи превью
- Покажи сырой BibTeX лучшего совпадения из `references.bib`

## Похожие
- [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 установок

Из того же набора: [bahayonghang/academic-writing-skills](https://affpapa.org/nevibecode/by/bahayonghang/academic-writing-skills.md) — 5 карточек

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