# git-submodule

Скилл помогает решить, нужен ли подмодуль вообще, и выбрать один безопасный сценарий работы с внешним репозиторием. Пригодится, когда проект тянет чужой код через .gitmodules.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 360 установок · ★ 50
- Автор: akillness
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/git-submodule/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/git-submodule

## Что делает

Скилл ведёт по одному режиму за раз: добавление внешнего репозитория с фиксацией коммита, рекурсивная инициализация при клонировании, возврат подмодуля к записанному коммиту, продвижение по отслеживаемой ветке, правки внутри подмодуля, удаление и настройка выборки в CI. Сначала он разбирает запрос по полям — цель, состояние подмодуля, контекст CI и авторизации — и только потом выдаёт команды.

Внутри есть справочники: матрица решений, отдельный разбор обновлений и detached `HEAD`, заметки по CI и автоматизации, пакеты команд под каждый режим вместе с ограничениями хостингов. Инструменты — `Bash`, `Read`, `Write`, `Edit`, `Glob`, `Grep`, так что скилл читает файлы репозитория и предлагает конкретные шаги, а не общий учебник по Git.

Если задача про ребейз, разрешение конфликтов или историю коммитов, это не сюда — автор направляет к `git-workflow`. Доставка зависимостей через npm-реестр — тоже отдельный скилл. Подмодуль хранит ссылку на коммит, а не на ветку, поэтому после `git submodule update` легко оказаться в detached `HEAD`: об этом скилл предупреждает до того, как вы начнёте коммитить.

## Требования
- Работает с: GitHub

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill git-submodule -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill git-submodule -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill git-submodule -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install akillness/jeo-skills git-submodule
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill git-submodule -a gemini-cli
```

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill git-submodule -a opencode
```

### Claude.ai

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

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

## Когда брать
- понять, подходит ли подмодуль под внешнюю зависимость или лучше subtree
- добавить чужой репозиторий и зафиксировать конкретный коммит
- клонировать проект с уже вложенными подмодулями
- вернуть подмодуль к коммиту, записанному в суперпроекте
- настроить выборку подмодулей в CI, включая приватные

## Примеры запросов агенту
- Добавь внешний репозиторий как подмодуль и зафиксируй текущий коммит
- Клонирую проект, подмодули пустые — инициализируй их рекурсивно
- Подмодуль ушёл в detached HEAD, верни его к коммиту из суперпроекта

## Похожие
- [triage](https://affpapa.org/nevibecode/skills/triage.md) — скилл · 990453 установки
- [code-review](https://affpapa.org/nevibecode/skills/code-review.md) — скилл · 789521 установка
- [implement](https://affpapa.org/nevibecode/skills/implement.md) — скилл · 774700 установок
- [git-guardrails-claude-code](https://affpapa.org/nevibecode/skills/git-guardrails-claude-code.md) — скилл · 499069 установок
- [setup-pre-commit](https://affpapa.org/nevibecode/skills/setup-pre-commit.md) — скилл · 489289 установок
- [scaffold-exercises](https://affpapa.org/nevibecode/skills/scaffold-exercises.md) — скилл · 480196 установок

Из того же набора: [akillness/jeo-skills](https://affpapa.org/nevibecode/by/akillness/jeo-skills.md) — 29 карточек

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