pptx-reference-deck-analysis

Inspects PPTX decks read-only to extract structure, theme, typography, and layout evidence.

39.3k|4.2k|Updated Jul 24, 2025
One-click install
npx skills add https://github.com/wshobson/agents --skill pptx-reference-deck-analysis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pptx-reference-deck-analysis
Source: https://github.com/wshobson/agents/tree/main/plugins/pptx-deck-creation/skills/pptx-reference-deck-analysis
Command: npx skills add https://github.com/wshobson/agents --skill pptx-reference-deck-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires defusedxml, and includes scripts (resource) and references (resource) components.

What problem does it solve?

When building a new presentation inspired by an existing deck, you need to understand the reference deck's structure, theme colors, fonts, and layout patterns without copying or mutating the source file. This Skill performs safe, read-only analysis of PPTX packages and produces structured evidence for authoring an independent deck.

Core Features & Use Cases

  • Read-only deck inspection: Extract slide count, slide size, text summaries, shape counts, theme colors, fonts, and layout rhythm using task-local python-pptx scripts.
  • OOXML package diagnostics: Run bundled scripts to inspect relationships, notes, comments, animations, and media, validate package integrity, and safely unpack raw XML parts.
  • Derived template catalog: Produce a zero-based catalog of source slides with layout roles, usable regions, placeholders, and reuse constraints to guide new deck authoring.
  • Use Case: Given a client's brand reference deck, generate a style-master analysis of palette, typography, and master/layout usage, then author a new presentation with independently computed coordinates.

Quick Start

Analyze the attached reference deck 'brand-deck.pptx' and produce a style summary with theme colors, fonts, and a derived template catalog for my new presentation.

Frequently Asked Questions about pptx-reference-deck-analysis

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze a PPTX file's theme and fonts in Python?

Parse the theme part (commonly ppt/theme/theme1.xml) inside the PPTX ZIP package and read the color scheme and major/minor latin font entries. The bundled inspect.py script outputs theme colors and fonts as JSON without modifying the deck.

How to extract slide text and structure from a PowerPoint file?

Resolve slide order from ppt/presentation.xml and its relationships rather than filenames, then read each slide part's text runs and shape counts. The inspect.py script produces a compact JSON report of slides, text, shapes, notes, and media.

Can I inspect a PPTX file without modifying it?

Yes. All bundled scripts open the package read-only, and the Skill's rules forbid mutating the source deck or copying package parts into a new deck. Validation and unpacking only write separate report files or output directories.

Is it safe to parse untrusted PPTX files with Python?

Yes when using defusedxml, which blocks entity expansion and DTD loading attacks. The scripts also reject symlinks, path traversal, oversized members, and archive bombs, and restrict inputs to the current workspace.

Why does my PPTX have broken relationships or orphaned parts?

Decks edited by multiple tools can contain missing relationship targets, duplicate slide IDs, or unreferenced media. Run validate_package.py to get a JSON report of malformed XML, broken internal relationships, content-type gaps, and orphaned parts.