git-submodule — скилл для Claude Code: работа с подмодулями Git
Скилл помогает решить, нужен ли подмодуль вообще, и выбрать один безопасный сценарий работы с внешним репозиторием. Пригодится, когда проект тянет чужой код через .gitmodules.
npx skills add akillness/jeo-skills --skill git-submodule -a claude-codeЧто делает git-submodule
Скилл ведёт по одному режиму за раз: добавление внешнего репозитория с фиксацией коммита, рекурсивная инициализация при клонировании, возврат подмодуля к записанному коммиту, продвижение по отслеживаемой ветке, правки внутри подмодуля, удаление и настройка выборки в CI. Сначала он разбирает запрос по полям — цель, состояние подмодуля, контекст CI и авторизации — и только потом выдаёт команды.
Внутри есть справочники: матрица решений, отдельный разбор обновлений и detached HEAD, заметки по CI и автоматизации, пакеты команд под каждый режим вместе с ограничениями хостингов. Инструменты — Bash, Read, Write, Edit, Glob, Grep, так что скилл читает файлы репозитория и предлагает конкретные шаги, а не общий учебник по Git.
Если задача про ребейз, разрешение конфликтов или историю коммитов, это не сюда — автор направляет к git-workflow. Доставка зависимостей через npm-реестр — тоже отдельный скилл. Подмодуль хранит ссылку на коммит, а не на ветку, поэтому после git submodule update легко оказаться в detached HEAD: об этом скилл предупреждает до того, как вы начнёте коммитить.
Какие задачи решает
- понять, подходит ли подмодуль под внешнюю зависимость или лучше subtree
- добавить чужой репозиторий и зафиксировать конкретный коммит
- клонировать проект с уже вложенными подмодулями
- вернуть подмодуль к коммиту, записанному в суперпроекте
- настроить выборку подмодулей в CI, включая приватные
Примеры запросов агенту
- Добавь внешний репозиторий как подмодуль и зафиксируй текущий коммит
- Клонирую проект, подмодули пустые — инициализируй их рекурсивно
- Подмодуль ушёл в detached HEAD, верни его к коммиту из суперпроекта
Как установить git-submodule
1Через Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill git-submodule -a claude-code2Вручную: положить файлы
~/.claude/skills/git-submodule/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/git-submodule/
1Через Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill git-submodule -a codex2Вручную: положить файлы
.agents/skills/git-submodule/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill git-submodule -a cursor2Вручную: положить файлы
.cursor/skills/git-submodule/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install akillness/jeo-skills git-submodule2Вручную: положить файлы
.github/skills/git-submodule/SKILL.md1Через Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill git-submodule -a gemini-cli2Командой платформы
gemini skills install https://github.com/akillness/jeo-skills --path .agent-skills/git-submoduleВручную: положить файлы
.devin/skills/git-submodule/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill git-submodule -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о git-submodule
Как установить git-submodule в Claude Code?
Выполните npx skills add akillness/jeo-skills --skill git-submodule -a claude-code. Файл скилла появится по пути ~/.claude/skills/git-submodule/SKILL.md.
Что делает git-submodule?
Помогает выбрать один рабочий сценарий с подмодулем — от добавления и фиксации коммита до настройки выборки в CI — и выдаёт команды только под этот сценарий.
Чем этот скилл отличается от git-workflow?
git-workflow про локальные ветки, ребейз и восстановление истории. git-submodule занимается границей репозитория: выбор подмодуля, инициализация, обновление указателя, detached HEAD и поведение в CI.