Codex PPT Skill

Скилл собирает презентацию из статьи, отчета или заметок как серию цельных слайдов-картинок и склеивает их в pptx

  • 7 848 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Расширенный доступ

Почему такой уровень

  • Запускает скрипты на Python и обращается к внешнему API генерации изображений
  • Создает и записывает файлы проекта: изображения, outline.md и pptx
Все причины и проверки

ningzimu/codex-ppt-skill

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/codex-ppt-skill

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Запускает скрипты на Python и обращается к внешнему API генерации изображений
  • Создает и записывает файлы проекта: изображения, outline.md и pptx

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл codex-ppt ведет работу по одиннадцати шагам и на каждом ключевом спрашивает подтверждения. Сначала агент читает материал (статью, отчет, Markdown, PDF, Word) и пишет outline.md с числом слайдов и тезисами. Затем предлагает два-три стиля из двенадцати встроенных, от «чистого делового» до «научной защиты» и «рукописной доски», и объявляет, чем будет генерировать картинки. После этого рисуется один пробный слайд, и только после вашего ответа идет вся серия: каждая страница получается целым изображением 16 на 9, а при наличии субагентов один субагент рисует один слайд и сам проверяет читаемость текста. Скрипт assemble_ppt.py склеивает картинки из папки origin_image в pptx, а текст выступления из speech.md кладет в заметки каждого слайда. Для запасного пути есть image_gen.py с подключаемыми провайдерами: OpenAI-совместимый API и AtlasCloud.

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

Подходит, если

  • Вы пишете технический доклад на 15 минут по статье из блога и хотите получить слайды и готовый текст выступления в заметках
  • Нужно собрать защиту диссертации или отчет по гранту в стиле научной защиты, вставив на конкретные слайды оригинальные рисунки из статьи
  • У вас есть пример понравившейся презентации (PDF или PPTX), и нужно скопировать ее стиль на новое содержание
  • На курсе нужен комплект слайдов по конспектам лекций в стиле учебного пособия
  • После просмотра серии один слайд вышел неудачным: агент переделает эту страницу по вашему замечанию, остальные останутся как есть

Не подходит, если

  • В слайдах придется менять текст, диаграммы и фигуры по отдельности: возьмите OfficeCLI, он правит настоящие файлы PowerPoint
  • Нужна быстрая правка цифры в уже готовом файле: картинку не поправить без повторной генерации слайда
  • Нет подписки Codex и нет доступа к OpenAI-совместимому API для картинок: без бэкенда генерации скилл не сможет нарисовать слайды
  • Нужен строгий корпоративный шаблон с фиксированными макетами: скилл воспроизводит стиль по образцу картинками, а не макетами PowerPoint

Пример запроса к агенту

Используй скилл codex-ppt: сделай 12 слайдов в стиле «Научная защита» из файла thesis-summary.md, на слайды 4 и 7 вставь рисунки из папки figures, заметки с текстом выступления добавь

Ограничения

Доступ: расширенный. Скилл читает ваши материалы, создает папку проекта с outline.md, speech.md и картинками, запускает Python-скрипты и отправляет тексты слайдов и ваши исходные изображения в сервис генерации. Нужен python3. В Codex используется встроенная генерация картинок, а вне его (Claude Code, OpenClaw, Hermes Agent) нужен бэкенд с OpenAI-совместимым форматом: ключ, base URL и имя модели хранятся в ~/.codex-ppt-skill/.env. Для запасного пути по умолчанию задана модель gpt-image-2.5-flare, переключение на gpt-image-2.5-sunburst делается флагом --model. Слайды получаются изображениями, их элементы не редактируются; для конвертации автор предлагает отдельный скилл image-to-editable-ppt. Официальный OpenAI API может быть недоступен из вашей сети, тогда укажите совместимую точку доступа. Платных частей у самого скилла нет, расходы идут за генерацию картинок.

Как отключить. Удалите папку codex-ppt из каталога скиллов агента, например ~/.codex/skills/codex-ppt или ~/.claude/skills/codex-ppt, и перезапустите агента. Ключи и личная библиотека стилей лежат в ~/.codex-ppt-skill/ и удаляются отдельно.

Частые вопросы

Можно ли потом редактировать слайды?

Напрямую нет, слайды это картинки. Автор предлагает отдельный скилл image-to-editable-ppt для конвертации в редактируемый формат.

Обязателен ли Codex?

Нет. Скилл работает в любом агенте с поддержкой SKILL.md, но вне Codex нужно настроить совместимый с OpenAI image API, потому что встроенный инструмент генерации есть только в Codex.

Как установить скилл в Claude Code?

Выполните npx -y skills@latest add ningzimu/codex-ppt-skill --skill codex-ppt --agent claude-code --global. Скилл попадет в ~/.claude/skills/codex-ppt. После установки перезапустите агента и в запросе назовите скилл codex-ppt.

Как проверить, что генерация идет правильно?

После утверждения плана вы получите один пробный слайд: по нему видно стиль, ритм и качество текста. Готовые страницы лежат в origin_image под именами slide_01.png, slide_02.png, итоговый файл рядом с ними в папке проекта.

Чем это отличается от скиллов с редактируемыми PPTX?

Здесь страница рисуется моделью как единая картинка, поэтому макет и иллюстрации выходят цельными, но шрифты и блоки не редактируются. OfficeCLI из раздела CLI, напротив, создает и правит настоящие объекты Word, Excel и PowerPoint без генерации изображений.

Что делать, если один слайд вышел неудачным?

Попросите агента переделать только этот слайд: переделка одной страницы не требует перегенерации всей серии. Если нужен свой фирменный стиль, сохраните удачный в личную библиотеку ~/.codex-ppt-skill/references, она не стирается при обновлении скилла.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Скилл делает агента продюсером презентаций: бриф, раскадровка, постеры слайдов, проверка и PDF или редактируемый PPTX.

СкиллМинимальный доступ54Звезды репозитория

Скилл для Codex пересобирает слайд из картинки или PDF в PowerPoint, где текст, таблицы и стрелки правятся как обычные объекты.

СкиллРасширенный доступ141Звезды репозитория

Image to Editable PPT

Image to Editable PPT Skill

Нужен VPN

Скилл для Codex, который пересобирает слайды из картинок, PDF и растровых PPTX в редактируемую презентацию PowerPoint

СкиллРасширенный доступ3,3 тыс.Звезды репозитория

Скилл собирает редактируемые PowerPoint-колоды из outline.json скриптами и проверяет верстку и плотность до выдачи файла.

СкиллМинимальный доступ103Звезды репозитория
Нужен VPN

Скилл делает презентации через gpt-image-2: каждый слайд рисуется как цельный макет и собирается в .pptx, можно повторить стиль чужого шаблона

СкиллРасширенный доступ1,4 тыс.Звезды репозитория

Скилл для сборки презентаций из HTML-слайдов с рендером, визуальной проверкой каждого слайда и конвертацией в редактируемый PPTX

СкиллРасширенный доступ5,2 тыс.Звезды репозитория

Из блога

Коротко о README

README описывает скилл генерации презентаций из статей, отчетов, докладов и заметок в виде слайдов-картинок. Поддерживаются Codex, Claude Code, OpenClaw и Hermes Agent, в Codex доступен встроенный инструмент картинок, в остальных случаях настраивается совместимый с OpenAI endpoint. Установка идет через npx skills add с указанием агента или из релизного zip, ключи и стили хранятся вне каталога скилла и переживают обновления. Рабочий процесс поэтапный: план, стиль, бэкенд, пробный слайд, полный набор, сборка pptx. Есть встроенная библиотека визуальных стилей и возможность копить собственные. Лицензия MIT.

Бейдж для README

Исходный SKILL.md

---
name: codex-ppt
description: Generate visually unified image-based PPT/PPTX decks from articles, reports, papers, notes, or outlines.
metadata:
  openclaw:
    requires:
      bins:
        - python3
    primaryEnv: OPENAI_API_KEY
    envVars:
      - name: OPENAI_API_KEY
        required: false
        description: API key for CLI fallback.
      - name: OPENAI_BASE_URL
        required: false
        description: API base URL.
      - name: CODEX_PPT_IMAGE_MODEL
        required: false
        description: Image model, defaults to gpt-image-2.5-flare.
      - name: CODEX_PPT_HOME
        required: false
        description: Runtime home override.
    homepage: https://github.com/ningzimu/codex-ppt-skill
---

# Codex PPT

## Overview

This skill creates image-based PowerPoint decks from source material. Each slide is a complete 16:9 generated image. Final images are assembled into `.pptx` with `scripts/assemble_ppt.py`.

Use this when the user wants a visually unified presentation and accepts full-slide image pages. Do not use it when every textbox, chart, or shape must remain separately editable.

Prefer the built-in image generation/editing tool. Use `scripts/image_gen.py` only when the built-in backend is unavailable, lacks a required capability, or the user explicitly asks for API/CLI mode.

Сообщить о проблеме