К основному содержанию
скилл CX Codex

pptx-to-md — скилл для Claude Code: конвертер презентаций в Markdown

Скилл pptx-to-md для Claude Code превращает PPTX в Markdown: один файл на слайд, с текстом, позициями изображений и описанием диаграмм и скриншотов.

Apache-2.0 ★ 173 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add sammcj/agentic-coding --skill pptx-to-md -a claude-code
Открыть на GitHub

Что делает pptx-to-md

Скилл запускает конвейер из четырёх шагов: prepare.py разбирает PPTX, рендерит каждый слайд в JPG через LibreOffice, извлекает встроенные PNG и собирает манифест. Дальше ты запускаешь субагента на каждый слайд — он получает манифест, рендер и картинки, пишет один Markdown-файл. В конце concatenate.py склеивает всё в deck.md. Субагенты независимы и работают параллельно.

Скрипт prepare.py надо запускать вне песочницы — LibreOffice в headless-режиме пишет профиль пользователя, песочница это блокирует. В Claude Code добавь dangerouslyDisableSandbox: true для Bash-инструмента. Симптом сбоя: папка rendered/ пуста, deck_index.json не создан, хотя soffice работает на нулевой нагрузке. Скрытые слайды по умолчанию исключены, для их рендера передай флаг --include-hidden. Скилл предлагает сначала попробовать uvx 'markitdown[all]' <файл> -o output.md для простых текстовых презентаций или PDF.

Какие задачи решает

  • превратить презентацию с диаграммами в Markdown с описанием каждой картинки
  • извлечь контент PPTX в структурированный формат для дальнейшей обработки
  • сохранить позиции текста и скриншотов на слайдах при конвертации
  • распараллелить обработку большой презентации через субагентов
  • отфильтровать скрытые слайды или включить их в вывод

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

  • Преобразуй quarterly_report.pptx в Markdown, каждый слайд — отдельный файл, картинки опиши
  • Запусти конвейер pptx-to-md для pitch_deck.pptx, скрытые слайды не нужны
  • Сначала попробуй markitdown на slides.pptx, если не подойдёт — запусти полный пайплайн из скилла

Как установить pptx-to-md

1Через Skills CLI (Vercel)

npx skills add sammcj/agentic-coding --skill pptx-to-md -a claude-code

2Вручную: положить файлы

~/.claude/skills/pptx-to-md/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/pptx-to-md/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о pptx-to-md

Как установить pptx-to-md в Claude Code?

Выполни npx skills add sammcj/agentic-coding --skill pptx-to-md -a claude-code, затем проверь ~/.claude/skills/pptx-to-md/SKILL.md.

Что делает pptx-to-md?

Скилл конвертирует PPTX в Markdown по файлу на слайд: рендерит слайды в JPG, запускает субагента для каждого, который описывает картинки и сохраняет текст в исходных позициях, потом склеивает результат в один документ.

Почему prepare.py не создаёт rendered/ и deck_index.json?

LibreOffice в headless-режиме блокируется песочницей: для Claude Code добавь dangerouslyDisableSandbox: true в вызов Bash-инструмента. Без этого soffice работает, но ничего не рендерит.

Исходный текст

SKILL.md · Apache-2.0
---
name: pptx-to-md
description: Convert a PPTX slide deck into per-slide markdown that preserves both the verbatim text and the meaning of embedded screenshots, diagrams and charts in their original layout positions. Use this skill (over pptx or liteparse) whenever the deliverable is markdown of a deck's content including interpreted visuals.
---

# Extract PPTX to per-slide markdown

This skill turns a `.pptx` file into one markdown file per slide, preserving layout context and image meaning. It does not paraphrase the text or describe images out of context. The output is suitable as input to a content uplift pass, a markdown-to-HTML build, or any other downstream transform.

## When to use

The deck mixes text with embedded screenshots, diagrams, charts, or code samples in a layout that matters (columns, side-by-side panels, callouts). Plain text extraction would lose either the layout or the meaning of the images.

**IMPORTANT**: If the deck is: a PDF, text-only or if it has no images that are meaningful to the content, `uvx 'markitdown[all]' <path-to-file> -o output.md` is faster and usually sufficient without going through this skill's more complex pipeline as described below. You can try this and ask the user to review the output letting them know that if it's not sufficient you will continue with the more complex slide extraction pipeline.

## Pipeline

```
PPTX -> prepare.py -> manifests + rendered JPGs + embedded PNGs
     -> dispatch one sub-agent per slide
     -> per-slide markdown files
     -> concatenate.py -> deck.md
```

The orchestrator (you, in the calling session) does two things: run the prepare and concatenate scripts, and dispatch one sub-agent per visible slide. Each sub-agent does the actual vision-and-text composition for one slide and writes one markdown file. Sub-agents are independent so they parallelise cleanly.

## Step 1 - prepare the workspace

```
python <skill>/scripts/prepare.py <pptx-path> <workspace-dir>
```

This unzips the PPTX, renders every visible slide to a JPG via LibreOffice and `pdftoppm`, then writes one manifest JSON per visible slide. After rendering, the script checks the JPG count matches the slide count and warns to stderr if they diverge - LibreOffice has been known to silently drop slides, so always read that warning before dispatching sub-agents.

**Run this step OUTSIDE any command sandbox.** LibreOffice headless needs to write its per-user profile and set OS/task policies that a sandbox blocks, so under sandboxing `soffice` fails silently: no PDF, empty output, and no `deck_index.json`. Under Claude Code specifically, run `prepare.py` with the Bash tool's `dangerouslyDisableSandbox: true`. Symptom to recognise: `rendered/` stays empty and no `deck_index.json` is written while the `soffice` process sits at near-zero CPU.

The workspace looks like:

```
workspace/
  unpacked/                    raw OOXML
  rendered/                    PDF + ordered slide JPGs
  manifests/slideNN.json       per-slide manifest
  slide_images/slideNN.jpg     rendered whole-slide JPG (stable name)
  embedded_images/slideNN/     embedded PNGs grouped per slide
  slides/                      empty - sub-agents write slideNN.md here
  deck_index.json              {visible, hidden, src_to_render}
```

## Step 2 - pilot before scaling

Pick 2-4 slides that span the deck's variety: one dense, one with screenshots, one with a custom diagram, one with sparse text. Dispatch sub-agents for those first using the prompt template at `references/sub_agent_prompt.md`, and compare the output against the exemplar in `references/example_slide.md`. Adjust the deck-specific notes in the prompt if needed (terminology to keep verbatim, terms to flag, conventions to enforce). Only then fan out to the rest of the deck.

The pilot is not optional. Per-deck variation in image style, layout density, and terminology means a prompt that works perfectly for one deck may produce bland or duplicated output on another.

## Step 3 - dispatch sub-agents in parallel

For each visible slide, dispatch one fresh sub-agent (named subagent type, not a fork - the agent only needs its manifest, so a fresh context is cheaper than inheriting the orchestrator's history). Each agent reads its manifest, the rendered slide JPG, and the embedded PNGs, then writes one slideNN.md.

To get the dispatch list, run:

```
python <skill>/scripts/dispatch_list.py <workspace-dir>
```

This emits one tab-separated row per slide that still needs a sub-agent (slide_number, manifest_path, output_path), skipping slides whose markdown already exists. That makes reruns after a partial failure trivial - no slide is re-extracted unnecessarily.

Suggested batching: **6 sub-agents per wave**. Larger waves work but produce more interleaved completion notifications, which is noisier without being faster. Each sub-agent typically takes 20-50 seconds.

The exact prompt to send each agent is in `references/sub_agent_prompt.md`. Substitute the placeholders before sending using `str.replace()` (not `str.format()` - the template contains literal braces). The prompt's rules - length-tuned image descriptions, external-links de-duplication, single-line reply - are not stylistic; they were each added after a real failure mode in earlier runs. See the prompt template for the rationale.

## Step 4 - concatenate

```
python <skill>/scripts/concatenate.py <workspace-dir> [--out deck.md] [--title "Deck title"]
```

This stitches the per-slide markdown into a single `deck.md` in source-slide order with a header noting any hidden slides that were excluded. It refuses to run if any expected slide markdown is missing, which is the right behaviour - a partial deck is rarely what's wanted.

## Gotchas

**LibreOffice's PDF export skips hidden slides by default.** This means the rendered JPG index drifts from the source slide number. `prepare.py` builds a `src_to_render` map and copies each rendered JPG to a stable `slide_images/slideNN.jpg` path keyed by source slide number, so manifests reference a stable name. If you regenerate the renders later, rerun `prepare.py` so the mapping stays fresh.

**Speaker notes mapping is not always 1:1.** This skill reads the slide-to-notesSlide relationship from the slide's `_rels` file rather than assuming `slideN.xml` maps to `notesSlideN.xml`. Most decks happen to be 1:1 but it isn't guaranteed.

**Source XML can have typos.** The pipeline preserves them verbatim. Correct them in a later content-uplift pass, not during extraction - this keeps extraction deterministic.

**Hidden slides are excluded by default.** Most decks contain hidden slides for a reason (work-in-progress, deprecated content, internal-only notes). Pass `--include-hidden` only when you want them in the output - the script then renders them properly via LibreOffice's `ExportHiddenSlides` filter, so they get real JPGs in the manifests.

**Dense screenshots benefit from higher DPI.** The default is 150 DPI. For decks where text inside screenshots needs to be readable in the rendered JPG, pass `--dpi 200` or `--dpi 250` to `prepare.py`.

## Dependencies

- LibreOffice (`soffice`) on PATH
- Poppler (`pdftoppm`) on PATH
- Python 3.10+

The prepare script checks for both binaries and exits early with a clear error if either is missing.

© sammcj · Apache-2.0 · sammcj/agentic-coding

Похожие скиллы

Все скиллы по теме «Документы и офис» →
pptx официальный anthropics Создаёт, разбирает и редактирует файлы .pptx и .potx. Срабатывает при любых задачах со слайдами, шаблонами или презентациями. CX Codex +1 241 433установок html-to-ppt claude-office-skills Скилл html-to-ppt для Claude Code превращает Markdown или HTML в слайды PowerPoint, PDF и HTML через Marp. Собирает презентацию из готового текстового черновика. CX Codex +1 5 200установок office-productivity sickn33 Скилл office-productivity проводит агента через семь фаз офисной работы: от документов и таблиц до презентаций и конвертации форматов. CX Codex +1 1 600установок pptx-official davila7 Скилл pptx-official для Claude Code, который читает, редактирует и создаёт презентации .pptx. Распаковывает готовые файлы, меняет слайды, собирает новые по шаблону или с нуля, работает с макетами и заметками докладчика. CX Codex +1 257установок odp leiverkus Создаёт, разбирает, редактирует и восстанавливает презентации OpenDocument (.odp). Автоматизирует отчёты и конвертацию между ODP и PPTX. CX Codex +1 1установок pptx-slide-specification kimtth Скилл pptx-slide-specification помогает писать и чинить JSON-описание слайдов с точными координатами, чтобы PPTX собирался предсказуемо и оставался редактируемым. CX Codex +1 2 600установок

Из того же набора73

Весь набор →
excalidraw-diagrams Скилл excalidraw-diagrams создаёт и обновляет схемы Excalidraw через интерактивный просмотр MCP или локальный Python-скрипт. CX Codex +1 ★ 173звёзд репо idrive-backup Помогает проверять и менять настройки iDrive Backup на macOS, включая пути резервного копирования и исключения. При изменениях инструмент автоматически сохраняет копии конфигурации. CX Codex +1 ★ 173звёзд репо ghostty-config Скилл ghostty-config помогает настраивать терминал Ghostty: подсказывает синтаксис config.ghostty, валидирует параметры и учитывает отличия macOS и Linux. CX Codex +1 ★ 173звёзд репо release-debrief Скилл release-debrief для Claude Code сравнивает свежий релиз поддерживаемого инструмента с последней сохранённой сводкой. Разбирает изменения в Claude Code, OpenCode, llama-swap и llama.cpp. CX Codex +1 ★ 173звёзд репо web-artifacts-builder-v2 Скилл web-artifacts-builder-v2 собирает сложные HTML-артефакты на React с несколькими компонентами, состоянием или маршрутизацией. Он пригодится, когда нужен готовый автономный HTML-файл. CX Codex +1 ★ 173звёзд репо glean-cli Скилл glean-cli учит агента работать с CLI glean: искать по корпоративному индексу, спрашивать Glean Assistant, читать документы и карточки людей. CX Codex +1 ★ 173звёзд репо ai-changelog Скилл ai-changelog внедряет в репозиторий систему ведения CHANGELOG.md силами ИИ-агентов. Поддерживает SemVer, CalVer и датированные записи для проектов без сборщика. CX Codex +1 ★ 173звёзд репо rust-engineer Скилл rust-engineer на Claude Code настраивает помощника по Rust: от владения памятью и async-кода до тестов, Miri и оптимизации. Охватывает системные проекты. CX Codex +1 ★ 173звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой