html-flow-diagram
Объясняет техническую тему одной HTML-схемой — дорожки участников, блоки по типам (шаг, атака, проверка, план, слабое место, итог, пояснение), стрелки с подписями, код и HTTP-примеры внутри блоков, первоисточники под схемой, переключатель темы «Светлая / Тёмная». Проверяет раскладку в headless Chrome и собирает версию без JavaScript для HTML-блока Markdown (`::: html`). Применяй по запросам «объясни схемой», «нарисуй HTML-схему», «объясни через хтмл схему», «схема как для шрифтов», «покажи на схеме, как это работает», «explain with an HTML diagram», «draw an HTML flow diagram», а также когда процесс с несколькими участниками и ветками понятнее на схеме, чем в тексте.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/makhnatkin--html-flow-diagram)HTML
<a href="/listings/makhnatkin--html-flow-diagram"><img src="/api/listings/makhnatkin--html-flow-diagram/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
git clone git@github.com:makhnatkin/html-flow-diagram.git cd html-flow-diagram ./install.sh # ссылка ~/.claude/skills/html-flow-diagram на эту папку
Для `flowdiag` нужны Python 3.9+ и Chrome или Chromium; путь к браузеру задаёт переменная `CHROME`. Для `flowdiag sanitize` — npm и Node 22.12+, путь задаёт `NODE`.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 74 lines
- ---
- name: html-flow-diagram
- description: Объясняет техническую тему одной HTML-схемой — дорожки участников, блоки по типам (шаг, атака, проверка, план, слабое место, итог, пояснение), стрелки с подписями, код и HTTP-примеры внутри блоков, первоисточники под схемой, переключатель темы «Светлая / Тёмная». Проверяет раскладку в headless Chrome и собирает версию без JavaScript для HTML-блока Markdown (`::: html`). Применяй по запросам «объясни схемой», «нарисуй HTML-схему», «объясни через хтмл схему», «схема как для шрифтов», «покажи на схеме, как это работает», «explain with an HTML diagram», «draw an HTML flow diagram», а также когда процесс с несколькими участниками и ветками понятнее на схеме, чем в тексте.
- argument-hint: <тема или вопрос>
- ---
- # HTML-схема
- Тема: $ARGUMENTS
- Результат — один файл `.html` без внешних ресурсов: переключатель темы, легенда, нумерованные разделы, в каждом сетка с дорожками, блоки, стрелки и строка первоисточников.
- Папка скилла — `~/.claude/skills/html-flow-diagram/`:
- - `template.html` — каркас: палитры, стили, переключатель темы, легенда, раздел с тремя дорожками, скрипт стрелок;
- - `flowdiag` — проверка, снимки, версия без JS и прогон через санитайзер (`flowdiag --help`);
- - `example/css-link-color.html` — готовая схема: каскад CSS и атака через `:visited`.
- ## Когда применять
- - Процесс с несколькими участниками: браузер, сервер, хранилище.
- - Ветки «да / нет», ошибки и отказы.
- - Атаки и защиты: где проверка работает, где слабое место, что в плане.
- ## Порядок работы
- 1. **Факты.** Собрать факты до разметки. У каждого основание: `файл:строка`, ссылка на спецификацию или документацию, команда и её вывод. Непроверенное идёт в блок с текстом «Предположение: …».
- 2. **Файл.** Скопировать `template.html` к материалам задачи, без папки задачи — в рабочую папку сессии или `/tmp`. Палитры, стили, переключатель темы и скрипт остаются как в шаблоне; меняются `<title>`, легенда и разделы.
- 3. **Разделы.** Один раздел `h2` — один сценарий или вопрос: «1. Как …», «2. Атака: …». Подразделы — `h3` «2.1. …».
- 4. **Дорожки.** 2–3 колонки — участники или места действия. Первая строка сетки — заголовки `.lane`. Третья колонка может быть «Пояснения» для блоков `note`. Раздел атаки идёт без дорожек: атака → защита → итог слева направо, как раздел 2 примера.
- 5. **Блоки.** Класс задаёт тип:
- | Класс | Смысл |
- | --- | --- |
- | `step` | шаг процесса |
- | `atk` | атака, ошибка, внешнее действие |
- | `chk` | проверка или защита, которая работает |
- | `plan` | запланировано, не сделано |
- | `gap` | слабое место, ограничение, отказ |
- | `out` | итог ветки |
- | `note` | пояснение или пример к соседнему блоку |
- У блока есть `id`, явные `grid-column` и `grid-row`, заголовок `.tag` вида «Что · где» и 1–3 фразы. Код и HTTP — в `<pre><code>`, символы `<`, `>`, `&`, `"` экранируются. Широкий блок — `grid-column: 2 / 4`, высокий — `grid-row: 3 / span 2`. Ссылка на другой блок — `<a href="#id">`. Класс `center` у `.dg` выравнивает блоки по центру строки. В легенде остаются типы, которые есть на схеме.
- 6. **Стрелки.** Атрибут `.dg`: `data-edges="a>b|подпись;b>c"`, в подписи нет `;` и `|`. Скрипт выбирает путь: блоки на одной строке — горизонтальная стрелка, в одной колонке — вертикальная, иначе уголок от бока A к верху или низу B. Уголок проходит по строке A, поэтому клетки между A и колонкой B пустые. Подпись горизонтальной стрелки — одно короткое слово: промежуток между колонками 46 px. Длинная подпись ставится на вертикальную стрелку.
- 7. **Источники.** Последний элемент сетки — `.diagram-sources` в строке после блоков: первоисточники ссылками и пометка, какие примеры условные.
- 8. **Проверка.** `flowdiag check схема.html` — исправить всё, что он выводит, и повторить до `ok`. Затем `flowdiag shot схема.html` — снимки в светлой и тёмной теме; прочитать оба PNG один раз и исправить видимые дефекты.
- ## Текст
- - Одна мысль — одна фраза; блок — 1–3 фразы.
- - Слово называет действие: «передаёт», «проверяет», «удаляет». Термины полностью: `Content-Security-Policy`.
- - Вывод с основанием: `файл:строка`, ссылка или вывод команды — в блоке или в `.diagram-sources`.
- - Непроверенное начинается с «Предположение:».
- - Условный пример помечен в блоке: «Адрес условный».
- - Язык — язык запроса.
- ## Тема
- Переключатель «Светлая / Тёмная» есть в каждой схеме. Палитры — переменные в `:root` и `:root[data-theme="dark"]`, начальная тема берётся из `prefers-color-scheme`. Новый цвет задаётся переменной в обеих палитрах: так блоки, стрелки, подписи и фон кода меняются вместе с темой. Перед сдачей проверяются снимки обеих тем.
- ## Показ
- - Файл показывается инструментами `html_preview` и `html_render`, если они есть; иначе — путь к `.html` и PNG.
- - Ответ: путь к файлу, по строке на раздел, что отмечено как предположение.
- ## Версия без JS для HTML-блока Markdown
- HTML-блок `::: html` из `@diplodoc/html-extension` удаляет скрипты, поэтому раскладка и стрелки считаются заранее:
- 1. `flowdiag nojs схема.html` → `схема.nojs.html`: фрагмент `<style>` + разметка. Блоки стоят по координатам в px, стрелки — `div` и `span`, ширина 1040 px с горизонтальной прокруткой, шрифты Arial и Courier New.
- 2. `flowdiag sanitize схема.nojs.html` → `схема.nojs.sanitized.html`: прогон через санитайзер по умолчанию из `@diplodoc/html-extension` 2.9.7, пакет устанавливается в `~/.cache/flowdiag` при первом запуске. Число блоков, линий, наконечников и подписей до и после совпадает; удаляется только `@media`.
- 3. `flowdiag shot схема.nojs.sanitized.html` — снимки обеих тем.
- 4. Фрагмент вставляется в HTML-блок страницы (`::: html` … `:::`).
- Переключатель темы здесь работает на CSS: две скрытые радиокнопки и `label`, тёмная палитра включается селектором `#fd-dark:checked ~ .theme-root`. Санитайзер удаляет `@media` и `color-scheme`, поэтому версия без JS открывается в светлой теме. После правки исходника экспорт повторяется.
README.md · README · 52 lines
- # html-flow-diagram
- Скилл Claude Code: объясняет техническую тему одной HTML-схемой. Один файл без внешних ресурсов: дорожки участников, блоки по типам, стрелки с подписями, код и HTTP-примеры внутри блоков, первоисточники под схемой, переключатель «Светлая / Тёмная».
- | Светлая тема | Тёмная тема |
- | --- | --- |
- |  |  |
- Пример — [example/css-link-color.html](example/css-link-color.html): как браузер выбирает цвет ссылки по каскаду CSS и как он скрывает историю посещений от скриптов.
- ## Установка
- ```sh
- git clone git@github.com:makhnatkin/html-flow-diagram.git
- cd html-flow-diagram
- ./install.sh # ссылка ~/.claude/skills/html-flow-diagram на эту папку
- ```
- Для `flowdiag` нужны Python 3.9+ и Chrome или Chromium; путь к браузеру задаёт переменная `CHROME`. Для `flowdiag sanitize` — npm и Node 22.12+, путь задаёт `NODE`.
- ## Как работает
- Запрос вида «объясни схемой, как …» или «explain with an HTML diagram» вызывает скилл. Модель собирает факты с основаниями, копирует [template.html](template.html), раскладывает блоки по дорожкам, связывает их стрелками, проверяет раскладку через `flowdiag check` и снимки обеих тем через `flowdiag shot`.
- ## Разметка
- ```html
- <div class="dg center" data-edges="a>b|запрос;b>c">
- <div class="lane" style="grid-column:1;grid-row:1">Клиент</div>
- <div class="bx step" id="a" style="grid-column:1;grid-row:2"><div class="tag">Начало</div>Клиент отправляет запрос.</div>
- <div class="bx chk" id="b" style="grid-column:2;grid-row:2"><div class="tag">Проверка</div>Сервер проверяет токен.</div>
- <div class="bx out" id="c" style="grid-column:2;grid-row:3"><div class="tag">Итог</div>Ответ 200.</div>
- </div>
- ```
- Типы блоков: `step` — шаг, `atk` — атака или ошибка, `chk` — проверка работает, `plan` — в плане, `gap` — слабое место, `out` — итог, `note` — пояснение. Правила раскладки и текста — в [SKILL.md](SKILL.md).
- ## Команды
- | Команда | Что делает |
- | --- | --- |
- | `flowdiag check схема.html` | перекрытия блоков, стрелки через чужие блоки, подписи на блоках, отсутствующие и повторные `id`, переключатель темы |
- | `flowdiag shot схема.html` | `схема.light.png` и `схема.dark.png` во всю высоту страницы |
- | `flowdiag nojs схема.html` | `схема.nojs.html` для HTML-блока без скриптов: координаты в px, стрелки из `div` и `span`, переключатель темы на CSS |
- | `flowdiag sanitize схема.nojs.html` | прогон через санитайзер по умолчанию из `@diplodoc/html-extension` 2.9.7 и сравнение до и после |
- ## Файлы
- - [SKILL.md](SKILL.md) — инструкция скилла.
- - [template.html](template.html) — каркас схемы: палитры, стили, легенда, раздел с тремя дорожками, скрипт стрелок.
- - [flowdiag](flowdiag) и [flowdiag.js](flowdiag.js) — команды и код, который они выполняют в headless Chrome.
- - [example/](example) — готовая схема.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.