PPTX Skill

Используйте этот скилл всякий раз, когда в задаче фигурирует файл .pptx — в качестве входных данных, выходных или и тех и других: создание презентаций и питч-деков, чтение и извлечение текста, редактирование, объединение и разбивка слайдов, работа с шаблонами, заметками докладчика и комментариями.

Краткий справочник

Чтение контента

# Извлечение текста
python -m markitdown presentation.pptx

# Визуальный обзор
python scripts/thumbnail.py presentation.pptx

# Сырой XML
python scripts/office/unpack.py presentation.pptx unpacked/

Рабочий процесс редактирования

1. Анализ шаблона через thumbnail.py
2. Распаковка → работа со слайдами → правка контента → очистка → упаковка

Создание с нуля

Используйте когда нет шаблона или исходной презентации. Подробности — в pptxgenjs.md.

Идеи дизайна

Не создавайте скучные слайды. Простые буллиты на белом фоне никого не впечатлят. Для каждого слайда рассматривайте идеи из этого раздела.

Перед началом

• Смелая цветовая палитра под тему: если цвета подойдут к любой другой презентации — выбор недостаточно специфичный.
• Доминирование над равенством: один цвет должен доминировать (60-70% визуального веса), 1-2 поддерживающих тона и один острый акцент.
• Контраст тёмное/светлое: тёмные фоны для титульных слайдов и заключения, светлые — для контентных («сэндвич»). Или полностью тёмная тема для премиального вида.
• Визуальный лейтмотив: выберите ОДИН отличительный элемент и повторяйте его на каждом слайде — скруглённые рамки изображений, иконки в цветных кругах, жирная односторонняя рамка.

Цветовые палитры

Для каждого слайда

• На каждом слайде нужен визуальный элемент — изображение, график, иконка или фигура. Слайды только с текстом забываются.
• Варианты макетов: двухколоночный (текст слева, иллюстрация справа), иконки + текст рядами, сетка 2×2 или 2×3, изображение во весь край.
• Отображение данных: крупные числа (60-72pt с маленькими подписями), сравнение колонок (до/после, плюсы/минусы), временная шкала.

Типографика

Чего избегать

• Не повторяйте один и тот же макет — варьируйте колонки, карточки и выноски.
• Не центрируйте основной текст — выравнивайте по левому краю; по центру только заголовки.
• Не используйте синий по умолчанию — выбирайте цвета, отражающие конкретную тему.
• Не создавайте слайды только с текстом — добавляйте изображения, иконки, графики.
• НИКОГДА не используйте акцентные линии под заголовками — это маркер AI-генерации; используйте пустое пространство или цвет фона.

QA (обязательно)

Исходите из того, что проблемы есть. Ваша задача — найти их.

Проверка контента

python -m markitdown output.pptx

При использовании шаблонов проверьте на остаточный текст-заполнитель:

python -m markitdown output.pptx | grep -iE "xxxx|lorem|ipsum|this.*(page|slide).*layout"

Визуальная проверка

Используйте субагентов — даже для 2-3 слайдов. Конвертируйте слайды в изображения, затем проверьте на: перекрывающиеся элементы, выходящий за края текст, столкновение элементов, неравномерные отступы, низкоконтрастный текст, остаточный текст-заполнитель.

Цикл верификации

1. Сгенерировать слайды → конвертировать в изображения → проверить
2. Составить список найденных проблем
3. Исправить
4. Повторно проверить исправленные слайды
5. Повторять до чистого прохода без новых проблем

Конвертация в изображения

python scripts/office/soffice.py --headless --convert-to pdf output.pptx
pdftoppm -jpeg -r 150 output.pdf slide

Создаёт файлы slide-01.jpg, slide-02.jpg и т.д.

Зависимости

• pip install "markitdown[pptx]" — извлечение текста
• pip install Pillow — сетки миниатюр
• npm install -g pptxgenjs — создание с нуля
• LibreOffice (soffice) — конвертация в PDF
• Poppler (pdftoppm) — PDF в изображения