# Presentation

> Create presentations from idea to finished deck. Use when the user wants to prepare a presentation, slides, talk, pitch deck, webinar deck, report deck, conference talk, or speaker notes. Handles structure, slide content, narrative flow, visuals, and creation of a reveal.js/HTML deck.

- Skill: `web3blind/presentation` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add web3blind/presentation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/web3blind/presentation/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- License: MIT
- Author: web3blind (https://skillmd.com/u/web3blind)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/web3blind/presentation

---

# 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`, если нужно исследовать рынок, конкурентов, аудиторию, каналы привлечения, экономику или контекст ниши. В этом случае сначала отделяй проверенные внешние факты от гипотез и выводов, а в презентацию переносить только то, что помогает аргументации.

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

## Ограничения

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

## Слайды с озвучкой

Этот режим нужен только для презентации с дикторским текстом или видео:

- Одна идея и одна основная визуальная структура на слайд. Короткие подписи вместо абзацев, конкурирующих с речью.
- Сопоставь каждый слайд с фрагментом аудио. Отделяй произносимый текст от указаний по визуалу.
- Проверь контактный лист и самые плотные слайды в полном размере: обрезанные подписи, мелкий текст, лишние детали, несогласованное оформление.
- Если слайд слишком пустой, добавь несколько узнаваемых объектов или простую схему, а не дополнительные абзацы. Сохрани чистый вариант для сравнения.
- Проверь тайминг по фактическому аудио: начало, конец, переходы, пропуски и наложения. Просмотр отдельных изображений не доказывает синхронизацию видео.
- На финальном слайде оставь одно понятное действие. Рядом с QR-кодом предоставь читаемую текстовую ссылку.

## Quality Checks

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

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

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