Skip to content
Back to search

html-flow-diagram

SkillWorks with Claude CodeGitHub

Объясняет техническую тему одной 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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/makhnatkin--html-flow-diagram/badge.svg)](/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

i

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
  1. ---
  2. name: html-flow-diagram
  3. description: Объясняет техническую тему одной HTML-схемой — дорожки участников, блоки по типам (шаг, атака, проверка, план, слабое место, итог, пояснение), стрелки с подписями, код и HTTP-примеры внутри блоков, первоисточники под схемой, переключатель темы «Светлая / Тёмная». Проверяет раскладку в headless Chrome и собирает версию без JavaScript для HTML-блока Markdown (`::: html`). Применяй по запросам «объясни схемой», «нарисуй HTML-схему», «объясни через хтмл схему», «схема как для шрифтов», «покажи на схеме, как это работает», «explain with an HTML diagram», «draw an HTML flow diagram», а также когда процесс с несколькими участниками и ветками понятнее на схеме, чем в тексте.
  4. argument-hint: <тема или вопрос>
  5. ---
  6. # HTML-схема
  7. Тема: $ARGUMENTS
  8. Результат — один файл `.html` без внешних ресурсов: переключатель темы, легенда, нумерованные разделы, в каждом сетка с дорожками, блоки, стрелки и строка первоисточников.
  9. Папка скилла — `~/.claude/skills/html-flow-diagram/`:
  10. - `template.html` — каркас: палитры, стили, переключатель темы, легенда, раздел с тремя дорожками, скрипт стрелок;
  11. - `flowdiag` — проверка, снимки, версия без JS и прогон через санитайзер (`flowdiag --help`);
  12. - `example/css-link-color.html` — готовая схема: каскад CSS и атака через `:visited`.
  13. ## Когда применять
  14. - Процесс с несколькими участниками: браузер, сервер, хранилище.
  15. - Ветки «да / нет», ошибки и отказы.
  16. - Атаки и защиты: где проверка работает, где слабое место, что в плане.
  17. ## Порядок работы
  18. 1. **Факты.** Собрать факты до разметки. У каждого основание: `файл:строка`, ссылка на спецификацию или документацию, команда и её вывод. Непроверенное идёт в блок с текстом «Предположение: …».
  19. 2. **Файл.** Скопировать `template.html` к материалам задачи, без папки задачи — в рабочую папку сессии или `/tmp`. Палитры, стили, переключатель темы и скрипт остаются как в шаблоне; меняются `<title>`, легенда и разделы.
  20. 3. **Разделы.** Один раздел `h2` — один сценарий или вопрос: «1. Как …», «2. Атака: …». Подразделы — `h3` «2.1. …».
  21. 4. **Дорожки.** 2–3 колонки — участники или места действия. Первая строка сетки — заголовки `.lane`. Третья колонка может быть «Пояснения» для блоков `note`. Раздел атаки идёт без дорожек: атака → защита → итог слева направо, как раздел 2 примера.
  22. 5. **Блоки.** Класс задаёт тип:
  23. | Класс | Смысл |
  24. | --- | --- |
  25. | `step` | шаг процесса |
  26. | `atk` | атака, ошибка, внешнее действие |
  27. | `chk` | проверка или защита, которая работает |
  28. | `plan` | запланировано, не сделано |
  29. | `gap` | слабое место, ограничение, отказ |
  30. | `out` | итог ветки |
  31. | `note` | пояснение или пример к соседнему блоку |
  32. У блока есть `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` выравнивает блоки по центру строки. В легенде остаются типы, которые есть на схеме.
  33. 6. **Стрелки.** Атрибут `.dg`: `data-edges="a>b|подпись;b>c"`, в подписи нет `;` и `|`. Скрипт выбирает путь: блоки на одной строке — горизонтальная стрелка, в одной колонке — вертикальная, иначе уголок от бока A к верху или низу B. Уголок проходит по строке A, поэтому клетки между A и колонкой B пустые. Подпись горизонтальной стрелки — одно короткое слово: промежуток между колонками 46 px. Длинная подпись ставится на вертикальную стрелку.
  34. 7. **Источники.** Последний элемент сетки — `.diagram-sources` в строке после блоков: первоисточники ссылками и пометка, какие примеры условные.
  35. 8. **Проверка.** `flowdiag check схема.html` — исправить всё, что он выводит, и повторить до `ok`. Затем `flowdiag shot схема.html` — снимки в светлой и тёмной теме; прочитать оба PNG один раз и исправить видимые дефекты.
  36. ## Текст
  37. - Одна мысль — одна фраза; блок — 1–3 фразы.
  38. - Слово называет действие: «передаёт», «проверяет», «удаляет». Термины полностью: `Content-Security-Policy`.
  39. - Вывод с основанием: `файл:строка`, ссылка или вывод команды — в блоке или в `.diagram-sources`.
  40. - Непроверенное начинается с «Предположение:».
  41. - Условный пример помечен в блоке: «Адрес условный».
  42. - Язык — язык запроса.
  43. ## Тема
  44. Переключатель «Светлая / Тёмная» есть в каждой схеме. Палитры — переменные в `:root` и `:root[data-theme="dark"]`, начальная тема берётся из `prefers-color-scheme`. Новый цвет задаётся переменной в обеих палитрах: так блоки, стрелки, подписи и фон кода меняются вместе с темой. Перед сдачей проверяются снимки обеих тем.
  45. ## Показ
  46. - Файл показывается инструментами `html_preview` и `html_render`, если они есть; иначе — путь к `.html` и PNG.
  47. - Ответ: путь к файлу, по строке на раздел, что отмечено как предположение.
  48. ## Версия без JS для HTML-блока Markdown
  49. HTML-блок `::: html` из `@diplodoc/html-extension` удаляет скрипты, поэтому раскладка и стрелки считаются заранее:
  50. 1. `flowdiag nojs схема.html` → `схема.nojs.html`: фрагмент `<style>` + разметка. Блоки стоят по координатам в px, стрелки — `div` и `span`, ширина 1040 px с горизонтальной прокруткой, шрифты Arial и Courier New.
  51. 2. `flowdiag sanitize схема.nojs.html` → `схема.nojs.sanitized.html`: прогон через санитайзер по умолчанию из `@diplodoc/html-extension` 2.9.7, пакет устанавливается в `~/.cache/flowdiag` при первом запуске. Число блоков, линий, наконечников и подписей до и после совпадает; удаляется только `@media`.
  52. 3. `flowdiag shot схема.nojs.sanitized.html` — снимки обеих тем.
  53. 4. Фрагмент вставляется в HTML-блок страницы (`::: html` … `:::`).
  54. Переключатель темы здесь работает на CSS: две скрытые радиокнопки и `label`, тёмная палитра включается селектором `#fd-dark:checked ~ .theme-root`. Санитайзер удаляет `@media` и `color-scheme`, поэтому версия без JS открывается в светлой теме. После правки исходника экспорт повторяется.
README.md · README · 52 lines
  1. # html-flow-diagram
  2. Скилл Claude Code: объясняет техническую тему одной HTML-схемой. Один файл без внешних ресурсов: дорожки участников, блоки по типам, стрелки с подписями, код и HTTP-примеры внутри блоков, первоисточники под схемой, переключатель «Светлая / Тёмная».
  3. | Светлая тема | Тёмная тема |
  4. | --- | --- |
  5. | ![Пример в светлой теме](docs/css-link-color.light.png) | ![Пример в тёмной теме](docs/css-link-color.dark.png) |
  6. Пример — [example/css-link-color.html](example/css-link-color.html): как браузер выбирает цвет ссылки по каскаду CSS и как он скрывает историю посещений от скриптов.
  7. ## Установка
  8. ```sh
  9. git clone git@github.com:makhnatkin/html-flow-diagram.git
  10. cd html-flow-diagram
  11. ./install.sh # ссылка ~/.claude/skills/html-flow-diagram на эту папку
  12. ```
  13. Для `flowdiag` нужны Python 3.9+ и Chrome или Chromium; путь к браузеру задаёт переменная `CHROME`. Для `flowdiag sanitize` — npm и Node 22.12+, путь задаёт `NODE`.
  14. ## Как работает
  15. Запрос вида «объясни схемой, как …» или «explain with an HTML diagram» вызывает скилл. Модель собирает факты с основаниями, копирует [template.html](template.html), раскладывает блоки по дорожкам, связывает их стрелками, проверяет раскладку через `flowdiag check` и снимки обеих тем через `flowdiag shot`.
  16. ## Разметка
  17. ```html
  18. <div class="dg center" data-edges="a>b|запрос;b>c">
  19. <div class="lane" style="grid-column:1;grid-row:1">Клиент</div>
  20. <div class="bx step" id="a" style="grid-column:1;grid-row:2"><div class="tag">Начало</div>Клиент отправляет запрос.</div>
  21. <div class="bx chk" id="b" style="grid-column:2;grid-row:2"><div class="tag">Проверка</div>Сервер проверяет токен.</div>
  22. <div class="bx out" id="c" style="grid-column:2;grid-row:3"><div class="tag">Итог</div>Ответ 200.</div>
  23. </div>
  24. ```
  25. Типы блоков: `step` — шаг, `atk` — атака или ошибка, `chk` — проверка работает, `plan` — в плане, `gap` — слабое место, `out` — итог, `note` — пояснение. Правила раскладки и текста — в [SKILL.md](SKILL.md).
  26. ## Команды
  27. | Команда | Что делает |
  28. | --- | --- |
  29. | `flowdiag check схема.html` | перекрытия блоков, стрелки через чужие блоки, подписи на блоках, отсутствующие и повторные `id`, переключатель темы |
  30. | `flowdiag shot схема.html` | `схема.light.png` и `схема.dark.png` во всю высоту страницы |
  31. | `flowdiag nojs схема.html` | `схема.nojs.html` для HTML-блока без скриптов: координаты в px, стрелки из `div` и `span`, переключатель темы на CSS |
  32. | `flowdiag sanitize схема.nojs.html` | прогон через санитайзер по умолчанию из `@diplodoc/html-extension` 2.9.7 и сравнение до и после |
  33. ## Файлы
  34. - [SKILL.md](SKILL.md) — инструкция скилла.
  35. - [template.html](template.html) — каркас схемы: палитры, стили, легенда, раздел с тремя дорожками, скрипт стрелок.
  36. - [flowdiag](flowdiag) и [flowdiag.js](flowdiag.js) — команды и код, который они выполняют в headless Chrome.
  37. - [example/](example) — готовая схема.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.