codebase-search — скилл для Claude Code: поиск по репозиторию
Скилл разбирает запросы вида «где это лежит» на один поисковый пакет и возвращает карту доказательств до правок.
npx skills add akillness/jeo-skills --skill codebase-search -a claude-codeЧто делает codebase-search
Скилл работает как маршрутизатор, а не как учебник по поиску. Он превращает запрос в один основной пакет: точный текст, символы и индексы, структура кода, конфиги и контент, поиск в хостинге или трассировка графа зависимостей. Дальше сужает область и читает только файлы-победители.
Внутри — пошаговый разбор: нормализация запроса, выбор пакета, сужение по каталогу или типу файлов, чтение определений и потребителей, ответ в виде карты доказательств с путями и строками. Скилл умеет выходить за свои границы: если область уже найдена и нужна диагностика, он передаёт работу debugging или log-analysis, а для плана миграции — code-refactoring.
Понадобится доступ к Read, Grep, Glob и Bash. Для структурного поиска нужны внешние инструменты вроде ast-grep или Semgrep, для поиска по символам — LSP или индексатор. Если репозиторий маленький и вы и так помните, где что лежит, скилл только добавит шагов.
Какие задачи решает
- найти, где определена функция и кто её вызывает
- отделить authored-файлы от vendor и generated
- определить, какие файлы отвечают за конфиг и шаблоны
- оценить поверхность изменений перед правкой
- перейти от поиска к диагностике бага без потери контекста
Примеры запросов агенту
- найди, где определён этот обработчик и кто его вызывает
- какие файлы отвечают за конфиг и шаблоны в этом репозитории
- что нужно проверить перед изменением этой схемы
Как установить codebase-search
1Через Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill codebase-search -a claude-code2Вручную: положить файлы
~/.claude/skills/codebase-search/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/codebase-search/
1Через Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill codebase-search -a codex2Вручную: положить файлы
.agents/skills/codebase-search/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill codebase-search -a cursor2Вручную: положить файлы
.cursor/skills/codebase-search/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install akillness/jeo-skills codebase-search2Вручную: положить файлы
.github/skills/codebase-search/SKILL.md1Через Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill codebase-search -a gemini-cli2Командой платформы
gemini skills install https://github.com/akillness/jeo-skills --path .agent-skills/codebase-searchВручную: положить файлы
.devin/skills/codebase-search/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill codebase-search -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о codebase-search
Как установить codebase-search в Claude?
Выполните npx skills add akillness/jeo-skills --skill codebase-search -a claude-code. Скилл появится в ~/.claude/skills/codebase-search/SKILL.md.
Что делает codebase-search?
Разбирает запрос на навигацию по репозиторию в один поисковый пакет, сужает область и возвращает карту доказательств с путями и строками до начала правок.
С какими инструментами работает скилл?
Ему нужны Read, Grep, Glob и Bash. Структурный поиск опирается на ast-grep, Semgrep или Comby, поиск по символам — на LSP или индексированный поиск.
