Agent skill · design visual · wshobson
pptx-reference-deck-analysis
Use when analyzing a reference PPTX for read-only structure, theme, typography, layout rhythm, diagnostics, derived template catalogs, or safe OOXML package inspection.
Why this skill is useful
Adds a Python script for extracting detailed structural and thematic analysis from PPTX files, which the AI wouldn't reliably generate on its own.
What it needs
Requires defusedxml installed locally. About 1k tokens when loaded. Last updated 2026-08-05. 38,570 stars on the source repository.
What this skill does
PPTX Reference Deck Analysis Inspect a reference deck as design evidence. This skill never copies, clones, or mutates a source deck. Contract Implement required extraction on demand with a small task-local python-pptx script. Capture only the information required for the new deck: compact prompt context: slide count and size, text summaries, shape counts, styles, brand signals, template use, and layout rhythm; full extraction: summary, slides, and read-only layouttree evidence; folder diagnostics: one result per deck plus a manifest; style-master analysis: colors, fonts, size distribution, master/layout use, and flow patterns; derived template catalog: zero-based source indices, layout roles, usable regions, placeholders, visual structures, and constraints. Rules Keep the source deck read-only and independently author every target-slide coordinate. Use the bundled OOXML utilities only for raw themes, relationships, notes, comments, animations, media, masters, or layouts that high-level extraction cannot expose. Record inspected parts and parsing exceptions in the analysis manifest. Do not use extracted content, fonts, images, or proprietary assets in a generated deck without explicit permission and license evidence. OOXML package inspection Install defusedxml from requirements.txt before using the bundled utilities. 1. Run scripts/inspect.py <deck.pptx> for a compact JSON report of slide order, text, theme tokens, relationships, notes, comments, animations, and media. 2. Run scripts/validatepackage.py <deck.pptx> --output <report.json> for malformed XML, broken internal relationships, content-type gaps, duplicate layout links, and orphaned parts. 3. Run scripts/unpack.py <deck.pptx> <output-dir> only when raw-package evidence is necessary. 4. Resolve relationship targets relative to the .rels owner; never infer slide order from filenames. Safety Never modify a supplied deck or blindly copy package parts into a new deck. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills wshobson/pptx-reference-deck-analysis