pptx-reference-deck-analysisавтор Seth Hobson

PPTX Reference Deck Analysis Skill.

Скилл для Claude Code и Codex для PPT и презентаций: анализирует референсный PPTX на тему, типографику, ритм макета и диагностику.

Presentations
Отчёт ревью

Скачать OpenDesign Инструкция по использованию

wshobson/agents · plugins/pptx-deck-creation/skills/pptx-reference-deck-analysis/SKILL.mdSKILL.md

--- name: pptx-reference-deck-analysis description: Use when analyzing a reference PPTX for read-only structure, theme, typography, layout rhythm, diagnostics, derived template catalogs, or safe OOXML package inspection. --- ## Contract ## Rules ## OOXML package inspection

Метаданные и заголовки разделов прочитаны из исходного файла 2026-09-14 · 2 755 символов полностью

01 Что делает

Что делает skill pptx-reference-deck-analysis в Claude Code и Codex

Сводка, рабочий процесс и результаты — всё прочитано из SKILL.md этого skill.

Из SKILL.mdПрочитано 14.09.2026 · не запись выполнения

Словами самого skill

Изучает референсный PPTX как проектную доказательную базу и намеренно никогда не копирует, не клонирует и не изменяет его. Небольшой локальный для задачи python-pptx скрипт выполняет необходимую извлечение по требованию, покрывая компактный контекст промпта (количество и размер слайдов, количество форм, брендовые сигналы, ритм макета), полное извлечение с доказательствами layout_tree только для чтения, диагностику папок, анализ мастер-стилей и производный каталог шаблонов с индексами источников от нуля.

Встроенные утилиты OOXML работают с исходными темами, связями, заметками, комментариями, анимациями, медиа, мастерами и макетами, а скрипты inspect.py, validate_package.py и unpack.py дают JSON-отчёт, валидацию пакета и опциональное извлечение исходного пакета. Каждая проверенная часть и ошибка разбора логируются в манифесте анализа, а извлечённые ресурсы не попадают в новые презентации без доказательства лицензии.

Что он выдаёт

Компактный контекст промпта: количество и размер слайдов, текстовые сводки, количество форм, стили, брендовые сигналы, использование шаблонов и ритм макета.
Полное извлечение сводки, слайдов и доказательств layout_tree только для чтения.
Анализ мастер-стилей, охватывающий цвета, шрифты, распределение размеров, использование мастеров/макетов и паттерны потока.
Производный каталог шаблонов с индексами источников от нуля, ролями макетов, используемыми областями, плейсхолдерами, визуальными структурами и ограничениями.

Смотрите пример запроса ↗

Как это работает

01
Напишите локальный для задачи Extractor
Необходимое извлечение реализуется по требованию с помощью небольшого скрипта python-pptx, а не фиксированного конвейера, поэтому захватывается только та информация, которая нужна новой презентации.
02
Запустите компактную проверку
scripts/inspect.py принимает путь к презентации и возвращает один JSON-отчёт, охватывающий порядок слайдов, текст, токены темы, связи, заметки, комментарии, анимации и медиа.
03
Переходите к утилитам OOXML
Встроенные утилиты — резервный путь для исходных тем, связей, заметок, комментариев, анимаций, медиа, мастеров и макетов, которые высокоуровневое извлечение не видит.
04
Привязывайте связи к владельцу .rels
Цели связей разрешаются относительно части, которая владеет файлом .rels, а порядок слайдов никогда не выводится из имён файлов.

02 Определите своё применение

Когда использовать skill pptx-reference-deck-analysis

Используйте skill pptx-reference-deck-analysis в Claude Code или Codex, когда работа касается PPT и слайд-колод такого рода. Применимость и ограничения ниже взяты из собственного файла skill.

Хорошо подходит

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

Знайте границы

Всё, что клонирует или изменяет исходную презентацию, а не только читает её.

Что предоставить

Путь к референсной презентацииВстроенные скрипты принимают .pptx как первый аргумент; это единственный обязательный ввод.
Каталог вывода для доказательств исходного пакетаunpack.py записывает извлечённые части в каталог, который вы указываете, и запускается только тогда, когда необходимы доказательства на уровне исходного пакета.
defusedxml из requirements.txtУстанавливается перед использованием любой встроенной утилиты OOXML.

03 Внутри скилла

Правила, которые skill pptx-reference-deck-analysis даёт Claude Code и Codex

6 конкретных инструкций, значений по умолчанию и ограничений, которые SKILL.md задаёт агенту, — та часть файла, которая меняет результат.

Держите исходный файл в режиме «только для чтения»
Референсная презентация никогда не редактируется, а каждая координата в новых целевых слайдах задаётся самостоятельно, а не наследуется.
Фиксируйте, что было проверено
Каждая проверенная часть и каждое исключение парсинга должны быть зафиксированы в манифесте анализа.
Никакого повторного использования без подтверждения лицензии
Извлечённый контент, шрифты, изображения и проприетарные активы не могут появляться в сгенерированной презентации без явного разрешения и подтверждения лицензии.
Запускайте из доверенного рабочего пространства
Скрипты отклоняют обход путей, символические ссылки, слишком большие элементы и «архивные бомбы», поэтому они рассчитаны на доверенный рабочий каталог.
Парсите XML с помощью Defusedxml
Недоверенный XML должен обрабатываться через defusedxml с полностью отключённым расширением сущностей, загрузкой DTD и доступом к сети.
Относитесь к цветам темы как к токенам
Цвет темы остаётся токеном до тех пор, пока не будет полностью разрешён относительно цветовой схемы.

04 Применение

Установите pptx-reference-deck-analysis в Claude Code или Codex

Одна команда npx skills add, затем первая задача в вашем агенте и чек-лист для результата.

Добавьте pptx-reference-deck-analysis в Claude Code, Codex или свой агент

Запустите в своём проекте; установщик спросит, какому агенту его добавить.

Terminal

npx skills add https://github.com/wshobson/agents --skill pptx-reference-deck-analysis

Общая форма CLI skills для plugins/pptx-deck-creation/skills/pptx-reference-deck-analysis/SKILL.md; в репозитории может быть указан собственный путь.

Дайте skill первую задачу с PPT и слайд-деками

Написано в терминах самого skill; замените части в квадратных скобках своим материалом.

Starter prompt

I have a reference deck at [path/to/reference.pptx]. Inspect it as design evidence and give me the compact prompt context, a style-master analysis of colors, fonts and flow patterns, and a derived template catalog with layout roles, usable regions and placeholders. Validate the package and record inspected parts and parsing exceptions in the manifest, keeping the source read-only.

Источник: составлено по SKILL.md в терминах самого skill.

Проверьте первый результат

Что сам SKILL.md считает правильным результатом:

Запустите validate_package.py с --output и прочитайте отчёт о некорректном XML, нарушенных внутренних связях, пробелах в типах содержимого, дублирующихся ссылках на макеты и осиротевших частях.

В OpenDesign импортируйте pptx-reference-deck-analysis по его ссылке на SKILL.md: Plugins → Add → Skill → Import from link, затем выберите его в верхней панели.

Скачать OpenDesign Читать quickstart

05 Открытый исходный код, проверяемость

Источник, лицензия и проверка

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

Author: Seth Hobson
Repository: github.com/wshobson/agents Ветка main
Файл skill: plugins/pptx-deck-creation/skills/pptx-reference-deck-analysis/SKILL.md Контрольная сумма содержимого записана при верификации; коммит 4236bb9
License: MIT Из LICENSE.
Звёзды репозитория: 39 635 Снимок GitHub от 2026-09-14 для всего репозитория wshobson/agents, который содержит 18 навыков в этом каталоге. Не является рейтингом или счётчиком использования для pptx-reference-deck-analysis.
Проверено OpenDesign: 2026-09-14 Исходный файл, путь, текст лицензии и количество звезд были проверены. Не входит в основной комплект OpenDesign (проверено 2026-08-28); живой запуск не был записан на этой странице.

Внутри SKILL.md

КонтрактПять результатов извлечения: контекст для промпта, полная выгрузка, диагностика папки, анализ style-master, каталог шаблонов.
ПравилаИсходник только для чтения, самостоятельно заданные координаты, логирование в манифест, подтверждение лицензии перед повторным использованием.
Проверка пакета OOXMLУстановите defusedxml, затем запустите inspect.py, validate_package.py и unpack.py; разрешите цели .rels.
БезопасностьДоверенное рабочее пространство, отклонение обхода путей и «архивных бомб», парсинг через defusedxml, цвета темы как токены.

Собственное описание skill

«Используйте при анализе эталонного PPTX для структуры только для чтения, темы, типографики, ритма вёрстки, диагностики, производных каталогов шаблонов или безопасной инспекции пакета OOXML.»

Описание из вводной части SKILL.md. Полный файл содержит около 2755 символов. Читать полный файл на GitHub.

06 Перед установкой

Вопросы о skill pptx-reference-deck-analysis

Ответы взяты из SKILL.md в редакции от 2026-09-14, а не из записанного запуска.

Изменится ли файл при анализе моей референсной презентации?

Нет. Skill никогда не изменяет предоставленную презентацию и никогда слепо не копирует части пакета в новую презентацию; исходник остаётся только для чтения, а новые слайды создаются самостоятельно.

PPTX Reference Deck Analysis

Запустите pptx-reference-deck-analysis на реальной задаче PPT и Slide Decks.

Скачайте OpenDesign, импортируйте pptx-reference-deck-analysis по ссылке на SKILL.md, вставьте промпт выше и прочитайте план перед результатом.

Загрузить OpenDesign Все навыки

Терминал

npx skills add https://github.com/wshobson/agents --skill pptx-reference-deck-analysis