pptx-slide-specification — скилл для Claude: JSON-спека PPTX
Скилл помогает писать и чинить JSON-описание слайдов с точными координатами, чтобы PPTX собирался предсказуемо и оставался редактируемым.
/plugin marketplace add wshobson/agents
/plugin install pptx-deck-creation@claude-code-workflowsЧто делает pptx-slide-specification
Скилл задаёт контракт для JSON-файла, из которого потом собирается презентация. Корень содержит summary и slides, у каждого слайда есть стабильный id, заголовок, порядок чтения для доступности и полное дерево layout_tree. В дереве прописаны размер слайда, корневая группа, группы и объекты по ключам-id, финальные bbox в дюймах, стили, z-index и классификации.
Авторские правила простые. ID читаемые и стабильные, размеры положительные, обычный контент держится внутри безопасного поля и выше футера, а на всю ширину выходят только фоновые объекты layout_design. Текст, фигуры, линии, таблицы и картинки — нативные объекты, подписи и значения из картинок пересобираются вручную. Кегль не ниже 9 pt: плотный текст лучше сократить или разбить, чем уменьшать шрифт. У значимых изображений есть alt-текст.
Сборка идёт от пустого макета, все bbox мапятся через Inches(...), явно выставляются переносы, отключённый авторазмер, отступы, выравнивание, шрифты и цвета. Нулевую или отрицательную геометрию скилл отбрасывает до добавления объекта. Ставьте, если делаете редактируемые колоды из данных и устали ловить съехавшие блоки. Для пары слайдов вручную это лишняя возня.
Какие задачи решает
- собрать редактируемый PPTX из JSON-описания слайдов
- починить съехавшие координаты в существующей спеке
- задать безопасные поля и нижнюю границу контента
- пересобрать подписи с картинки в нативные объекты
- проверить bbox и z-index до сборки колоды
Примеры запросов агенту
- Составь JSON-спеку для колоды из 6 слайдов, координаты в дюймах, контент внутри safe margin
- Проверь layout_tree: найди объекты с нулевым или отрицательным размером и почини их
- Добавь alt-текст значимым изображениям и source_ref для цифр на слайдах
Как установить pptx-slide-specification
1Через маркетплейс плагинов
/plugin marketplace add wshobson/agents/plugin install pptx-deck-creation@claude-code-workflows2Через Skills CLI (Vercel)
npx skills add wshobson/agents --skill pptx-slide-specification -a claude-code3Вручную: положить файлы
~/.claude/skills/pptx-slide-specification/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/pptx-slide-specification/
1Через Skills CLI (Vercel)
npx skills add wshobson/agents --skill pptx-slide-specification -a codex2Вручную: положить файлы
.agents/skills/pptx-slide-specification/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add wshobson/agents --skill pptx-slide-specification -a cursor2Вручную: положить файлы
.cursor/skills/pptx-slide-specification/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install wshobson/agents pptx-slide-specification2Вручную: положить файлы
.github/skills/pptx-slide-specification/SKILL.mdКомандой платформы
gemini skills install https://github.com/wshobson/agents --path plugins/pptx-deck-creation/skills/pptx-slide-specificationВручную: положить файлы
.devin/skills/pptx-slide-specification/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Похожие
Вопросы о pptx-slide-specification
Как установить pptx-slide-specification в Claude?
Через маркетплейс: /plugin marketplace add wshobson/agents, затем /plugin install pptx-deck-creation@claude-code-workflows. Либо напрямую: npx skills add wshobson/agents --skill pptx-slide-specification -a claude-code.
Что делает pptx-slide-specification?
Описывает контракт JSON-спеки для PPTX: обязательные поля слайда, дерево layout_tree с финальными bbox, стили и z-index. По этой спеке потом собирается колода.
Что нужно для работы скилла?
JSON с полями summary и slides и сборщик, который мапит bbox через Inches(...). Скилл требует явных настроек переносов, авторазмера и отступов, а геометрию с нулём или минусом отклоняет.
Исходный текст
SKILL.md · MIT
--- name: pptx-slide-specification description: "Use when authoring or repairing a coordinate-explicit JSON specification for an editable PPTX deck." --- # PPTX Slide Specification Author final coordinates directly in `layout_tree`. No renderer may decide placement, shrink text, or infer layout after the audit. ## Required contract - The root JSON contains `summary` and `slides`. - Every slide has a stable `id`, a message-led `title`, an accessibility reading order, and a complete `layout_tree`. - A layout tree declares slide size, root group, id-keyed groups and objects, final inch bboxes, styles, z-indexes, and classifications. - Every meaningful object has `id`, `kind`, `role`, `classification`, `content`, `style`, `bbox`, and `z_index`. - Production `summary` contains an explicit `layout_policy` (safe margin, content bottom, footer top, minimum gap) and accessibility metadata. ## Authoring rules 1. Use stable readable IDs, absolute groups, and positive inch dimensions. 2. Keep normal content inside the safe margin and above the footer rail. Only background `layout_design` objects may be full bleed. 3. Use native `text`, `shape`, `line`, `table`, and `image` objects. Recreate labels and values from any supporting visual as native objects. 4. Give meaningful images alt text. Record `source_ref` for sourced claims. 5. Keep content text at 9 pt or greater; shorten, resize, or split dense content before reducing type. 6. Use shared grids, consistent gaps, explicit color, explicit font size, and an intentional z-order. ## Build contract A task-local builder starts from a blank slide layout and maps all bboxes with `Inches(...)`. Explicitly set wrapping, disabled auto-size, text insets, anchors, alignment, fonts, colors, line settings, image aspect ratio, and hidden-slide state. Reject zero or negative geometry before adding an object. See `references/layout-contract.md` for the compact schema and repair guidance.
© kimtth · MIT · wshobson/agents
