pptx-html-fidelity-audit

Audit PPTX exports against HTML source decks for layout and typography drift.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/LucasOl1337/simple-ai --skill pptx-html-fidelity-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pptx-html-fidelity-audit
Source: https://github.com/LucasOl1337/simple-ai/tree/main/DesignTemplates/embedded/open-design/skills/pptx-html-fidelity-audit
Command: npx skills add https://github.com/LucasOl1337/simple-ai --skill pptx-html-fidelity-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python-pptx, and includes scripts (resource) and references (resource) components.

What problem does it solve?

PPTX exports generated from HTML slide decks often drift from the source, causing footer overlaps, italic/style mismatches, misaligned blocks, and other layout inconsistencies. This Skill provides a repeatable audit and repair workflow to detect and fix these drift patterns so the final PPTX faithfully mirrors the HTML deck.

Core Features & Use Cases

  • Automated ground-truth extraction: use scripts/extract_pptx.py to dump slide shapes, positions, and typographic runs.
  • Deterministic audit tables: produce a Step-3 style table of issues with severity to drive fixes, using verify_layout.py.
  • Footer-rail + cursor-flow discipline: enforce rails and centering rules to prevent content crossing rails and to keep hero slides centered.
  • Re-export workflow: adjust export constants and font rules, then verify with scripts/verify_layout.py before final delivery.

Quick Start

Audit a PPTX deck against its HTML source using scripts/extract_pptx.py and scripts/verify_layout.py to generate a validated re-export that adheres to the footer-rail and cursor-flow discipline.

Frequently Asked Questions about pptx-html-fidelity-audit

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

FAQPage Schema
Why does my PPTX export from HTML slides have overlapping footers and misaligned blocks?

PPTX exports from HTML decks often drift from the source, causing footer overlaps, italic mismatches, and layout inconsistencies. A fidelity audit detects these drift patterns so the final PPTX faithfully mirrors the original HTML deck.

How do I verify that my python-pptx deck matches the HTML source layout?

To verify python-pptx deck layout, use an extraction script to dump slide shapes and positions, then run a verification script to produce a deterministic audit table of issues with severity to drive fixes.

How do I check footer rails and hero centering in exported PPTX files?

You can check footer rails and hero centering in exported PPTX files by applying cursor-flow discipline and explicit rail rules during a layout audit. This prevents content crossing rails and keeps hero slides properly centered.

Can I use python-pptx to detect typography drift across multiple slides?

Yes, python-pptx can be used to detect typography drift across multiple slides. An extraction script dumps typographic runs, enabling a fidelity audit to check font-slot consistency and italic preservation across the deck.

What's the best way to fix italic preservation and font-slot inconsistencies in PPTX exports?

The best way to fix italic preservation and font-slot inconsistencies is to adjust export constants and font rules, then run a post-export verification script to confirm the layout matches the HTML source before final delivery.

When do I need a fidelity audit for PPTX files?

You need a fidelity audit for PPTX files when exporting HTML slide decks to PPTX using python-pptx and noticing layout drift. It enforces deterministic checks and post-export verification to ensure the final output matches the source.