К основному содержанию
скилл CX Codex

explain-diff · nicknisi — скилл для Claude Code: объясняет изменения и установка

Скилл explain-diff разбирает diff, PR, ветку или коммит и готовит HTML-документ с контекстом, схемами, разбором кода и тестом. Пригодится, чтобы понять изменение самому или объяснить его команде.

MIT ★ 114 обновлён 2026-08-11

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add nicknisi/claude-plugins
/plugin install essentials@nicknisi
Открыть на GitHub

Что делает explain-diff

Сначала скилл уточняет, какие изменения разбирать: для PR использует gh pr diff и gh pr view, для ветки — git diff, для коммита — git show. Если цель не названа, проверяет рабочее дерево через git diff HEAD, а затем читает затронутые файлы и связанные части системы. Так объяснение учитывает контекст, а не только строки diff.

Результат — один HTML-файл с разделами о фоне изменений, основной идее, пошаговом разборе кода и интерактивным тестом из пяти вопросов. В файл встроены CSS и JavaScript, внешние ресурсы не загружаются, поэтому документ работает офлайн. Он сохраняется за пределами репозитория в /tmp/ и открывается в браузере. На macOS для этого используется open <path>; без доступа к браузеру последний шаг выполнить не получится.

Какие задачи решает

  • разобраться, что меняет PR и зачем
  • проследить изменения от идеи до кода
  • объяснить команде незнакомую ветку
  • проверить понимание коммита с помощью теста

Примеры запросов агенту

  • Подготовь HTML-разбор PR и объясни, какую проблему решают изменения.
  • Разбери текущую ветку относительно основной и создай документ, который поможет новичку понять изменения.
  • Покажи, как устроен этот коммит, и добавь тест для проверки понимания.

Как установить explain-diff

1Через маркетплейс плагинов

/plugin marketplace add nicknisi/claude-plugins
/plugin install essentials@nicknisi

Команда ставит плагин essentials целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add nicknisi/claude-plugins --skill explain-diff -a claude-code

3Вручную: положить файлы

~/.claude/skills/explain-diff/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/explain-diff/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об explain-diff

Как установить explain-diff в Claude Code?

Добавьте маркетплейс командой /plugin marketplace add nicknisi/claude-plugins, затем установите плагин командой /plugin install essentials@nicknisi.

Что делает explain-diff?

Он исследует diff, связанные файлы и контекст системы, а затем создаёт HTML-документ с объяснением изменений, схемами, разбором кода и интерактивным тестом.

Будет ли HTML-документ работать без интернета?

Да. CSS и JavaScript находятся внутри файла, а внешние ресурсы не используются.

Исходный текст

SKILL.md · MIT
---
name: explain-diff
description: >-
  Produce a rich, self-contained HTML explainer for a code change — deep
  background, core intuition with diagrams, a guided code walkthrough, and an
  interactive quiz. Use whenever the user asks to explain or deeply understand
  a diff, PR, branch, or commit — "explain this PR", "walk me through this
  change", "what does this diff actually do", "make an explainer for this
  branch" — or wants a shareable document that teaches someone else what
  changed and why. Output is an HTML file opened in the browser, not a chat
  reply.
---

# Explain Diff

Create a rich, interactive HTML explanation of a code change. The reader may be a teammate encountering the codebase for the first time or the author checking their own understanding — the document should serve both.

## Resolve the change

Pin down exactly what to explain before writing anything:

- **PR number or URL** — `gh pr diff <number>` for the diff, `gh pr view <number>` for the title, description, and discussion
- **Branch** — `git diff <base>...<branch>` against the repo's default branch
- **Commit** — `git show <sha>`
- **Nothing specified** — the working tree (`git diff HEAD`); if clean, the current branch against the default branch

Then explore beyond the diff: read the touched files in full, their callers, and the subsystem they belong to. The Background section lives or dies on your understanding of the surrounding system, not just the delta.

## Sections

The explanation has four sections, in this order:

1. **Background** — Explain the existing system this change slots into. The reader's familiarity is unknown, so layer it: a deep background for beginners (marked as skippable for readers who already know the system), then a narrower background directly relevant to the change.

2. **Intuition** — Explain the core idea of the change: what problem existed, what insight the change embodies, why this approach. Focus on the essence, not the full details. Use concrete examples with toy data, and use figures and diagrams liberally.

3. **Code** — A high-level walkthrough of the changes. Group and order them for understanding — by concept or data flow — not by file order in the diff.

4. **Quiz** — Five interactive multiple-choice questions testing whether the reader understood the substance. Medium difficulty: answerable only by someone who actually understood the change, but no gotchas. On click, reveal whether the answer was correct with a short explanation either way — the feedback is where the learning happens.

## Output format

Produce a single self-contained HTML file:

- All CSS and JavaScript inline, no external requests (CDNs, fonts, images) — the file is opened locally and must work offline.
- One long page with section headers and a table of contents. Don't use tabs for the top-level structure.
- Basic responsive styling so it reads well on a phone.
- Save it outside the repo so it stays out of version control, with the filename starting with today's date so the files stay time-sorted: `/tmp/YYYY-MM-DD-explanation-<slug>.html`.
- When done, open it in the browser (`open <path>` on macOS) and tell the user the path.

## Writing style

Write with the clarity and flow of Martin Kleppmann — engaging, classic style, with smooth transitions between sections. Use callouts for key concepts, definitions, and important edge cases.

## Diagrams

- Pick a small number of diagram families and reuse them throughout to explain different cases — a repeated visual form makes each new instance easier to parse. Useful families:
  - A simplified version of the UI the user sees in the app, for explaining UI changes.
  - A system diagram showing data flow or communication between components — always populated with example data.
- Build diagrams from simple HTML and CSS, and lists from HTML lists. Never use ASCII art — it breaks under responsive layouts and proportional fonts.
- Use `<pre>` tags for code blocks. If a custom-styled div is used instead, its CSS **must** include `white-space: pre` or `pre-wrap`, or the browser will collapse every newline into a single line. Before saving the file, scan each code block in the HTML source and confirm its whitespace handling.

© Nick Nisi · MIT · nicknisi/claude-plugins

Похожие скиллы

Все скиллы по теме «Git и GitHub» →

Сначала — explain-diff от других авторов.

explain-diff claesbackman Скилл explain-diff превращает разбор изменений кода в автономную HTML-страницу с викториной. Он пригодится, когда нужно объяснить diff и проверить, как он влияет на эмпирические результаты. CX Codex +1 ★ 579звёзд репо tasks-explain-diff makenotion Скилл tasks-explain-diff оформляет разбор правок кода в виде подробной страницы Notion со схемами, описанием логики и шагами проверки. Пригодится при передаче задачи коллегам. CX Codex +1 ★ 40звёзд репо understand-diff Egonex-AI Скилл understand-diff сопоставляет изменения в Git с графом знаний проекта, чтобы оценить затронутые компоненты и радиус поломки. Пригодится перед ревью пуллреквестов. CX Codex +1 4 200установок diff-analyze ruvnet Скилл diff-analyze анализирует git-дифф перед PR: оценивает риск, классифицирует изменения и предлагает роли ревьюеров. Нужен перед слиянием крупных правок. CX Codex +1 753установок security-diff-scan официальный OpenAI Скилл security-diff-scan для Codex проверяет пул-реквесты, коммиты и патчи на уязвимости. Агент анализирует изменённые файлы и связанные участки кода для выявления угроз. CX Codex GP ChatGPT +1 30установок diff-context Barnett-Studios Скилл diff-context собирает git-дифф вместе с контекстом зависимостей через утилиту cxpak. Он помогает ассистенту подготовить описание PR или провести ревью кода с учётом импортов и типов. CX Codex +1 ★ 34звёзд репо diff-computation microsoft Правило diff-computation задаёт порядок код-ревью: сначала вычисляет дифф, затем читает файлы. Находки ограничены изменёнными строками, большие патчи читаются порциями. CX Codex +1 ★ 1 627звёзд репо

Из того же набора18

Весь набор →
handoff Скилл handoff сворачивает текущую сессию в короткий документ-передачу, чтобы следующий агент продолжил незаконченную работу без восстановления контекста. CX Codex +1 ★ 114звёзд репо squad-review Скилл squad-review запускает шесть параллельных проверок ветки с опровержением каждой находки отдельным верификатором перед показом отчёта. CX Codex +1 ★ 114звёзд репо socratic-tutor Скилл socratic-tutor превращает разбор кода в проверку понимания: сначала просит пересказать изменения, затем задаёт вопросы по проблеме, решению и последствиям. CX Codex +1 ★ 114звёзд репо thermo-nuclear-code-quality-review Субагент thermo-nuclear-code-quality-review проводит предельно строгий аудит архитектуры ветки перед слиянием. Находит запутанную логику, раздутые файлы и возможности для упрощения кода. CX Codex ★ 114звёзд репо code-simplifier Субагент code-simplifier упрощает логику, убирает дублирование и лишние проверки, не ломая публичные интерфейсы и поведение кода. Пригодится при наведении порядка после генерации ИИ. CX Codex ★ 114звёзд репо git-committer Субагент git-committer анализирует изменения, проверяет проект и создаёт коммиты с семантическими сообщениями. Подключайте его, когда хотите передать агенту весь процесс коммита. CX Codex ★ 114звёзд репо tighten-prose Скилл tighten-prose вычищает из готового текста приёмы, по которым читатели узнают ИИ: скопления перегруженных слов, надутую значимость, пустые ссылки на источники. Правит помеченные места, сохраняя голос автора. CX Codex +1 ★ 114звёзд репо blog-post-writer Скилл blog-post-writer превращает разрозненные заметки, логи и коммиты в сухой черновик статьи с подтверждёнными фактами и заглушками для личных мыслей автора. CX Codex +1 ★ 114звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой