present git:20261024.c3b98daA

Immutable. This exact content never changes and is served at /api/v1/blob/f403e2d75bda0783.

---
name: present
description: "Ведёт от идеи до готовой HTML-презентации (деки): текст слайдов, дизайн-бриф, сборка офлайн-файла с presenter-окном, прогон вслух и ужатие под хронометраж. Короткий путь — одна страница-презентация за один заход."
when_to_use: "«сделай презентацию», «собери слайды», «деку для доклада», «помоги придумать доклад», «простая презентация», «разбери прогон / репетицию», «ужми доклад до 20 минут», «продолжи доклад». На вход — идея, тема, текст, запись, папка со slides.md и design.md, репо, URL-референс или готовая дека. Нужен именно файл .pptx — это не этот скилл."
argument-hint: "[идея / папка / файл / запись / дека / URL-референс]"
allowed-tools: Read, Write, Edit, Bash, Glob, Grep, WebFetch, Skill, AskUserQuestion, mcp__claude-in-chrome__tabs_context_mcp, mcp__claude-in-chrome__tabs_create_mcp, mcp__claude-in-chrome__tabs_close_mcp, mcp__claude-in-chrome__navigate, mcp__claude-in-chrome__computer, mcp__claude-in-chrome__javascript_tool, mcp__claude-in-chrome__read_console_messages, mcp__claude-in-chrome__browser_batch
---

# present — от идеи до беспоук HTML-презентации

Скилл ведёт человека по конвейеру «Контекст · Дизайн · Сборка · Голос» и на выходе отдаёт
самодостаточную HTML-деку, **спроектированную под этот контент**. Дека открывается офлайн в браузере,
листается стрелками и колесом. Заметки спикера живут в presenter-окне и в живом файле `<slug>-notes.js`.
Короткий путь — одна страница-презентация без окна докладчика, за один заход.

Этот файл — маршрутизатор: он решает, какой путь и с какого этапа, и держит ворота между этапами.
Сами этапы лежат в `${CLAUDE_SKILL_DIR}/stages/`, расшифровка записей — в `stages/transcribe.md`. **Читай файл этапа только тогда, когда входишь в этап.**
Пути `assets/…` и `stages/…` ниже — относительно `${CLAUDE_SKILL_DIR}`.

## Философия (главное)
**Ты — дизайнер презентаций, а не заполнитель шаблона.** Разные доклады → визуально разные деки
(структура, палитра, типографика, фон, движение), а не перекрашенный один вид.
- **Движок `assets/kernel.html` (из ассетов ЭТОГО скилла, не из копий во входной папке) копируется
  ДОСЛОВНО** — навигация, анимации, заметки и экспорт в PDF не ломаются. Весь визуал — в его
  `<style id="design">` и в слайдах `#deck`.
- **`assets/design-axes.md`** — 9 осей дизайн-решений; **`assets/art-direction.md`** — как читать бриф
  и референс; **`assets/cookbook.md`** — технический контракт kernel, офлайн-шрифты, медиа, проверки;
  **`assets/deck-template.md`** — скелет `DECK.md`; **`assets/validate.py`** — валидатор деки.
- **Самодостаточность (жёстко):** готовая дека — офлайн, без сетевых ссылок. Канон — `cookbook.md`.
- **Контент не выдумывай.** Речь — слова человека, цифры — из материалов. Чего нет — спроси.
  Одно исключение: в режиме «сделай сам» без материала можно написать черновик речи по идее. Он
  помечается в `slides.md` как черновик модели, а факты и цифры в нём — только `[нужно: …]`.

## Два пути

| | **Короткий** — одна страница | **Полный** — доклад |
|---|---|---|
| Когда | показать мысль картинками, разовая визуализация, черновик, простая презентация | выступление, которое будут репетировать и дорабатывать |
| Этапы | один заход: `stages/quick.md` | Контекст → Дизайн → Сборка → Голос |
| На выходе | ровно один `<slug>.html` | рабочая папка: `slides.md`, `design.md`, `DECK.md`, папка показа `deck/` |
| Окно докладчика | нет, если прямо не попросили; в финале — предложение добавить | есть, с живыми заметками |
| Статус | не ведётся | раздел «Конвейер» в `DECK.md` |

## Вход — ингест (молча), затем вопросы

Сначала прочитай `$ARGUMENTS` и приложенное — молча. В аргументах путь и фраза вместе — отдели путь;
фраза — указание человека (новый бюджет, «дальше сам», «хватит»), учти его. Папка → просканируй (`Glob`/`Read`) и отметь:
- **`DECK.md`** → прочитай ПЕРВЫМ: раздел «Конвейер» говорит, где остановились, остальное — решения по деке;
- **`slides.md`** (или `content.md` / любой `.md` с разбивкой по слайдам) — текст доклада;
- **`design.md`** (или `DESIGN.md`/`decision.md`/`brief.md` — сохрани как `design.md`) — бриф;
- **запись** — `*.m4a/mp3/wav/mp4/mov`; **расшифровка** — `transcript*.md`, `rehearsal-*.md`;
- **медиа** — `*.png/jpg/jpeg/gif/webp/svg`, запомни пути и размеры;
- **готовая дека** — `*.html` с маркером `KERNEL v` в шапке; **референс** — `reference.html`, URL в аргументах;
- прочее — материал: `.docx`, статьи, путь к репо (реальные цифры из `git log`), тема, сырой текст.

Затем вопросы — одним AskUserQuestion, только те, ответа на которые нет:
1. **Путь** — короткий или полный. Варианты формулируй по увиденному («пришёл абзац в чат — это
   похоже на одну страницу»), решение за человеком. Нет вопроса, если есть `DECK.md` (путь полный)
   или дали готовую деку (путь уже известен: доводка или раскрутка, `stages/build.md`).
2. **Как работаем** — «вместе» (этапы идут через вопросы) или «сделай сам» (Claude проходит этап без
   вопросов и показывает итог). Только для полного пути. Режим можно сменить на любом этапе словами
   «дальше сам» / «давай вместе». «Сделай сам» останавливается только на ручных шагах и в финале.
3. **Место** — только если не задано. Полный путь: папка дана → работаем в ней; не дана → предложи
   2-3 пути (например `<текущая директория>/<slug>/`) плюс «указать свой». Короткий путь: куда
   положить HTML (текущая директория — годный первый вариант).

Короткий путь → читай `stages/quick.md` и иди по нему. Дальше этот файл нужен только для «Стиля общения».

## Полный путь — маршрут

**С какого этапа начать** — по тому, что уже есть. Строки таблицы проверяй сверху вниз, берёт первая
подходящая. Скажи одной строкой, с какого этапа начинаешь и почему.

| Что есть | Этап | Файл |
|---|---|---|
| запись или текст прогона (`rehearsal-*`), которых нет в таблице кругов `DECK.md`, рядом с собранной декой | Голос | `stages/rehearse.md` |
| `DECK.md` с «Конвейером» | этап из строки «Следующий шаг» | по этапу |
| готовая дека, просят доделать | Сборка → доводка | `stages/build.md` |
| `slides.md` и `design.md` | Сборка | `stages/build.md` |
| только `slides.md` | Дизайн | `stages/design.md` |
| идея, тема, текст, материалы, запись — без `slides.md` | Контекст | `stages/context.md` |

**В начале полного пути** создай `DECK.md` в рабочей папке: шапка и раздел «Конвейер» по
`assets/deck-template.md` (режим работы, бюджет, этапы со статусом, следующий шаг). Остальные разделы
дописывает этап «Сборка». «Следующий шаг» всегда начинается с названия этапа: «Голос — ждёт человека: …».

**Бюджет времени** хранится в «Конвейере» — это главное место; шапка `slides.md` повторяет его.
Человек поменял бюджет посреди пути — обнови оба места и оценку в строке «Контекст», затем продолжай.

**Ворота.** Каждый файл этапа кончается разделом «Ворота этапа». Проверка не прошла — следующий этап не
начинается: дочини или спроси. Прошла — обнови «Конвейер» и переходи к следующему этапу без отдельного
вопроса «идём дальше?». В режиме «вместе» коротко скажи, что этап закрыт и что дальше.

**Главное правило:** деку не собирают, пока в рабочей папке нет ОБОИХ файлов — `slides.md` и `design.md`.

**Ручной шаг** — то, что может сделать только человек: записать прогон, выбрать стиль на refero,
докинуть картинку. Формат — три строки, затем остановка:
```
Нужен твой шаг: <что сделать — одна фраза>.
Положи <что> в <папка>.
Потом вызови /present <папка> — продолжу с этапа «<этап>».
```
Если этап даёт подробности («как записать прогон»), они идут коротким списком сразу после первой
строки. Блок ручного шага — последний в сообщении: итог этапа, путь к деке, управление и
предложения-опции идут выше. Перед остановкой запиши в «Конвейер»: «<этап> — ждёт человека: <что>» и «Следующий шаг».
Новая сессия читает этот статус и продолжает с того же места, ничего не переспрашивая.

**Финал полного пути** — когда человек сказал «хватит» после круга «Голоса» или отказался от прогона.
«Сделай сам» сам финиш не выбирает: прогон может сделать только человек, поэтому после круга скилл
останавливается на ручном шаге «следующий прогон» и пишет, что «хватит» — это финиш. В финале: путь к `deck/`,
хронометраж последнего прогона против бюджета, напоминание: унести доклад — значит взять `deck/` целиком.

## Стиль общения
- Язык: русский. Кратко между вопросами. Все уточнения — через AskUserQuestion (2-4 варианта + «Другое»).
- Не спрашивай то, что уже есть в материалах или в «Конвейере».
- Не выдумывай факты и цифры — бери из материалов или спрашивай. Из сети — только URL-референс и
  OSS-шрифт по согласию.
- Пакеты сам не ставь; нет инструмента — скажи и предложи обход.