pptx-quality-gates

name	pptx-quality-gates
description	Validate and repair editable PPTX artifacts, including layout, package, accessibility, and visual checks.

PPTX Quality Gates

Prerequisite: Apply the manual audit in references/audit-checklist.md. Use pptx-reference-deck-analysis for reference-deck analysis, OOXML package inspection, and package validation.

Use this skill before considering a generated PPTX complete.

Workflow

1. Confirm required artifacts exist or collect missing paths before validating.
2. Confirm the python-pptx build script applies the spec-to-PPTX build contract (word-wrap on, autofit off, zeroed text insets, explicit anchors) so the rendered deck matches the spec.
3. Load references/audit-checklist.md and apply the specification checks.
4. Reopen the PPTX and check actual shape bounds, slide count, package structure, and hidden-slide state.
5. For production decks, run pptx-reference-deck-analysis/scripts/validate_package.py <deck.pptx> --output <report.json> and save the package report.
6. Check accessibility metadata and inspect rendered previews when a compatible renderer is available.
7. Repair the spec or generation script, rebuild the PPTX, and rerun the checks.
8. Stop only when the layout, editable-content, package, and accessibility checks pass or the remaining exception is clearly reported.

Required Artifacts

• If required artifact paths or names are missing, collect them with the VS Code prompt input dialog (vscode_askQuestions or equivalent) before building, validating, or repairing.
• Keep the generated spec, PPTX, and audit together: deck-spec.json, deck.pptx, and deck-audit.json.