# librarian

Скилл librarian для Claude Code кэширует удалённые Git-репозитории в предсказуемом локальном пути и обновляет их при повторных обращениях. Используется для анализа внешнего кода.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 170 установок · ★ 3224 у репозитория
- Автор: mitsuhiko
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/mitsuhiko/agent-stuff/tree/HEAD/skills/librarian/SKILL.md
- Обновлён: 2026-09-27
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/mitsuhiko-librarian

## Что делает

Скилл принимает ссылку на удалённый Git-репозиторий, включая `owner/repo`, URL GitHub, GitLab или Bitbucket и формат `git@...`. Он разбирает ссылку и хранит копию по пути `~/.cache/checkouts/<host>/<org>/<repo>`, чтобы агент мог повторно искать и читать тот же код.

За кэш отвечает скрипт `checkout.sh`. При первом обращении он клонирует репозиторий, а позже использует существующую копию и обращается к `origin`, если прошло больше 300 секунд. Клон создаётся с `--filter=blob:none`; принудительное обновление запускается через `--force-update`.

Для правок рекомендуется отдельный worktree или копия, а не изменения в общем кэше. Если checkout содержит незакоммиченные изменения, fast-forward обновление не выполняется, поэтому рабочее состояние репозитория влияет на результат обновления.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install mitsuhiko/agent-stuff skills/librarian
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

## Когда брать
- закэшировать удалённый Git-репозиторий
- найти локальный путь к копии репозитория
- обновить старую копию через `origin`
- разобрать ссылку `owner/repo` в путь к checkout

## Примеры запросов агенту
- Разбери `mitsuhiko/minijinja` и используй локальную копию для поиска по коду.
- Найди путь к `https://github.com/mitsuhiko/minijinja`, затем прочитай файлы из checkout.
- Принудительно обнови кэш `github.com/mitsuhiko/minijinja` перед анализом.

## Похожие
- [open-source-librarian](https://affpapa.org/nevibecode/agents/open-source-librarian.md) — субагент · ★ 1064 у репозитория
- [find-skills](https://affpapa.org/nevibecode/skills/find-skills.md) — скилл · 4400000 установок
- [frontend-design](https://affpapa.org/nevibecode/skills/frontend-design.md) — скилл · 1025790 установок
- [agent-browser](https://affpapa.org/nevibecode/skills/vercel-labs-agent-browser.md) — скилл · 1600000 установок
- [design-taste-frontend](https://affpapa.org/nevibecode/skills/design-taste-frontend.md) — скилл · 802600 установок
- [grill-me](https://affpapa.org/nevibecode/skills/grill-me.md) — скилл · 1424476 установок
- [grill-with-docs](https://affpapa.org/nevibecode/skills/grill-with-docs.md) — скилл · 1219756 установок

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

Из того же набора: [mitsuhiko/agent-stuff](https://affpapa.org/nevibecode/by/mitsuhiko/agent-stuff.md) — 16 карточек

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

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