# code-explainer

Скилл code-explainer для Claude Code, Cursor, GitHub Copilot и других платформ разбирает код пошагово: объясняет алгоритмы, паттерны, ошибки и зависимости разным уровням разработчиков.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 7 установок · ★ 29 у репозитория
- Автор: CuriousLearner
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/CuriousLearner/devkit/tree/HEAD/skills/code-explainer/SKILL.md
- Обновлён: 2025-10-20
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/code-explainer

## Что делает

Скилл анализирует исходник и создаёт структурированное объяснение с высокоуровневым обзором, пошаговым разбором и диаграммами. Адаптирует глубину описания под аудиторию: junior получат детали и минимум жаргона, senior — об архитектурных решениях и компромиссах. Внутри — разбор цели кода, ключевых алгоритмов, языковых идиом, зависимостей, подводных камней и best practices.

Скилл работает на Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Устанавливается через `npx skills add` с указанием платформы — команда разная для каждой среды. После установки доступен внутри IDE для выделенного фрагмента или файла.

Объяснения включают реальные аналогии (концертный браслет для JWT, одностороннее зеркало для хеширования), схемы потоков данных, примеры казусов (timing attack, email enumeration) и ссылки на документацию. Полезен для code review, документирования архитектуры и передачи знаний в команде.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add CuriousLearner/devkit --skill code-explainer -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add CuriousLearner/devkit --skill code-explainer -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add CuriousLearner/devkit --skill code-explainer -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install CuriousLearner/devkit skills/code-explainer
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add CuriousLearner/devkit --skill code-explainer -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/CuriousLearner/devkit --path skills/code-explainer
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add CuriousLearner/devkit --skill code-explainer -a opencode
```

### Claude.ai

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

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

## Когда брать
- разобраться в незнакомом коде без долгого погружения
- объяснить сложный код junior-разработчику или новому члену команды
- найти потенциальные проблемы безопасности и performance в существующем коде
- вспомнить, почему код был написан именно так, при code review
- документировать архитектурные решения и паттерны для команды

## Примеры запросов агенту
- Выдели функцию `login()` и напроси: «Объясни этот код для junior-разработчика»
- Отправь весь файл `AuthService.js` скиллу с просьбой: «Разбери этот модуль, укажи security implications»
- Попроси: «Покажи пошагово, как работает этот алгоритм, и нарисуй диаграмму»

## Похожие
- [explain](https://affpapa.org/nevibecode/commands/explain.md) — команда · ★ 23950 у репозитория
- [ce-explain](https://affpapa.org/nevibecode/skills/ce-explain.md) — скилл · 1100 установок
- [spec-miner](https://affpapa.org/nevibecode/skills/spec-miner.md) — скилл · 4900 установок
- [code-documentation-code-explain](https://affpapa.org/nevibecode/skills/code-documentation-code-explain.md) — скилл · 1000 установок
- [codebase-documenter](https://affpapa.org/nevibecode/skills/mhattingpete-codebase-documenter.md) — скилл · 595 установок
- [codebase-onboarding](https://affpapa.org/nevibecode/skills/borghei-codebase-onboarding.md) — скилл · 117 установок

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

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

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