# git-troubleshooting

Скилл помогает разбирать ошибки Git, возвращать потерянные коммиты и исправлять конфликты. Пригодится после неудачного reset, merge или rebase.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 345 установок · ★ 8
- Автор: geoffjay
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/geoffjay/claude-plugins/tree/HEAD/plugins/utilities/git/skills/git-troubleshooting/SKILL.md
- Обновлён: 2025-11-04
- HTML: https://affpapa.org/nevibecode/skills/git-troubleshooting

## Что делает

\`git-troubleshooting` даёт агенту инструкции для диагностики проблем в репозитории. Он разбирает потерянные коммиты и ветки через `git reflog` и `git fsck`, помогает выйти из detached HEAD, исправить конфликты merge и rebase, а также проверить повреждённые объекты, индекс и ссылки.

Внутри описаны сценарии для `git status`, `git diff`, `git reset`, `git branch`, `git update-ref` и других команд Git. Есть отдельные шаги для отмены merge, rebase, cherry-pick и revert. Команды вроде `git reset --hard` меняют состояние репозитория, поэтому перед восстановлением нужно найти правильный коммит через `git reflog`.

Скилл доступен для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Для установки в Claude Code нужен `npx`.

## Установка

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

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

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add geoffjay/claude-plugins --skill git-troubleshooting -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add geoffjay/claude-plugins --skill git-troubleshooting -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install geoffjay/claude-plugins git-troubleshooting
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add geoffjay/claude-plugins --skill git-troubleshooting -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/geoffjay/claude-plugins --path plugins/utilities/git/skills/git-troubleshooting
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add geoffjay/claude-plugins --skill git-troubleshooting -a opencode
```

### Claude.ai

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

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

## Когда брать
- вернуть потерянный коммит через reflog
- восстановить удалённую ветку
- выйти из detached HEAD
- разрешить конфликт merge или rebase
- проверить повреждение репозитория

## Примеры запросов агенту
- Найди потерянный коммит после `git reset --hard` и предложи безопасный способ его вернуть.
- Разбери текущий конфликт merge в `file.go` и подготовь последовательность команд для его завершения.
- Проверь, почему репозиторий повреждён, используя подходящие команды Git.

## Похожие
- [melt](https://affpapa.org/nevibecode/skills/melt.md) — скилл · 634 установки
- [git-advanced-workflows](https://affpapa.org/nevibecode/skills/git-advanced-workflows.md) — скилл · 19356 установок
- [git-workflow](https://affpapa.org/nevibecode/skills/jezweb-git-workflow.md) — скилл · 1200 установок
- [git-master](https://affpapa.org/nevibecode/skills/git-master.md) — скилл · 787 установок
- [git-integrate](https://affpapa.org/nevibecode/skills/git-integrate.md) — скилл · 389 установок
- [git-rebase](https://affpapa.org/nevibecode/skills/git-rebase.md) — скилл · 376 установок

Из того же набора: [geoffjay/claude-plugins](https://affpapa.org/nevibecode/by/geoffjay/claude-plugins.md) — 3 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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