librarian · mitsuhiko — скилл для Claude Code: кэш Git, установка
Скилл librarian для Claude Code кэширует удалённые Git-репозитории в предсказуемом локальном пути и обновляет их при повторных обращениях. Используется для анализа внешнего кода.
Apache-2.0 170 установок ★ 3 224 обновлён 2026-09-27
npx skills add mitsuhiko/agent-stuff --skill librarian -a claude-codeЧто делает 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 обновление не выполняется, поэтому рабочее состояние репозитория влияет на результат обновления.
Какие задачи решает
- закэшировать удалённый Git-репозиторий
- найти локальный путь к копии репозитория
- обновить старую копию через
origin - разобрать ссылку
owner/repoв путь к checkout
Примеры запросов агенту
- Разбери
mitsuhiko/minijinjaи используй локальную копию для поиска по коду. - Найди путь к
https://github.com/mitsuhiko/minijinja, затем прочитай файлы из checkout. - Принудительно обнови кэш
github.com/mitsuhiko/minijinjaперед анализом.
Как установить librarian
1Через Skills CLI (Vercel)
npx skills add mitsuhiko/agent-stuff --skill librarian -a claude-code2Вручную: положить файлы
~/.claude/skills/librarian/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/librarian/
1Через Skills CLI (Vercel)
npx skills add mitsuhiko/agent-stuff --skill librarian -a codex2Вручную: положить файлы
.agents/skills/librarian/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add mitsuhiko/agent-stuff --skill librarian -a cursor2Вручную: положить файлы
.cursor/skills/librarian/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install mitsuhiko/agent-stuff skills/librarian2Вручную: положить файлы
.github/skills/librarian/SKILL.md1Через Skills CLI (Vercel)
npx skills add mitsuhiko/agent-stuff --skill librarian -a gemini-cli2Командой платформы
gemini skills install https://github.com/mitsuhiko/agent-stuff --path skills/librarianВручную: положить файлы
.devin/skills/librarian/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add mitsuhiko/agent-stuff --skill librarian -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о librarian
Как установить librarian в Claude Code?
Выполните npx skills add mitsuhiko/agent-stuff --skill librarian -a claude-code, затем используйте файл ~/.claude/skills/librarian/SKILL.md.
Что делает librarian?
Скилл клонирует удалённые Git-репозитории в ~/.cache/checkouts/<host>/<org>/<repo> и повторно использует локальную копию. При устаревшем checkout он обновляет данные через origin.
Как принудительно обновить кэш репозитория?
Запустите bash checkout.sh <repo> --force-update --path-only. Обычное обновление ограничено интервалом в 300 секунд.
Исходный текст
SKILL.md · Apache-2.0
--- name: librarian description: "Cache and refresh remote git repositories under ~/.cache/checkouts/<host>/<org>/<repo> so future references can reuse a local copy. Use this skill when the user points you to a remote git repository as reference or you encountered a remote git repo through other means." --- Use this skill when the user points you to a remote git repository (GitHub/GitLab/Bitbucket URLs, `git@...`, or `owner/repo` shorthand). The goal is to keep a reusable local checkout that is: - **stable** (predictable path) - **up to date** (periodic fetch + fast-forward when safe) - **efficient** (partial clone with `--filter=blob:none`, no repeated full clones) ## Cache location Repositories are stored at: `~/.cache/checkouts/<host>/<org>/<repo>` Example: `github.com/mitsuhiko/minijinja` → `~/.cache/checkouts/github.com/mitsuhiko/minijinja` ## Command ```bash bash checkout.sh <repo> --path-only ``` Examples: ```bash bash checkout.sh mitsuhiko/minijinja --path-only bash checkout.sh github.com/mitsuhiko/minijinja --path-only bash checkout.sh https://github.com/mitsuhiko/minijinja --path-only ``` The script will: 1. Parse the repo reference into host/org/repo. 2. Clone if missing. 3. Reuse existing checkout if present. 4. Fetch from `origin` when stale (default interval: 300s). 5. Attempt a fast-forward merge if the checkout is clean and has an upstream. ## Update strategy - Default behavior is **throttled refresh** (every 5 minutes) to avoid unnecessary network calls. - Force immediate refresh with: ```bash bash checkout.sh <repo> --force-update --path-only ``` ## Recommended workflow 1. Resolve repository path via `checkout.sh --path-only`. 2. Use that path for searching, reading, and analysis. 3. On later references to the same repo, call `checkout.sh` again; it will find and update the cached checkout. ## If edits are needed Prefer not to edit directly in the shared cache. Create a separate worktree or copy from the cached checkout for task-specific modifications. ## Notes - `owner/repo` defaults to `github.com`.
© mitsuhiko · Apache-2.0 · mitsuhiko/agent-stuff
Похожие скиллы
Каталог скиллов SKILL.md →Сначала — librarian от других авторов.