# 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.

Source: https://skillsagentes.com/skills/wshobson/agents/pptx-reference-deck-analysis
Repository: https://github.com/wshobson/agents
Author: wshobson
License: MIT
Updated: hace 27 días
Context cost: 42 tok installed, 689 tok once triggered, 6.4k tok with every bundled file
Bundle: 8 files, 25 KB
Permissions requested: none declared

## Install

```bash
npx -y skills add wshobson/agents --skill pptx-reference-deck-analysis --agent claude-code
```

## What it does

- Extrae evidencia de diseño de un PPTX de referencia: estructura, tema, tipografía, ritmo de layout y diagnósticos
- Genera catálogos de plantillas derivados con roles de layout, regiones usables y placeholders
- Inspecciona el paquete OOXML crudo (temas, relaciones, notas, comentarios, animaciones, media)
- Valida el paquete detectando XML malformado, relaciones rotas y partes huérfanas
- Registra partes inspeccionadas y excepciones de parseo en un manifiesto de análisis

## Use it when

- Necesitas analizar una deck PPTX de referencia de forma solo lectura
- Requieres extraer temas, tipografías, colores o ritmo de layout como evidencia de diseño
- Quieres un catálogo de plantillas derivado o diagnósticos de una carpeta de decks
- Necesitas inspeccionar partes OOXML crudas que la extracción de alto nivel no expone

## What triggers it

- "Analiza esta plantilla PPTX y dime su paleta de colores y tipografías"
- "Genera un catálogo de layouts derivado de este deck de referencia"
- "Valida el paquete OOXML de esta presentación en busca de relaciones rotas"
- "Inspecciona las notas, comentarios y animaciones de este PPTX"

## Before you install

- Instalar `defusedxml` desde `requirements.txt` antes de usar las utilidades OOXML incluidas.

## Files

- SKILL.md — 3 KB
- references/ooxml-parsing.md — 1 KB
- references/reference-deck-analysis-patterns.md — 1 KB
- references/reference-deck-analysis.md — 2 KB
- requirements.txt — 19 B
- scripts/inspect.py — 6 KB
- scripts/unpack.py — 3 KB
- scripts/validate_package.py — 9 KB

## SKILL.md

Reproduced verbatim from wshobson/agents under MIT. This section is the upstream document and is in English.

# 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 `layout_tree` 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/validate_package.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.
- Run the scripts from a trusted workspace; they reject path traversal, symlinks, oversized members, and archive bombs.
- Parse untrusted XML with `defusedxml`; do not enable entity expansion, DTD loading, or network access.
- Treat theme colors as tokens unless fully resolved against the color scheme.

See `references/reference-deck-analysis.md` for output shapes, `references/reference-deck-analysis-patterns.md` for documentation-only patterns, and `references/ooxml-parsing.md` for package part maps.

---

Skills Agentes — https://skillsagentes.com/skills/wshobson/agents/pptx-reference-deck-analysis