# librarian

Скилл для работы с хранилищем заметок через Librarian MCP: импорт документов, поиск прошлых решений, граф связей и дневник обучения.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 35
- Автор: ngmeyer
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/ngmeyer/librarian-mcp/tree/HEAD/skill/SKILL.md
- Обновлён: 2026-09-18
- HTML: https://affpapa.org/nevibecode/skills/librarian

## Что делает

Скилл `librarian` — это обёртка над инструментами Librarian MCP-сервера. Он превращает обычную папку заметок в базу знаний: забирает файлы из `docs/solutions/`, конвертирует PDF, DOCX, картинки и таблицы в markdown, а потом сам проставляет `[[викиссылки]]` на уже существующие заметки. Есть команды для импорта писем из Gmail, страниц из веба, тредов из X/Twitter и событий календаря.

Внутри — набор подкоманд: `ingest`, `import`, `from`, `search`, `connect`, `daily`, `graph`, `analyze`, `daydream`, `status`. `search` ищет по хранилищу прошлые решения, `connect` находит пропущенные ссылки, `analyze` строит отчёт по структуре графа, `daydream` ищет неочевидные связи между заметками. Если вызвать скилл без аргументов, он покажет список команд.

Перед первым запуском нужен настроенный и работающий Librarian MCP-сервер: проверка идёт через `library_stats`. Если он не отвечает, скилл не станет ничего делать сам — попросит выполнить `librarian-mcp --setup /path/to/vault` и перезапустить Claude. Для команды `import` отдельно нужен MarkItDown: `pip install markitdown`. Без него конвертация не пойдёт, и скилл об этом скажет прямо, а обходить не станет.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ngmeyer/librarian-mcp --skill skill -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ngmeyer/librarian-mcp --skill skill -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ngmeyer/librarian-mcp --skill skill -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ngmeyer/librarian-mcp skill
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ngmeyer/librarian-mcp --skill skill -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/ngmeyer/librarian-mcp --path skill
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add ngmeyer/librarian-mcp --skill skill -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/ngmeyer/librarian-mcp/tree/HEAD/skill/SKILL.md

## Когда брать
- перенести разбор бага из `docs/solutions/` в общее хранилище заметок
- найти в архиве, как эта задача решалась раньше
- превратить PDF или DOCX в markdown с готовыми ссылками
- сохранить переписку из Gmail как структурированную заметку
- дописать вывод дня в дневную заметку

## Примеры запросов агенту
- Забери последний файл из `docs/solutions/` в хранилище
- Найди в хранилище, как я раньше чинил таймаут HMR
- Импортируй `quarterly-report.pdf` в заметки

## Похожие
- [knowledge-base](https://affpapa.org/nevibecode/skills/knowledge-base.md) — скилл · 835 установок
- [llm-wiki](https://affpapa.org/nevibecode/skills/akillness-llm-wiki.md) — скилл · 322 установки
- [karpathy-llm-wiki](https://affpapa.org/nevibecode/skills/karpathy-llm-wiki.md) — скилл · 8200 установок
- [wiki](https://affpapa.org/nevibecode/skills/agricidaniel-wiki.md) — скилл · 539 установок
- [save](https://affpapa.org/nevibecode/skills/save.md) — скилл · 511 установок
- [obsidian-source-ingestion](https://affpapa.org/nevibecode/skills/obsidian-source-ingestion.md) — скилл · 320 установок

## Другие версии с тем же именем
- [librarian · diodeinc](https://affpapa.org/nevibecode/skills/diodeinc-librarian.md) — 539 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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