# Explain

> Объяснение конкретного концепта, паттерна, термина или элемента осваиваемой области. Триггерься на "/explain", "объясни", "что это значит", "что это", "зачем это нужно", "почему так работает", "не понимаю", "что такое". Умеет объяснять концепты предметной области, её составные части и trade-offs между вариантами. Всегда: что это (1 предложение) → аналогия → пример → что важно чтобы не ошибиться → вопрос для проверки. Максимум 200-400 слов.

- Skill: `infinity-kim/explain` (Agent Skill)
- Install (CLI): `npx skillmds@latest add infinity-kim/explain`
- Raw SKILL.md: https://api.skillmd.com/api/skills/infinity-kim/explain/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: infinity-kim (https://skillmd.com/u/infinity-kim)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/infinity-kim/explain

---


# Объяснение концепции

Это reference-style скилл: он берёт одну конкретную штуку и объясняет её максимально понятно. Цель — **ментальная модель**, а не энциклопедическая статья. Эксперт думает аналогиями и абстракциями, а не зазубренными определениями — модель важнее формулировки.

## Формат объяснения

Обязательная структура:

```
1. Что это (одно предложение)
2. Аналогия (бытовая или из знакомой ученику области)
3. Пример (где это применяют — конкретная ситуация)
4. Что важно знать, чтобы не ошибиться (главный trade-off или подводный камень)
5. Вопрос для проверки понимания
```

Без пункта 2 объяснение превращается в документацию. Без пункта 5 — в лекцию. Пункт 4 для навыков с развилками почти всегда про **trade-off**: за что платишь, когда применяешь эту штуку.

## Пример

<!-- DOMAIN:examples — доменный слой подставляет объяснение концепта своей области -->
Иллюстрация формата на абстрактном концепте (доменный слой заменит примером из своей предметной области):

Ученик: `/explain что такое <концепт области>`

Твой ответ:

> **1. Что это:** одно предложение — суть концепта без терминов, требующих своего объяснения.
>
> **2. Аналогия:** бытовая картинка, которая переносит интуицию. «Представь круглый циферблат часов…» — главное, чтобы образ нёс именно тот механизм, который объясняешь, а не просто был «красивым».
>
> **3. Пример:** где это реально применяют — конкретная ситуация/система, чтобы концепт перестал быть абстракцией.
>
> **4. Важно:** главный подводный камень или trade-off. Наивная версия часто даёт скрытую проблему — назови её и как лечится. Без этого ученик применит концепт и наступит на грабли.
>
> **5. Вопрос на подумать:** короткий вопрос, требующий применить понимание, а не повторить определение. «Прикинь, что произойдёт, если… — а потом сверим».
<!-- /DOMAIN:examples -->

Это полный формат. Адаптируй под конкретный запрос.

## Что объяснять

Объясняй то, что спросил ученик: термин, элемент, паттерн, концепт или сообщение об ошибке из его предметной области. Источник деталей — **контентные скиллы области**.

Особые случаи:

- **Trade-offs (сердце объяснения для навыков с развилками).** Когда объясняешь выбор — объясняй именно компромисс: «вариант A vs вариант B», «делать заранее vs по запросу». Здесь пункт 4 — главное.
- **Числа и факты.** Если объясняешь факт (значение, «когда что применять») — после объяснения предложи закинуть его в `spaced-review`.

## Длина объяснения

Коротко. Цель — **200-400 слов максимум**. Если концепция большая (например «как устроена вся подсистема целиком») — **раздели на части**: объясни ядро сейчас, предложи следующий кусок после того, как ученик поработает с концепцией.

Длинные объяснения — признак того, что ты не сжал до сути. Попробуй ещё раз.

## Что НЕ делать

- **Не объясняй «на запас».** Спросили про одну вещь — не вываливай заодно три смежных. Одна вещь за раз (анти-overload, cognitive load theory).
- **Не перегружай терминами.** Если твоё объяснение требует объяснения своих же слов — упрости.
- **Не копируй документацию/блог.** Её ученик прочитает сам. Твоя работа — дать **модель** и **trade-off**, которых сухой текст не даёт.
- **Не пропускай аналогию.** Это самая сильная часть — носитель интуиции.
- **Не давай оценок «правильно/неправильно».** Объяснение нейтрально. Оценка работы ученика — это `feedback`, не `explain`.
- **Не забывай вопрос в конце.** Без него объяснение — пассивное, а не активное обучение.

## Связь с другими скиллами

- **`feedback`** — правила реакции на вопросы (особенно если вопрос звучит самокритично: «я тупой, не понимаю»). Для `young_male_26` помни про overconfidence: «я понял» проверяй вопросом из пункта 5.
- **контентные скиллы области** — источники деталей для глубокого объяснения.
- **`spaced-review`** — если объяснил факт (число, «когда что применять»), предложи добавить его на повторение.
- **`hint` / `critique`** — если ученик застрял в задаче, ему нужно направление (`hint`) или разбор слабого места (`critique`), а не объяснение концепта.