# Explain Complex Code

> Навык объяснять сложный код простым языком. Активируется только по запросу: объясни, разбери, что тут, как работает, eli5.

- **Type:** Skill
- **Install:** `agentstack add skill-kissrosecicd-hub-agents-evolution-explain-complex-code`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [kissrosecicd-hub](https://agentstack.voostack.com/s/kissrosecicd-hub)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [kissrosecicd-hub](https://github.com/kissrosecicd-hub)
- **Source:** https://github.com/kissrosecicd-hub/agents-evolution/tree/main/.agents/skills/explain-complex-code

## Install

```sh
agentstack add skill-kissrosecicd-hub-agents-evolution-explain-complex-code
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Explain Complex Code

Навык объяснять сложный код простым языком. Активируется **только по запросу** пользователя.

## Триггеры

Пользователь говорит:
- «объясни [код/функцию/файл/это]»
- «что тут происходит»
- «разбери» / «разложи»
- «explain» / «walk me through»
- «как это работает»
- «не понимаю этот кусок»
- «объясни как новичку»
- «eli5» / «explain like I'm 5»

## Формат ответа

**Всегда соблюдай структуру:**

```
TL;DR (1-2 строки) → суть без деталей
Аналогия из реального мира → привязка к знакомому
Структура/архитектура → как организовано
Ключевые механизмы → что важно
Поток выполнения → что за чем происходит
Подводные камни → баги, риски, edge cases
```

Если код короткий — сократи до TL;DR + аналогия + 1 абзац.
Если код длинный — добавь все секции.

## Правила

### Обязательные

1. **TL;DR всегда первым.** 1-2 строки. Без TL;DR — ответ провален.
2. **Аналогия из реального мира.** Не абстрактная. Физический объект, бытовая ситуация, профессия.
3. **Термин = мгновенное пояснение.** Нельзя написать «использует debounce» без «(задержка чтобы не дёргать на каждый чих)».
4. **Код — в code block.** Объяснение — вокруг кода, не внутри.
5. **Архитектура — диаграмма текстом.** Стрелки, отступы, ASCII. Не «ну ты понял».

### Запрещённые

1. ❌ «Ну это просто...» — для просящего это НЕ просто
2. ❌ «Очевидно что...» — ничего не очевидно
3. ❌ «Как вы знаете...» — не предполагаешь уровень
4. ❌ Ссылка на документацию вместо объяснения
5. ❌ Пересказ кода строчка-за-строчкой без контекста ЗАЧЕМ

## Уровни детализации

Используй `gradual.md` когда:
- Пользователь просит «объясни постепенно» / «от простого»
- Код очень сложный (500+ строк, много абстракций)
- Пользователь явно новичок

Используй `eli5.md` когда:
- Пользователь говорит «объясни как ребёнку» / «eli5» / «на пальцах»
- Нужно убрать весь жаргон
- Объясняешь концепцию, не детали реализации

Используй `feynman.md` когда:
- Пользователь просит «разбери по шагам» / «как это работает внутри»
- Нужно понять механизм, не просто «что делает»
- Готовишься к собеседованию или code review

## Контрольный вопрос

После объяснения **всегда** заканчивай:

> Нужно разобрать какой-то кусок глубже?

Если пользователь сказал «да» — бери `feynman.md` или `gradual.md` в зависимости от контекста.

## Адаптация под язык

Отвечай на языке пользователя. Если код на русском — объяснение на русском. Если на английском — на английском. Термины и код не переводить.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [kissrosecicd-hub](https://github.com/kissrosecicd-hub)
- **Source:** [kissrosecicd-hub/agents-evolution](https://github.com/kissrosecicd-hub/agents-evolution)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-kissrosecicd-hub-agents-evolution-explain-complex-code
- Seller: https://agentstack.voostack.com/s/kissrosecicd-hub
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.