codebase-onboarding · borghei — скилл для Claude Code
Скилл codebase-onboarding для Claude Code собирает факты о кодовой базе и готовит документацию для онбординга: обзор архитектуры, карту ключевых файлов, гайд по запуску и справочник по отладке.
LicenseRef-MIT-Commons-Clause 117 установок ★ 1 183 обновлён 2026-11-08
npx skills add borghei/Claude-Skills --skill codebase-onboarding -a claude-codeЧто делает codebase-onboarding
Внутри три Python-скрипта: onboarding_generator.py читает манифесты и локфайлы, собирает стек, точки входа, ключевые файлы и переменные окружения, потом генерирует черновик документации с метками > **TODO (owner):** там, где агент не может ответить сам. architecture_mapper.py определяет паттерн проекта — монорепо, микросервисы, MVC, слоистая архитектура — и расписывает роли директорий. setup_validator.py проверяет README, .env-шаблон, локфайл, CI, конфиг линтера, тесты и лицензию, выставляет оценку от 0 до 100 и показывает, что починить.
Выходной формат — Markdown, Notion или Confluence. Глубина подачи меняется в зависимости от аудитории: джуниор, старший инженер или подрядчик получают разные секции. Черновик из onboarding_generator.py не финал: скилл явно говорит об этом и оставляет TODO-метки на всё, что нужно перепроверить руками или уточнить у владельцев.
Если setup_validator.py выдаёт низкий балл, гайд по настройке будет неполным — потому что скрипт нашёл реальные пробелы в репозитории. Код расположен в scripts/, шаблоны документации — в references/documentation-templates.md. Для пошагового тура по коду (остановка за остановкой) скилл отсылает к engineering/code-tour.
Какие задачи решает
- сгенерировать черновик онбординговой документации после крупного рефакторинга
- проверить полноту настройки репозитория перед открытием в open-source
- составить карту ключевых файлов для нового инженера в команде
- создать отладочный справочник с реальными сообщениями об ошибках
- подготовить документацию по сервису перед отпуском или сменой команды
Примеры запросов агенту
- Проанализируй кодовую базу в
/path/to/projectи сгенерируй онбординговый гайд в формате Markdown для джуниор-разработчика - Запусти
setup_validator.pyна текущем проекте и покажи, какие пробелы мешают честному гайду по настройке - Собери карту ключевых файлов: точки входа, конфиг-хабы и файлы, которые нельзя трогать без координации
Как установить codebase-onboarding
1Через Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill codebase-onboarding -a claude-code2Вручную: положить файлы
~/.claude/skills/codebase-onboarding/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/codebase-onboarding/
1Через Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill codebase-onboarding -a codex2Вручную: положить файлы
.agents/skills/codebase-onboarding/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill codebase-onboarding -a cursor2Вручную: положить файлы
.cursor/skills/codebase-onboarding/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install borghei/Claude-Skills engineering/codebase-onboarding/SKILL.md2Вручную: положить файлы
.github/skills/codebase-onboarding/SKILL.md1Через Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill codebase-onboarding -a gemini-cli2Командой платформы
gemini skills install https://github.com/borghei/Claude-Skills --path engineering/codebase-onboardingВручную: положить файлы
.devin/skills/codebase-onboarding/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill codebase-onboarding -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о codebase-onboarding
Как установить codebase-onboarding в Claude Code?
Выполни команду npx skills add borghei/Claude-Skills --skill codebase-onboarding -a claude-code. Скилл появится по пути ~/.claude/skills/codebase-onboarding/SKILL.md.
Что делает скилл codebase-onboarding?
Он запускает три Python-скрипта, которые собирают факты о проекте — стек, архитектурные паттерны, точки входа, переменные окружения — и собирают из них черновик онбординговой документации с TODO-метками на места, которые нужно заполнить вручную.
Нужно ли что-то устанавливать дополнительно, кроме самого скилла?
Скрипты написаны на Python, поэтому Python должен быть в PATH. Вывод скриптов через --json и конкретные форматы (--format markdown) работают без сторонних библиотек — скилл использует только то, что есть в репозитории.
Похожие скиллы
Все скиллы по теме «Тексты и документация» →Сначала — codebase-onboarding от других авторов.