presentation

Скилл для полного текстового workflow по презентациям: от замысла до готовой колоды слайдов.

Когда использовать

Используй, когда пользователь хочет:

• придумать презентацию с нуля
• собрать доклад, питч или слайды для выступления
• превратить текст, заметки или статью в презентацию
• получить не только структуру, но и сами слайды
• подготовить speaker notes
• получить результат в reveal.js / HTML

Основной принцип

Работай не как "генератор слайдов", а как редактор презентации.

Сначала:

• цель
• аудитория
• контекст выступления
• формат
• ограничение по времени

Потом:

• смысловая структура
• ритм презентации
• тезисы по слайдам
• notes для докладчика
• только затем создание deck

Workflow

Особый приоритет для этого скилла: презентация должна быть удобна не только для зрителей, но и для текстовой работы над ней.

Это значит:

• структура должна быть линейной и легко читаемой в текстовом виде
• каждый слайд должен иметь ясную роль и короткое имя
• содержимое должно быть удобно редактировать без визуального интерфейса
• декоративные решения не должны мешать пониманию и сопровождению презентации

Когда пользователь просит именно готовую колоду, а не только структуру, разделяй 2 слоя:

• narrative layer: смысл, ритм, аргументация, slide map, notes
• deck production layer: устойчивый HTML/reveal-style каркас, повторяемые правила слайдов, экспортная предсказуемость

/presentation остаётся прежде всего narrative-first skill, но в режиме полной сборки должен уметь держать и production-дисциплину.

1. Зафиксируй контекст

Сначала кратко выясни:

• тема
• для кого презентация
• цель (объяснить, убедить, продать, отчитаться, выступить)
• длительность или примерное число слайдов
• есть ли исходные материалы

Если собирается готовый deck, дополнительно зафиксируй только нужный минимум:

• формат: выступление, питч, внутренний апдейт, demo deck, отчёт
• нужен ли строгий фирменный стиль или достаточно аккуратного нейтрального
• будет ли это читаться в браузере, печататься в PDF, показываться со сцены, или всё сразу

Если части данных нет, задай только действительно нужные вопросы.

2. Собери каркас презентации

Предложи структуру презентации:

• opening
• основные блоки
• финальный вывод / CTA

Если уместно, предложи 2 варианта структуры:

• более простую
• более убедительную / выступленческую

3. Разверни в slide map

После согласования структуры собери slide map.

Для каждого слайда укажи:

• номер
• роль слайда
• заголовок
• 2-5 ключевых тезисов
• visual type: none, screenshot, photo, diagram, chart, icon, comparison
• если visual не none, коротко опиши:
• что именно должно быть показано
• зачем этот визуал нужен
• можно ли обойтись без него
• что должно остаться у слушателя после этого слайда

Не делай слайды перегруженными текстом.

4. Подготовь speaker notes

Если презентация для выступления, добавляй краткие notes:

• что сказать устно
• что не обязательно писать на слайде
• где сделать акцент
• где можно привести пример

5. Создай deck

Если пользователь просит создать саму презентацию, делай reveal.js / HTML deck.

Выход по умолчанию:

• presentation.html
• styles.css при необходимости

Требования:

• текстовая ясность важнее декоративности
• хороший контраст
• понятные заголовки
• минимум визуального шума
• разумная плотность текста
• структура должна быть удобна и для чтения, и для озвучивания

Для этого режима опирайся на [stable deck skeleton guidance](references/deck-skeleton.md):

• держи устойчивый каркас deck, а не изобретай заново оболочку на каждом проходе
• сохраняй один понятный ритм слайдов, если нет сильной причины ломать его
• проектируй deck так, чтобы он оставался предсказуемым для браузера, текстовой правки и PDF-экспорта
• если пользователь не просит полный deck, не тащи в задачу production-слой раньше времени

Правила качества

• Не путай документ и презентацию: на слайде должен быть тезис, а не абзац.
• Не делай "простыню текста".
• Один слайд = одна смысловая задача.
• Если материал сложный, лучше разбить на 2 слайда, чем перегрузить один.
• Если презентация должна быть доступна для screen-reader workflows или текстового редактирования, всегда сохраняй ясную линейную структуру.
• Приоритет: логика, читаемость, удобство редактирования, а не визуальные эффекты.
• Визуалы должны помогать пониманию, а не служить декором.
• Каждый визуал должен иметь текстовый эквивалент в структуре или notes.
• Если визуал не усиливает тезис, лучше не добавлять его.

Режимы работы

A. Структура

Когда пользователь хочет только понять, как выстроить презентацию.

B. Слайды

Когда пользователь хочет готовые заголовки и тезисы по каждому слайду.

C. Полная сборка

Когда нужен готовый reveal.js / HTML deck.

В этом режиме:

• сначала зафиксируй narrative layer
• затем собирай deck production layer
• используй устойчивый skeleton вместо случайной визуальной оболочки
• следи, чтобы каждый слайд сохранял короткий заголовок, одну основную задачу и понятный текстовый эквивалент для визуала

C2. PowerPoint / PPTX

Когда пользователь явно просит настоящий .pptx, PowerPoint-файл, Word/Excel/Office-артефакт или совместимость с офисным пакетом, не притворяйся, что reveal.js равен PPTX.

Порядок:

• сначала всё равно собери narrative layer и slide map в тексте
• основной локальный инструмент: python-pptx в venv <python-pptx-venv>
• запускай генерацию через python, не через глобальный pip/python
• если нужен другой PPTX-инструмент, сначала делай security-аудит и VirusTotal /ss; не запускай curl-pipe installer и не ставь его автоматически
• для self-hosted сервисов уровня Gamma-alternative сначала делай sandbox-review: Dockerfile/build scripts, внешние release artifacts, telemetry opt-out, auth defaults, открытые порты, MCP/API bind host, внешние LLM/image/stock providers; не подавай приватные документы до проверки
• такой сервис имеет смысл рассматривать не как замену базовому локальному python-pptx, а как отдельный pipeline для повторяемых отчётов, питчдеков, разборов проектов и учебных материалов, где агент передаёт тему/файл через API/MCP, получает PPTX/PDF, затем человек редактирует; запускать только после sandbox-пилота и проверки качества на не-приватных материалах
• после сборки проверяй, что .pptx открывается как zip/OpenXML и содержит ppt/presentation.xml; при возможности делай текстовую/структурную проверку
• для пользователя обязательно сохраняй текстовую структуру слайдов и speaker notes рядом с файлом, чтобы deck был управляем через screen reader

D. Переработка материала

Когда есть статья, заметки, черновик, пост, доклад или набор тезисов, и их нужно превратить в презентацию.

В этом режиме:

• сначала выдели главную мысль исходного материала
• убери всё, что хорошо работает как текст, но плохо работает как слайд
• преврати длинные фрагменты в тезисы, опорные формулировки и смысловые блоки
• если материал перегружен, предложи сокращённую версию презентации
• если материал сильный, но линейный, помоги разбить его на сцену, ход мысли и финальный вывод

E. Адаптация поста или статьи в выступление

Когда пользователь хочет взять уже готовый пост, статью или заметки и сделать из этого доклад или deck.

В этом режиме:

• определи, что в исходнике является:
• заходом
• основным аргументом
• примерами
• выводом
• предложи, что оставить на слайдах, а что вынести в speaker notes
• если исходник слишком плотный, предложи 2 версии:
• короткое выступление
• полная версия
• не переноси текст на слайды механически, а адаптируй его под устную подачу

F. Презентация проекта / продукта / pitch deck

Когда пользователь готовит презентацию проекта, продукта, стартапа, идеи для рынка, инвесторов, партнёров или внутреннего согласования.

В этом режиме не применяй pitch-структуру ко всем презентациям автоматически. Используй её только если контекст явно проектный, продуктовый, предпринимательский, инвестиционный или go-to-market.

Проверь, раскрыты ли ключевые вопросы:

• проблема пользователей
• решение
• зачем продукт существует / цель продукта
• основной функционал
• целевая аудитория
• где брать аудиторию / каналы привлечения
• экономика проекта
• монетизация
• выход на рынок / go-to-market
• конкуренты и отличие от них
• как повышать конверсию
• цель самой презентации: чего хотим от слушателя — инвестиции, партнёрство, согласование, покупка, обратная связь или другое действие

Если данных не хватает, не выдумывай рынок, экономику, конкурентов или метрики. Сначала явно отметь пробелы и помоги собрать недостающие вводные.

Для аналитических блоков можно использовать связку perplex + deep, если нужно исследовать рынок, конкурентов, аудиторию, каналы привлечения, экономику или контекст ниши. В этом случае сначала отделяй проверенные внешние факты от гипотез и выводов, а в презентацию переносить только то, что помогает аргументации.

Структура такой презентации обычно должна отвечать на три вопроса:

• почему проблема важна
• почему это решение имеет шанс сработать
• что конкретно нужно от аудитории после презентации

Ограничения

• Не перегружай презентацию бессмысленным дизайном.
• Не подменяй презентацию статьёй.
• Не добавляй выдуманные факты, цифры или кейсы.
• Не переносить пост или статью на слайды абзац за абзацем.
• Не предлагай изображения просто потому, что "на слайде должна быть картинка".
• Если данных мало, сначала помоги собрать сильную структуру, а не имитируй глубину.
• Если есть выбор между "красиво" и "понятно и управляемо текстом", выбирай второе.

Quality Checks

Перед финализацией презентации проверь:

• у каждого слайда есть одна ясная задача
• заголовки можно понять в линейном текстовом чтении
• нет ли слайдов, где текст пытается заменить устное объяснение целым абзацем
• визуалы не являются единственным носителем смысла
• переходы между слайдами читаются как осмысленный ход мысли, а не как набор карточек
• если собран HTML deck, его каркас не перегружен декоративной механикой ради эффекта

После создания

После подготовки структуры или deck, если уместно, предложи следующие шаги:

• сократить презентацию
• усилить аргументацию
• адаптировать под другую аудиторию
• добавить speaker notes
• подобрать или уточнить визуалы по слайдам
• превратить статью / пост / заметки в deck
• превратить в reveal.js / HTML deck, если пока сделана только структура