Slide Deck Visual Audit Report

Problem/Feature Description

A design consultancy manages dozens of PowerPoint presentations for their clients, organized in subdirectories by client name. The directories contain real presentations mixed with files that shouldn't be analyzed — static exports, accidental duplicates, and conference templates. They need a visual design audit across all the real presentations.

The presentations are in a directory tree with client subdirectories. Each real presentation has varied content: different background colors, multiple fonts, auto-shapes like callouts and starbursts, footer text at the bottom of slides, and speaker notes. The junk files (static exports, conflict copies, templates) should be filtered out automatically.

Produce a structured JSON audit report covering every valid presentation file, with per-slide visual data and global design statistics. Skip files that aren't real presentations.

Output Specification

Produce the following files:

1. extraction_results.json — A structured JSON audit of the test directory containing:

   • Per-file results for each valid presentation (skipping the junk files)
   • Per-slide data: background colors, fonts used, shapes present, layout info, speaker notes presence, footer text
   • Global design statistics: font frequency, background color frequency, color sequence across all slides
   • Shape type detail — not just "shape" but what kind (callouts, starbursts, etc.)

2. run_log.txt — A log showing which files were processed and which were skipped, with reasons

Setup

Install python-pptx before starting:

pip install python-pptx

Download the test deck directory tree from the project repository. The files must keep their original names (the skip logic depends on filename patterns):

mkdir -p test_decks/acme-corp test_decks/beta-inc
curl -L -o "test_decks/acme-corp/Q1 Review.pptx" "https://github.com/jbaruch/speaker-toolkit/raw/main/eval-resources/scenario-0/acme-corp/Q1%20Review.pptx"
curl -L -o "test_decks/acme-corp/Q1 Review static.pptx" "https://github.com/jbaruch/speaker-toolkit/raw/main/eval-resources/scenario-0/acme-corp/Q1%20Review%20static.pptx"
curl -L -o "test_decks/acme-corp/Q1 Review (1).pptx" "https://github.com/jbaruch/speaker-toolkit/raw/main/eval-resources/scenario-0/acme-corp/Q1%20Review%20(1).pptx"
curl -L -o "test_decks/beta-inc/Product Launch.pptx" "https://github.com/jbaruch/speaker-toolkit/raw/main/eval-resources/scenario-0/beta-inc/Product%20Launch.pptx"
curl -L -o "test_decks/beta-inc/Presentation Template 2024.pptx" "https://github.com/jbaruch/speaker-toolkit/raw/main/eval-resources/scenario-0/beta-inc/Presentation%20Template%202024.pptx"

The test directory contains:

• test_decks/acme-corp/Q1 Review.pptx — 4 slides: purple/red/yellow/green backgrounds, Impact + Arial + Bangers fonts, cloud callout and explosion shapes, footer text, speaker notes
• test_decks/acme-corp/Q1 Review static.pptx — static export (should be skipped)
• test_decks/acme-corp/Q1 Review (1).pptx — Google Drive conflict copy (should be skipped)
• test_decks/beta-inc/Product Launch.pptx — 3 slides: blue/orange/salmon backgrounds, Georgia + Verdana fonts, footer text on every slide, speaker notes on 2 slides
• test_decks/beta-inc/Presentation Template 2024.pptx — template file (should be skipped)