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

explain · sammcj — скилл для Claude Code: что делает и как установить

Скилл explain объясняет архитектуру, работу систем и код через ASCII-схемы в терминале или интерактивные HTML-страницы с анимацией шагов.

Apache-2.0 ★ 173 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add sammcj/agentic-coding --skill explain -a claude-code
Открыть на GitHub

Что делает explain

Скилл переводит разбор кода и концепций в визуальный формат. При стандартном запуске агент рисует вертикальную ASCII-диаграмму шириной до 80 символов и снабжает её короткими пояснениями по правилам упрощённого технического английского (до 20–25 слов на пункт). Если задача касается текущего проекта, агент предварительно открывает код и ссылается на точные места через path:line.

Если запрос начинается со слова html, инструмент генерирует автономную страницу в папке .explain/ со встроенными стилями и скриптами. Для алгоритмов и жизненного цикла запросов строится пошаговый плеер с переключением кнопками или стрелками клавиатуры. Чтобы не засорять репозиторий, каталог .explain/ автоматически прописывается в локальный файл info/exclude, оставляя .gitignore нетронутым.

Если в окружении нет браузерного инструмента для проверки интерфейса, агент не сможет сделать контрольные снимки вьюпорта 1200x800 и открыто сообщит, что вёрстка осталась без визуальной проверки.

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

  • нарисовать ASCII-схему архитектуры прямо в выводе терминала
  • сгенерировать интерактивную HTML-страницу с пошаговым разбором процесса
  • разобрать реализацию компонента с прямыми ссылками на строки path:line
  • сохранить схему в репозитории без изменения файла .gitignore

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

  • /explain архитектура обработки очередей в worker.ts
  • /explain html жизненный цикл входящего HTTP-запроса через middleware
  • /explain

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

1Через Skills CLI (Vercel)

npx skills add sammcj/agentic-coding --skill explain -a claude-code

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

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

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

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

Вопросы об explain

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

Выполните команду npx skills add sammcj/agentic-coding --skill explain -a claude-code. Файл скилла также можно скопировать вручную по пути ~/.claude/skills/explain/SKILL.md.

Чем отличаются режимы terminal и html?

В режиме терминала агент выдаёт текстовую ASCII-схему шириной до 80 символов с пронумерованными пояснениями. В режиме html создаётся отдельная веб-страница со встроенным SVG или Mermaid, поддержкой светлой и тёмной тем и пошаговой анимацией.

Куда сохраняются сгенерированные файлы HTML?

Страницы записываются в каталог .explain/<kebab-slug>.html. Скилл сразу добавляет эту папку в путь $(git rev-parse --git-path info/exclude), поэтому файлы остаются невидимыми для Git без правок в .gitignore.

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

SKILL.md · Apache-2.0
---
name: explain
description: Explain a concept, system or piece of code as a diagram-first terminal answer, or as an interactive HTML page.
disable-model-invocation: true
argument-hint: "[html] <topic>"
compatibility: claude-code
metadata:
  version: 2026-10-05
---

Arguments: `$ARGUMENTS`. If the first word is `html` use HTML mode, unless otherwise instructed use terminal mode. The rest is the topic. With no topic, explain what the conversation is currently about.

## Both modes

- Show the real mechanism: the actual components, data flow and state changes, with real names, shapes and numbers. A labelled box saying "processing" explains nothing.
- Picture first, prose second. Prose is short captions keyed to the picture.
- Captions follow Simplified Technical English: max 20 words per step, 25 per description, active voice, one idea per sentence, plain words with one meaning. Keep code and identifiers verbatim.
- For code in the current project, read it first and cite `path:line`.

## Terminal mode

1. Draw an ASCII diagram, at most 80 columns wide. Stack vertically rather than in one long row.
2. Follow it with numbered captions that use the diagram's labels.

## HTML mode

1. Create a task per step below, then work them to completion.
2. Load the `html-design-examples` skill for visual patterns, if available.
3. Write one self-contained page to `.explain/<kebab-slug>.html` in the working directory: inline CSS and JS, no build step. Reuse the slug when revising the same topic. In a git repo, append `.explain/` to `$(git rev-parse --git-path info/exclude)` if missing, so pages stay untracked without touching `.gitignore`.
4. Put the key picture in the first 1200x800 screen. Detail and depth go below it. Done when a reader gets the core idea without scrolling.
5. Draw diagrams as inline SVG so parts can highlight and animate. For a large flowchart or sequence, Mermaid from `https://cdn.jsdelivr.net/npm/mermaid@latest/dist/mermaid.esm.min.mjs` is fine.
6. For a process (pipeline, algorithm, protocol, request lifecycle), build a step-through: scenes driven by one step index, with prev/next buttons, arrow keys and play/pause. Each scene highlights what changed and shows a one-line caption. Load on the final, fully built scene so the first screen shows the whole picture. Done when buttons, arrow keys and play/pause all move the step index.
7. Add other controls (sliders, toggles, compare views) only where changing a value teaches something.
8. Support light and dark via `prefers-color-scheme`. Text meets WCAG AA contrast.
9. If a browser tool is available, screenshot the first 1200x800 screen in light and dark, and read the console. Fix clipped or overlapping text and any errors. With no browser tool, say the page was not visually checked.
10. Reply with the page path and a 2-3 line summary, leaving the HTML out of the reply.

© sammcj · Apache-2.0 · sammcj/agentic-coding

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

Все скиллы по теме «Тексты и документация» →

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

explain entireio Скилл explain для Claude Code объясняет, зачем появился фрагмент кода. Он связывает функцию, файл или строку с исходной сессией разработки. CX Codex +1 625установок explain SerhiiKorniienko Скилл explain объясняет концепции из кода, документов или статей на нужной глубине: от аналогий для новичка до разбора механизмов для эксперта. CX Codex +1 ★ 164звёзд репо explain Insilico-org Помогает сформулировать проверяемые объяснения исследовательских данных. Он включается, когда plsi research next выбирает ход explain. CX Codex +1 ★ 93звёзд репо explain TakaGoto Скилл explain для Claude Code разбирает понятия RAG от простой аналогии до кода и практических компромиссов. Объясняет эмбеддинги, чанкинг и гибридный поиск. CX Codex +1 ★ 30звёзд репо pretty-mermaid imxv Скилл pretty-mermaid для Claude Code рендерит Mermaid-диаграммы в SVG, PNG или ASCII/Unicode без браузера. Создаёт диаграммы для документации, README и терминалов. CX Codex +1 4 700установок mermaid-studio Felipe Rodrigues - github.com/felipfr Скилл mermaid-studio для Claude Code и других платформ: создаёт диаграммы Mermaid, проверяет синтаксис и рендерит в SVG, PNG или ASCII. Покрывает архитектуру систем и схемы баз данных. CX Codex +1 344установок Agentic Mermaid adewale MCP-сервер Agentic Mermaid рендерит диаграммы Mermaid в форматах SVG, PNG или ASCII и даёт агентам типизированные операции для точной правки графов без переписывания исходника. CX Codex +1 ★ 72звёзд репо diagram-design cathrynlavery Скилл diagram-design для Claude Code генерирует архитектурные схемы и графику в виде автономных HTML-файлов с инлайновым SVG. Создаёт 51 тип визуализаций с единым стайлгайдом проекта. CX Codex +1 30 900установок dashmotion csthink Скилл dashmotion для Claude Code генерирует тёмные анимированные SVG-диаграммы в одном HTML-файле. Визуализирует архитектуру и процессы светящимися точками запросов и бегущими линиями. CX Codex +1 ★ 205звёзд репо beautiful-mermaid intellectronica Рендерит диаграммы Mermaid в SVG и PNG через библиотеку Beautiful Mermaid. Визуализирует архитектуру, базы данных и рабочие процессы. CX Codex +1 1 900установок

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

Весь набор →
openspeccer Скилл openspeccer открывает локальный дашборд OpenSpec и показывает активные изменения, их артефакты и задачи. Подходит для просмотра статуса проекта. CX Codex +1 ★ 173звёзд репо json-schema-lookup Скилл json-schema-lookup учит агента искать схемы конфигов популярных проектов в каталоге SchemaStore и проверять по ним структуру файлов. CX Codex +1 ★ 173звёзд репо deferred-task-execution Скилл deferred-task-execution для Claude Code откладывает запуск команд на заданный интервал или точное время. Запускает тесты или деплой позже. CX Codex +1 ★ 173звёзд репо compression-editor Субагент compression-editor для Claude Code сжимает прозу, инструкции, скиллы и документацию без потери смысла. Исходный код он не обрабатывает и не делает саммари. CX Codex ★ 173звёзд репо openspec-bootstrap Скилл openspec-bootstrap настраивает OpenSpec в репозитории: создаёт схему, конфигурацию и проверяет их. Нужен при первом запуске или изменении openspec/config.yaml. CX Codex +1 ★ 173звёзд репо self-review Скилл self-review запускает критическую самопроверку изменений. Подходит и для мелких правок, и для делегирования ревью субагенту. CX Codex +1 ★ 173звёзд репо writing-fragments Скилл writing-fragments для Claude Code собирает из беседы фрагменты будущей статьи и сохраняет их в одном Markdown-файле. CX Codex +1 ★ 173звёзд репо code-simplification Скилл code-simplification для Claude Code находит сложные участки и помогает упростить код при ревью и рефакторинге. Он подключается к задачам на читаемость и сокращение лишних абстракций. CX Codex +1 ★ 173звёзд репо

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

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