PPTX Quality Gates

SkillDocs & knowledge

Lets your agent check and fix PowerPoint files for layout problems, accessibility, editability, and file integrity.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the PPTX Quality Gates skill

About this capability

Use when validating or repairing an editable PPTX deck for geometry, accessibility, native editability, source lineage, and OOXML package integrity.

What this skill tells your AI

The instructions your AI receives, as published by wshobson/agents in plugins/pptx-deck-creation/skills/pptx-quality-gates/SKILL.md and read by ahel’s review.

Use this skill before delivering a generated PPTX. Treat deterministic failures as repair work, not exceptions.

Workflow

  1. Confirm the spec, builder, PPTX, source manifest, and audit paths.
  2. Apply references/audit-checklist.md to the coordinate contract before building.
  3. Reopen the PPTX and compare slide count, actual bounds, hidden slides, and requested geometry with the layout tree.
  4. For production decks, run pptx-reference-deck-analysis/scripts/validate_package.py and save the JSON report.
  5. Check document language, slide titles, meaningful-image alt text, reading order, table headers, and source references.
  6. When a compatible renderer is already available, inspect previews for clipping, font fallback, contrast, crop, and hierarchy. Do not add a renderer dependency.
  7. Repair the spec or task-local builder, rebuild, and rerun the same checks.

Required artifacts

Keep the spec, PPTX, build record, geometry audit, accessibility audit, package report, and source manifest together. Report any documented exception with slide ID, object ID, owner, reason, and review date.

Pass criteria

Zero content collisions, text overflows, unsafe content bounds, invalid positive geometry, and package-integrity errors. Meaningful slide content must remain native editable objects; images support rather than replace it.

See references/audit-checklist.md for the complete checklist.

Signals

GitHub stars
40k
Forks
4k
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
pptx-quality-gates
Source
github.com/wshobson/agents