` вместо `{{ЗАГОЛОВОК}}`. 2. В `<style id="design">` напиши авторский CSS под арт-дирекшн: палитра (`:root`), `body`/`#bg`, типографика (системные стеки ИЛИ вшитый base64 OSS-шрифт по согласию — рецепт в `cookbook.md`), компоненты, раскладки. Сверься с контрактом классов в `cookbook.md` — компоненты, которые оживляет kernel, обязаны получить свой CSS/keyframes (особенно `@keyframes gitin` для `.clist`). 3. В `#deck` уложи спроектированные слайды: одна мысль — один слайд, короткие заголовки, числа → `.count`, у КАЖДОГО `<section>` — `data-notes` с дословной речью (ремарки в `[скобках]`). Первый слайд — с классом `active`. Каждый слайд верстается под ЕГО мысль: kernel не требует никакой «типовой» структуры слайда, и многие слайды — просто крупная типографика или своя раскладка без именованных компонентов. Классы из контракта (`cookbook.md`) бери только тогда, когда мысль слайда действительно требует счётчика, каскада или схемы-процесса, — и помни, что дорогая анимация уместна один-два раза на всю деку. Композиция слайдов должна меняться по ходу деки (ось 1): три подряд одинаковых силуэта — брак. 4. **Медиа** (умный дефолт): лёгкое (< ~800 КБ) → inline base64 (дека остаётся одним офлайн-файлом); тяжёлое (> ~800 КБ, крупные GIF/видео) → sidecar-папка `deck/deck-assets/` (относительная ссылка `deck-assets/…`) + **предупреди**, что дека больше не один файл и ездит только вместе со своей папкой. Исходные картинки из рабочей папки при этом не трогай — копируй, а не перемещай. 4б. **Интерактив** (если он в плане). Свой JS — в отдельный блок `<script id="interactive">` ПОСЛЕ `<script id="kernel">`, перед закрывающим `</body>`; kernel по-прежнему не трогаешь. ⚠️ Вставляешь скриптом — матчь ПОСЛЕДНЕЕ вхождение (`rfind`/`rsplit`): первое лежит внутри kernel, в строке, которая собирает presenter-окно, и вставка туда ломает движок. Кликабельные зоны — `<button>` или своя вёрстка с `[data-interactive]`, прокручиваемые — `[data-scroll]`, иначе клик и колесо уйдут в навигацию. Сброс состояния при заходе на слайд, поведение в PDF, работа в presenter-превью, ремарка в `data-notes` — всё это на тебе: полный контракт и сниппеты в `cookbook.md`, раздел «Интерактивность: контракт с kernel». Виджет — один на слайд, и слайд обязан читаться, даже если по нему не нажали. 5. **Сгенерируй файл живых заметок** `<slug>-notes.js` рядом с декой, в той же `deck/`, из data-notes (имя = имя html-файла деки + `-notes.js` — kernel ищет его именно так): ```js window.DECK_NOTES = String.raw` ## 01 · Заголовок слайда Текст заметки… [ремарки в скобках] `; ``` Это и суфлёр для чтения (телефон/бумага), и живой источник: kernel перечитывает файл на лету — правки видны в presenter-окне без пересборки. Ключ секции — номер `NN` (совпадает с номером слайда), заголовок после `·` — для человека. В тексте заметок нельзя использовать бэктик и `${`. `data-notes` в HTML остаются fallback-копией (дека работает и одним файлом). **`<slug>-notes.js` — источник правды после первой генерации.** Пользователь правит заметки прямо в presenter-окне (кнопка «✎ править») и выгружает файл кнопкой «⤓ notes.js» — там могут быть правки, которых нет в `data-notes`. Поэтому при любой пересборке/доводке **сначала прочитай существующий `notes.js`** и перенеси его текст в `data-notes` собираемой деки, а не перезаписывай файл из старых `data-notes`. ## Шаг 5 — Проверка и показ - **Прогони валидатор:** `python3 <каталог скилла>/assets/validate.py <дека>.html` — он проверяет целостность kernel (маркер `KERNEL v6`, base/print-стили, chrome, presenter, правку заметок, экспорт в PDF), остаточные `{{…}}`, сетевые ссылки и локальные ссылки на отсутствующие файлы, синтаксис JS (`node --check` по каждому блоку скрипта — kernel, interactive — и по notes.js), посторонние script-блоки и порядок interactive относительно kernel, интерактив на движке ниже v6, клик, повешенный ATTRIBUTE-обработчиком (`onclick=…`) на не-интерактивный тег, синхронность секций `<slug>-notes.js` со слайдами, наличие `slides.md`/`design.md`/`DECK.md`. Ошибки чини до показа. Одиночную деку быстрого режима валидатор узнаёт сам (лежит не в `deck/`, рядом ни одного файла комплекта) и комплекта с неё не спрашивает. Чего он НЕ ловит: сломанную логику виджета и клики, повешенные через `addEventListener` — их проверяешь руками, следующим пунктом. - **Визуальная самопроверка в Chrome (обязательный шаг).** Деку смотришь ТЫ, а не пользователь: подними локальный сервер в `deck/`, открой вкладку, сними вердикт `?check` и ошибки JS из консоли, войди в режим съёмки, прогони аудитор макета (ОДИН вызов на всю деку) и посмотри кадры глазами. Проверка стоит на двух опорах, обе обязательны: **аудитор** даёт числа (переполнение по эталону 16:9, вылет за кадр, битые картинки, мелкий кегль, обрезанный и наложенный текст, пустые слайды), **кадры** — то, что числами не берётся (контраст, ритм, композиция, «висячие» строки). Что нашёл — чини и переснимай, пока аудитор не замолчит, а кадры не станут чистыми. **Третьим заходом — PDF:** его печатную раскладку не видят ни `?check`, ни аудитор, проверяется он headless-печатью из терминала (`cookbook.md`, п.9) и рендерится через `qlmanage` — тем же движком Quartz, которым его откроет зритель. Точная процедура со сниппетами — в `cookbook.md`, раздел «Визуальная самопроверка в Chrome». Четыре вещи, о которые спотыкаются: **(1)** `file://` расширение не открывает (`Can't interact with browser-internal or unparseable URLs`) — только `python3 -m http.server` из папки `deck/` и `http://127.0.0.1:PORT/…`; **(2)** окно браузера НЕ 16:9 и `resize_window` его не выправляет — переполнение меряй аудитором по эталону `innerWidth/16*9`, а не на глаз по скриншоту; окно с сильно непропорциональным ratio (вне 1.70–1.86) приводится к кадру 16:9 стендом из `cookbook.md`; **(3)** режим съёмки собирается ТОЛЬКО стилем `shotmode` из `cookbook.md`: самодельный `animation:none` снимет каскады и карточки ПУСТЫМИ (design-слой держит их на `opacity:0` до анимации) и оставит копию фона поверх контента — пойдёшь чинить несуществующее; **(4)** `S` и `⌘P` в этом режиме НЕ нажимай — системный диалог печати заблокирует расширение до ручного закрытия; PDF проверяется headless-печатью из терминала (`cookbook.md`, п.9), и это часть проверки, а не забота пользователя: `?check` и аудитор печатную раскладку не видят вовсе. Смотреть страницы — через `qlmanage` (движок Quartz, как у Preview): `pdftoppm` рисует чистым даже тот PDF, который в Preview идёт серыми прямоугольниками. Расширения claude-in-chrome нет / Chrome недоступен → так и скажи и попроси пользователя открыть деку с `?check` и пролистать глазами; молча пропускать проверку нельзя. **Проверку PDF эта ветка не отменяет:** headless-печати не нужны ни расширение, ни живая вкладка — только бинарь Chrome. Нет и его — скажи, что PDF не проверен. - **Интерактив проверяется руками, а не глазами** (если он есть): в открытой вкладке нажми каждый виджет и убедись, что дека при этом НЕ пролистнулась, состояние изменилось видимо, а уход на соседний слайд и возврат оставляют виджет в осмысленном состоянии. Есть поле ввода — напечатай в него «psb» и проверь, что не открылись presenter/блэкаут/печать. Раскрывающийся блок проверь раскрытым на переполнение: раскрой его и прогони аудитор макета (`cookbook.md`, п.5) — он посчитает слайд в раскрытом состоянии. Дека на kernel ниже v6 интерактив не выдержит — движок надо обновить. - **Быстрый режим — проверка короче, но не мельче:** валидатор, `?check`, ошибки консоли, аудитор макета и headless-печать PDF обязательны ЦЕЛИКОМ — аудитор стоит один вызов на всю деку независимо от числа слайдов, экономить на нём нечего. Рационируются только кадры: титул + все слайды, которые пометил аудитор, + два-три самых плотных. Молча пропускать проверку нельзя и здесь. - Ручная проверка (её делает пользователь, не ты): `P` открывает presenter отдельным окном (не вкладкой) и он синхронен, `B` гасит экран, живые заметки подхватываются. - **Быстрый режим на этом заканчивается:** отдай путь к файлу, скажи, что это вся дека целиком (переслать = переслать один файл), и напомни управление. `DECK.md`, `deck/` и проверку раскладки пропусти — их нет. Пункты ниже — полный режим. - **Сгенерируй `DECK.md`** в рабочей папке (не в `deck/`) по `assets/deck-template.md`: режим деки (скрипт/руками), карта слайдов, арт-дирекшн сжато, принятые решения/отступления с «почему», как править. Собирал скриптом — проверь, что скрипт и его исходники лежат в рабочей папке рядом с `DECK.md`. - **Проверь раскладку:** в `deck/` — только HTML, его `notes.js` и (если есть) `deck-assets/`; ничего постороннего туда не попало, а исходники и материалы остались в рабочей папке нетронутыми. - Дека — в `deck/<slug>-<дата>.html`. Открой: `open deck/<файл>` (macOS). Скажи пользователю прямо: чтобы унести доклад — берётся **папка `deck/` целиком** (архив, флешка, другой ноутбук), выбирать файлы не надо. - Напомни управление: `← →`/колесо/свайп — листать, `P` — presenter-окно с заметками (его НЕ шарить, шарить деку), `B` — чёрный экран, `F` — fullscreen, `S` — сохранить деку в PDF. Позиция хранится в `#хэше` — F5 не собьёт слайд. **Правка заметок прямо в presenter-окне — кнопками мышью** (буквенных хоткеев там намеренно нет: в это окно печатают; из клавиш живут только стрелки, `Esc` и `⌘⏎`): «✎ править» или двойной клик по тексту → «✓ применить», «☰ все заметки» — весь текст разом, «↺ откатить» — выбросить свои правки и вернуться к файлу (передумал — плашка вернёт их), «⤓ notes.js» — выгрузить файл в загрузки, «⧉ копировать» — его текст в буфер. Из `file://` браузер писать на диск не умеет, поэтому правки живут черновиком в браузере (переживают F5, индикатор `✎ черновик` в шапке presenter), а на диск переносятся выгруженным файлом — положить его рядом с декой поверх старого, индикатор снова зазеленеет. Всё это объясняет встроенная справка в окне докладчика: кнопка «? справка» (при первом открытии presenter внизу всплывает подсказка про неё) — отдельно расписывать пользователю каждую кнопку не нужно. Альтернатива прежняя: править `<slug>-notes.js` во внешнем редакторе — presenter подхватит за пару секунд (файл главнее черновика; несохранённые правки не пропадут — presenter предложит их вернуть). Пересылать деку можно одним HTML (вшитые заметки-fallback), но выступать — из папки `deck/`, рядом с notes.js. - **Просят PDF** — клавиша `S` в открытой деке (то же и по `⌘P`): kernel замораживает ВСЕ слайды в финальном кадре (счётчики досчитаны, каскады/цепочки/pipeline показаны, печатный текст напечатан, фон разложен по страницам) и открывает диалог печати → выбрать «Сохранить как PDF». Страница 16:9 (13.333×7.5″) без полей, слайд = страница, цвета/фон/картинки печатаются, текст в PDF остаётся текстом. Нюансы, о которых предупреди: sidecar-GIF даёт первый кадр, а дека должна лежать рядом со своей `deck-assets/`; слайд с переполнением обрежется по краю страницы — сперва прогони `?check`; если браузер всё же напечатал белым, включи в диалоге «Фоновая графика». Проверено в Chrome; из Safari результат сверь глазами. Тени в PDF плоские намеренно: размытую тень Chrome пишет растровой маской, которую Preview рисует серым прямоугольником поверх контента, поэтому kernel на время печати меняет её на тонкую обводку того же цвета (на экране всё возвращается). Мины печати целиком — `cookbook.md`, п.9. ## Шаг 6 — Доводка Предложи покрутить: палитру/плотность/движение, трактовку фона, добавить/убрать слайд, тайминги. **Перед любой правкой перечитай `<slug>-notes.js`** — пользователь мог поправить заметки в presenter-окне и выгрузить файл; эти правки переносятся в `data-notes`, а не затираются старым текстом из HTML. Сначала определи режим деки (по `DECK.md` / наличию скрипта сборки): режим «скрипт» → правь ИСХОДНИКИ и пересобирай, готовый HTML руками не трогай, скрипт держи актуальным; режим «руками» → точечный Edit — только в `<style id="design">` и `#deck`, не трогая kernel. Добавил/убрал слайды — перенумеруй секции в `<slug>-notes.js` (он источник правды для заметок; `data-notes` в HTML обнови как fallback). Пересобранная дека кладётся в ту же `deck/` — не плоди копии в рабочей папке и не оставляй в `deck/` старые html/notes от прошлых сборок. **После правок — снова визуальная самопроверка в Chrome** (Шаг 5): аудитор макета гоняется на всю деку целиком (это один вызов), кадры переснимаются для затронутых слайдов, а если менял палитру/типографику/плотность — для всей деки; правка вёрстки вслепую и есть основной источник переполнений. После правок обнови `DECK.md` (карту слайдов и раздел решений), если менял структуру/анимации/тайминги. Есть интерактив — он тоже предмет доводки (что нажимается, насколько крупно, что происходит), и после любой правки его перещёлкивают заново: сломанный виджет валидатор не поймает. В быстром режиме доводка идёт по тому же одному файлу — папку и комплект не заводи, пока пользователь не попросит раскрутку. ## Продолжить работу над готовой декой Дали путь к `*.html` (маркер `KERNEL v` в шапке) и промт, что доделать, — это не новый доклад, а продолжение. **Ничего служебного в деку не вшито и искать нечего: дека сама себе контекст.** Прочитай её: - текст слайдов — секции `<section class="slide">` в `#deck`; - речь спикера — `data-notes` у секций (если рядом лежит `<slug>-notes.js` — он главнее, читай его); - арт-дирекшн — `<style id="design">`: палитра `:root`, типографика, композиционные классы; - версию движка — маркер `KERNEL v` в шапке; рядом может лежать `DECK.md` — тогда он главный источник решений. Дальше — по тому, что просят: - **точечная доводка** («поменяй палитру», «добавь слайд», «перепиши третий») — правишь тот же файл по Шагу 6, режим и раскладку не меняешь; - **раскрутка до доклада** — спроси, где создать рабочую папку, и разверни комплект: восстанови `slides.md` из вёрстки и заметок, добери `design.md` (интервью по Шагу 2 или зафиксируй уже сложившийся арт-дирекшн деки как бриф), перенеси деку в `deck/`, сгенерируй `<slug>-notes.js` из `data-notes`, создай `DECK.md`. Затем обычная доводка. **Движок старый.** Дека собрана на kernel ниже v6, а в неё добавляют интерактив — в старом движке нет guard'ов, и виджет будет драться с навигацией. Скажи это прямо и перенеси слайды с design-слоем в свежий `assets/kernel.html`; без интерактива старую деку трогать незачем. ## Стиль общения - Язык: русский. Кратко между вопросами. - Не выдумывай факты/цифры — бери из материалов или спрашивай. Из сети — только опц. URL-референс и OSS-шрифт по согласию.

# Present > present — беспоук HTML-презентация - Skill: `staspotapov/present` (Agent Skill, multi-file: 5 files) - Install (CLI): `npx skillmds@latest add staspotapov/present` - Raw SKILL.md: https://api.skillmd.com/api/skills/staspotapov/present/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Web & Frontend - Author: StasPotapov (https://skillmd.com/u/staspotapov) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/staspotapov/present --- # present — беспоук HTML-презентация Превращает папку-контекст (или текст/тему) в самодостаточную HTML-деку, **спроектированную под этот контент**. Один файл, открывается офлайн в браузере, листается стрелками и колесом. Заметки спикера — в отдельном presenter-окне и живом файле `-notes.js`: правятся прямо в окне докладчика (`E`) или во внешнем редакторе — и подхватываются на лету; на самой деке их нет. Дека и всё нужное ей для показа живут в отдельной подпапке `deck/` (её можно унести целиком), а в рабочей папке рядом с исходниками — `DECK.md`, манифест деки (карта слайдов, решения, как править). ## Философия (главное) **Ты — дизайнер презентаций, а не заполнитель шаблона.** Прочитай текст слайдов (`slides.md`) и бриф (`design.md`), выбери арт-дирекшн (`assets/art-direction.md`) и собери деку с нуля. Разные доклады → визуально разные деки (структура, палитра, типографика, фон, движение), а не перекрашенный один вид. - **Надёжный движок `assets/kernel.html` (из ассетов ЭТОГО скилла, не из копий во входной папке) копируется ДОСЛОВНО** — навигация/анимации/заметки/экспорт в PDF не ломаются. Весь визуал пиши в его ``, `

\s*\s*

`) — целостность потом подтвердит `assets/validate.py` (Шаг 5). Подставь реальный `` вместо `{{ЗАГОЛОВОК}}`. 2. В `<style id="design">` напиши авторский CSS под арт-дирекшн: палитра (`:root`), `body`/`#bg`, типографика (системные стеки ИЛИ вшитый base64 OSS-шрифт по согласию — рецепт в `cookbook.md`), компоненты, раскладки. Сверься с контрактом классов в `cookbook.md` — компоненты, которые оживляет kernel, обязаны получить свой CSS/keyframes (особенно `@keyframes gitin` для `.clist`). 3. В `#deck` уложи спроектированные слайды: одна мысль — один слайд, короткие заголовки, числа → `.count`, у КАЖДОГО `<section>` — `data-notes` с дословной речью (ремарки в `[скобках]`). Первый слайд — с классом `active`. Каждый слайд верстается под ЕГО мысль: kernel не требует никакой «типовой» структуры слайда, и многие слайды — просто крупная типографика или своя раскладка без именованных компонентов. Классы из контракта (`cookbook.md`) бери только тогда, когда мысль слайда действительно требует счётчика, каскада или схемы-процесса, — и помни, что дорогая анимация уместна один-два раза на всю деку. Композиция слайдов должна меняться по ходу деки (ось 1): три подряд одинаковых силуэта — брак. 4. **Медиа** (умный дефолт): лёгкое (< ~800 КБ) → inline base64 (дека остаётся одним офлайн-файлом); тяжёлое (> ~800 КБ, крупные GIF/видео) → sidecar-папка `deck/deck-assets/` (относительная ссылка `deck-assets/…`) + **предупреди**, что дека больше не один файл и ездит только вместе со своей папкой. Исходные картинки из рабочей папки при этом не трогай — копируй, а не перемещай. 4б. **Интерактив** (если он в плане). Свой JS — в отдельный блок `<script id="interactive">` ПОСЛЕ `<script id="kernel">`, перед закрывающим `</body>`; kernel по-прежнему не трогаешь. ⚠️ Вставляешь скриптом — матчь ПОСЛЕДНЕЕ вхождение (`rfind`/`rsplit`): первое лежит внутри kernel, в строке, которая собирает presenter-окно, и вставка туда ломает движок. Кликабельные зоны — `<button>` или своя вёрстка с `[data-interactive]`, прокручиваемые — `[data-scroll]`, иначе клик и колесо уйдут в навигацию. Сброс состояния при заходе на слайд, поведение в PDF, работа в presenter-превью, ремарка в `data-notes` — всё это на тебе: полный контракт и сниппеты в `cookbook.md`, раздел «Интерактивность: контракт с kernel». Виджет — один на слайд, и слайд обязан читаться, даже если по нему не нажали. 5. **Сгенерируй файл живых заметок** `<slug>-notes.js` рядом с декой, в той же `deck/`, из data-notes (имя = имя html-файла деки + `-notes.js` — kernel ищет его именно так): ```js window.DECK_NOTES = String.raw` ## 01 · Заголовок слайда Текст заметки… [ремарки в скобках] `; ``` Это и суфлёр для чтения (телефон/бумага), и живой источник: kernel перечитывает файл на лету — правки видны в presenter-окне без пересборки. Ключ секции — номер `NN` (совпадает с номером слайда), заголовок после `·` — для человека. В тексте заметок нельзя использовать бэктик и `${`. `data-notes` в HTML остаются fallback-копией (дека работает и одним файлом). **`<slug>-notes.js` — источник правды после первой генерации.** Пользователь правит заметки прямо в presenter-окне (кнопка «✎ править») и выгружает файл кнопкой «⤓ notes.js» — там могут быть правки, которых нет в `data-notes`. Поэтому при любой пересборке/доводке **сначала прочитай существующий `notes.js`** и перенеси его текст в `data-notes` собираемой деки, а не перезаписывай файл из старых `data-notes`. ## Шаг 5 — Проверка и показ - **Прогони валидатор:** `python3 <каталог скилла>/assets/validate.py <дека>.html` — он проверяет целостность kernel (маркер `KERNEL v6`, base/print-стили, chrome, presenter, правку заметок, экспорт в PDF), остаточные `{{…}}`, сетевые ссылки и локальные ссылки на отсутствующие файлы, синтаксис JS (`node --check` по каждому блоку скрипта — kernel, interactive — и по notes.js), посторонние script-блоки и порядок interactive относительно kernel, интерактив на движке ниже v6, клик, повешенный ATTRIBUTE-обработчиком (`onclick=…`) на не-интерактивный тег, синхронность секций `<slug>-notes.js` со слайдами, наличие `slides.md`/`design.md`/`DECK.md`. Ошибки чини до показа. Одиночную деку быстрого режима валидатор узнаёт сам (лежит не в `deck/`, рядом ни одного файла комплекта) и комплекта с неё не спрашивает. Чего он НЕ ловит: сломанную логику виджета и клики, повешенные через `addEventListener` — их проверяешь руками, следующим пунктом. - **Визуальная самопроверка в Chrome (обязательный шаг).** Деку смотришь ТЫ, а не пользователь: подними локальный сервер в `deck/`, открой вкладку, сними вердикт `?check` и ошибки JS из консоли, войди в режим съёмки, прогони аудитор макета (ОДИН вызов на всю деку) и посмотри кадры глазами. Проверка стоит на двух опорах, обе обязательны: **аудитор** даёт числа (переполнение по эталону 16:9, вылет за кадр, битые картинки, мелкий кегль, обрезанный и наложенный текст, пустые слайды), **кадры** — то, что числами не берётся (контраст, ритм, композиция, «висячие» строки). Что нашёл — чини и переснимай, пока аудитор не замолчит, а кадры не станут чистыми. **Третьим заходом — PDF:** его печатную раскладку не видят ни `?check`, ни аудитор, проверяется он headless-печатью из терминала (`cookbook.md`, п.9) и рендерится через `qlmanage` — тем же движком Quartz, которым его откроет зритель. Точная процедура со сниппетами — в `cookbook.md`, раздел «Визуальная самопроверка в Chrome». Четыре вещи, о которые спотыкаются: **(1)** `file://` расширение не открывает (`Can't interact with browser-internal or unparseable URLs`) — только `python3 -m http.server` из папки `deck/` и `http://127.0.0.1:PORT/…`; **(2)** окно браузера НЕ 16:9 и `resize_window` его не выправляет — переполнение меряй аудитором по эталону `innerWidth/16*9`, а не на глаз по скриншоту; окно с сильно непропорциональным ratio (вне 1.70–1.86) приводится к кадру 16:9 стендом из `cookbook.md`; **(3)** режим съёмки собирается ТОЛЬКО стилем `shotmode` из `cookbook.md`: самодельный `animation:none` снимет каскады и карточки ПУСТЫМИ (design-слой держит их на `opacity:0` до анимации) и оставит копию фона поверх контента — пойдёшь чинить несуществующее; **(4)** `S` и `⌘P` в этом режиме НЕ нажимай — системный диалог печати заблокирует расширение до ручного закрытия; PDF проверяется headless-печатью из терминала (`cookbook.md`, п.9), и это часть проверки, а не забота пользователя: `?check` и аудитор печатную раскладку не видят вовсе. Смотреть страницы — через `qlmanage` (движок Quartz, как у Preview): `pdftoppm` рисует чистым даже тот PDF, который в Preview идёт серыми прямоугольниками. Расширения claude-in-chrome нет / Chrome недоступен → так и скажи и попроси пользователя открыть деку с `?check` и пролистать глазами; молча пропускать проверку нельзя. **Проверку PDF эта ветка не отменяет:** headless-печати не нужны ни расширение, ни живая вкладка — только бинарь Chrome. Нет и его — скажи, что PDF не проверен. - **Интерактив проверяется руками, а не глазами** (если он есть): в открытой вкладке нажми каждый виджет и убедись, что дека при этом НЕ пролистнулась, состояние изменилось видимо, а уход на соседний слайд и возврат оставляют виджет в осмысленном состоянии. Есть поле ввода — напечатай в него «psb» и проверь, что не открылись presenter/блэкаут/печать. Раскрывающийся блок проверь раскрытым на переполнение: раскрой его и прогони аудитор макета (`cookbook.md`, п.5) — он посчитает слайд в раскрытом состоянии. Дека на kernel ниже v6 интерактив не выдержит — движок надо обновить. - **Быстрый режим — проверка короче, но не мельче:** валидатор, `?check`, ошибки консоли, аудитор макета и headless-печать PDF обязательны ЦЕЛИКОМ — аудитор стоит один вызов на всю деку независимо от числа слайдов, экономить на нём нечего. Рационируются только кадры: титул + все слайды, которые пометил аудитор, + два-три самых плотных. Молча пропускать проверку нельзя и здесь. - Ручная проверка (её делает пользователь, не ты): `P` открывает presenter отдельным окном (не вкладкой) и он синхронен, `B` гасит экран, живые заметки подхватываются. - **Быстрый режим на этом заканчивается:** отдай путь к файлу, скажи, что это вся дека целиком (переслать = переслать один файл), и напомни управление. `DECK.md`, `deck/` и проверку раскладки пропусти — их нет. Пункты ниже — полный режим. - **Сгенерируй `DECK.md`** в рабочей папке (не в `deck/`) по `assets/deck-template.md`: режим деки (скрипт/руками), карта слайдов, арт-дирекшн сжато, принятые решения/отступления с «почему», как править. Собирал скриптом — проверь, что скрипт и его исходники лежат в рабочей папке рядом с `DECK.md`. - **Проверь раскладку:** в `deck/` — только HTML, его `notes.js` и (если есть) `deck-assets/`; ничего постороннего туда не попало, а исходники и материалы остались в рабочей папке нетронутыми. - Дека — в `deck/<slug>-<дата>.html`. Открой: `open deck/<файл>` (macOS). Скажи пользователю прямо: чтобы унести доклад — берётся **папка `deck/` целиком** (архив, флешка, другой ноутбук), выбирать файлы не надо. - Напомни управление: `← →`/колесо/свайп — листать, `P` — presenter-окно с заметками (его НЕ шарить, шарить деку), `B` — чёрный экран, `F` — fullscreen, `S` — сохранить деку в PDF. Позиция хранится в `#хэше` — F5 не собьёт слайд. **Правка заметок прямо в presenter-окне — кнопками мышью** (буквенных хоткеев там намеренно нет: в это окно печатают; из клавиш живут только стрелки, `Esc` и `⌘⏎`): «✎ править» или двойной клик по тексту → «✓ применить», «☰ все заметки» — весь текст разом, «↺ откатить» — выбросить свои правки и вернуться к файлу (передумал — плашка вернёт их), «⤓ notes.js» — выгрузить файл в загрузки, «⧉ копировать» — его текст в буфер. Из `file://` браузер писать на диск не умеет, поэтому правки живут черновиком в браузере (переживают F5, индикатор `✎ черновик` в шапке presenter), а на диск переносятся выгруженным файлом — положить его рядом с декой поверх старого, индикатор снова зазеленеет. Всё это объясняет встроенная справка в окне докладчика: кнопка «? справка» (при первом открытии presenter внизу всплывает подсказка про неё) — отдельно расписывать пользователю каждую кнопку не нужно. Альтернатива прежняя: править `<slug>-notes.js` во внешнем редакторе — presenter подхватит за пару секунд (файл главнее черновика; несохранённые правки не пропадут — presenter предложит их вернуть). Пересылать деку можно одним HTML (вшитые заметки-fallback), но выступать — из папки `deck/`, рядом с notes.js. - **Просят PDF** — клавиша `S` в открытой деке (то же и по `⌘P`): kernel замораживает ВСЕ слайды в финальном кадре (счётчики досчитаны, каскады/цепочки/pipeline показаны, печатный текст напечатан, фон разложен по страницам) и открывает диалог печати → выбрать «Сохранить как PDF». Страница 16:9 (13.333×7.5″) без полей, слайд = страница, цвета/фон/картинки печатаются, текст в PDF остаётся текстом. Нюансы, о которых предупреди: sidecar-GIF даёт первый кадр, а дека должна лежать рядом со своей `deck-assets/`; слайд с переполнением обрежется по краю страницы — сперва прогони `?check`; если браузер всё же напечатал белым, включи в диалоге «Фоновая графика». Проверено в Chrome; из Safari результат сверь глазами. Тени в PDF плоские намеренно: размытую тень Chrome пишет растровой маской, которую Preview рисует серым прямоугольником поверх контента, поэтому kernel на время печати меняет её на тонкую обводку того же цвета (на экране всё возвращается). Мины печати целиком — `cookbook.md`, п.9. ## Шаг 6 — Доводка Предложи покрутить: палитру/плотность/движение, трактовку фона, добавить/убрать слайд, тайминги. **Перед любой правкой перечитай `<slug>-notes.js`** — пользователь мог поправить заметки в presenter-окне и выгрузить файл; эти правки переносятся в `data-notes`, а не затираются старым текстом из HTML. Сначала определи режим деки (по `DECK.md` / наличию скрипта сборки): режим «скрипт» → правь ИСХОДНИКИ и пересобирай, готовый HTML руками не трогай, скрипт держи актуальным; режим «руками» → точечный Edit — только в `<style id="design">` и `#deck`, не трогая kernel. Добавил/убрал слайды — перенумеруй секции в `<slug>-notes.js` (он источник правды для заметок; `data-notes` в HTML обнови как fallback). Пересобранная дека кладётся в ту же `deck/` — не плоди копии в рабочей папке и не оставляй в `deck/` старые html/notes от прошлых сборок. **После правок — снова визуальная самопроверка в Chrome** (Шаг 5): аудитор макета гоняется на всю деку целиком (это один вызов), кадры переснимаются для затронутых слайдов, а если менял палитру/типографику/плотность — для всей деки; правка вёрстки вслепую и есть основной источник переполнений. После правок обнови `DECK.md` (карту слайдов и раздел решений), если менял структуру/анимации/тайминги. Есть интерактив — он тоже предмет доводки (что нажимается, насколько крупно, что происходит), и после любой правки его перещёлкивают заново: сломанный виджет валидатор не поймает. В быстром режиме доводка идёт по тому же одному файлу — папку и комплект не заводи, пока пользователь не попросит раскрутку. ## Продолжить работу над готовой декой Дали путь к `*.html` (маркер `KERNEL v` в шапке) и промт, что доделать, — это не новый доклад, а продолжение. **Ничего служебного в деку не вшито и искать нечего: дека сама себе контекст.** Прочитай её: - текст слайдов — секции `<section class="slide">` в `#deck`; - речь спикера — `data-notes` у секций (если рядом лежит `<slug>-notes.js` — он главнее, читай его); - арт-дирекшн — `<style id="design">`: палитра `:root`, типографика, композиционные классы; - версию движка — маркер `KERNEL v` в шапке; рядом может лежать `DECK.md` — тогда он главный источник решений. Дальше — по тому, что просят: - **точечная доводка** («поменяй палитру», «добавь слайд», «перепиши третий») — правишь тот же файл по Шагу 6, режим и раскладку не меняешь; - **раскрутка до доклада** — спроси, где создать рабочую папку, и разверни комплект: восстанови `slides.md` из вёрстки и заметок, добери `design.md` (интервью по Шагу 2 или зафиксируй уже сложившийся арт-дирекшн деки как бриф), перенеси деку в `deck/`, сгенерируй `<slug>-notes.js` из `data-notes`, создай `DECK.md`. Затем обычная доводка. **Движок старый.** Дека собрана на kernel ниже v6, а в неё добавляют интерактив — в старом движке нет guard'ов, и виджет будет драться с навигацией. Скажи это прямо и перенеси слайды с design-слоем в свежий `assets/kernel.html`; без интерактива старую деку трогать незачем. ## Стиль общения - Язык: русский. Кратко между вопросами. - Не выдумывай факты/цифры — бери из материалов или спрашивай. Из сети — только опц. URL-референс и OSS-шрифт по согласию.