Skip to the usage guide
pptx-quality-gatesby Seth Hobson

PPTX Quality Gates Skill.

A Claude Code and Codex skill for PPT and slide decks: validates and repairs editable PPTX decks for geometry, accessibility, and package integrity.

  • Presentations
  • PPTX
wshobson/agents · plugins/pptx-deck-creation/skills/pptx-quality-gates/SKILL.mdSKILL.md
--- name: pptx-quality-gates description: Use when validating or repairing an editable PPTX deck for geometry, accessibility, native editability, source lineage, and OOXML package integrity. --- ## Workflow ## Required artifacts ## Pass criteria
Front matter and section headings read from the upstream file on 2026-09-14 · 1,635 characters in full

01 What it does

What the pptx-quality-gates Skill Does in Claude Code and Codex

Summary, workflow and outputs, all read from the skill's SKILL.md.

From the SKILL.mdRead 2026-09-14 · not a recorded run

In the Skill's Own Terms

This skill validates and repairs editable PPTX decks before delivery, checking geometry coordinate contracts, accessibility compliance, and OOXML package integrity. It applies an audit checklist to verify slide counts, actual bounds, hidden slides, text overflow, content collisions, and native editability.

For production decks it runs a Python validation script and saves a JSON report. When validation fails, it repairs the spec or builder, rebuilds the deck, and reruns the same checks until zero errors remain. All artifacts—spec, PPTX, build record, geometry audit, accessibility audit, package report, and source manifest—are kept together.

PPTX
See the example prompt ↗

How It Works

  1. 01
    Confirm File Paths and Artifacts

    Before validation begins, the skill confirms the locations of the spec, builder, PPTX file, source manifest, and audit paths so all required materials are available.

  2. 02
    Apply Coordinate Contract Audit Before Building

    The skill applies the audit checklist from references/audit-checklist.md to the coordinate contract before the deck is built, catching geometry issues early.

  3. 03
    Compare Reopened PPTX with Layout Tree

    After building, the skill reopens the PPTX and compares slide count, actual bounds, hidden slides, and requested geometry against the layout tree to detect discrepancies.

  4. 04
    Run Package Validation Script for Production

    For production decks, the skill runs the validate_package.py script from pptx-reference-deck-analysis and saves the resulting JSON report.

  5. 05
    Check Accessibility Compliance

    The skill verifies document language, slide titles, meaningful-image alt text, reading order, table headers, and source references to ensure accessibility standards are met.

  6. 06
    Repair and Rebuild on Failure

    When validation finds errors, the skill repairs the spec or task-local builder, rebuilds the deck, and reruns all checks until the deck passes.

02 Find your fit

When to Use the pptx-quality-gates Skill

Use the pptx-quality-gates skill in Claude Code or Codex when the job is PPT and slide decks of this kind. Fit and limits below are taken from the skill's own file.

Good Fit

  • When validating or repairing an editable PPTX deck for geometry, accessibility, native editability, source lineage, and OOXML package integrity

    03 Inside the skill

    Rules the pptx-quality-gates Skill Gives Claude Code and Codex

    7 concrete instructions, defaults and limits the SKILL.md sets for the agent — the part of the file that changes the result.

    1. Use Before Delivery

      This skill must be applied before delivering any generated PPTX to ensure quality gates are met.

    2. Treat Failures as Repair Work

      Deterministic validation failures are treated as repair opportunities, not exceptions to be logged and ignored.

    3. Never Add Renderer Dependencies

      When inspecting previews for clipping, font fallback, contrast, crop, and hierarchy, the skill only proceeds if a compatible renderer is already available and never adds one as a new dependency.

    4. Keep All Artifacts Together

      The spec, PPTX, build record, geometry audit, accessibility audit, package report, and source manifest must be maintained as a complete set.

    5. Document All Exceptions with Full Metadata

      Any documented exception must include slide ID, object ID, owner, reason, and review date for traceability.

    6. Zero-tolerance Pass Criteria

      The deck must have zero content collisions, text overflows, unsafe content bounds, invalid positive geometry, and package-integrity errors to pass.

    7. Preserve Native Editability

      Meaningful slide content must remain as native editable objects; images are used to support content, not replace it.

    04 Put it to work

    Install pptx-quality-gates in Claude Code or Codex

    One npx skills add command, then a first task in your agent and a checklist for the result.

    Add pptx-quality-gates to Claude Code, Codex or Your Agent

    Run in your project; the installer asks which agent to add it to.

    Terminal
    npx skills add https://github.com/wshobson/agents --skill pptx-quality-gates

    Generic skills CLI form for plugins/pptx-deck-creation/skills/pptx-quality-gates/SKILL.md; the repository may document its own path.

    Give the Skill a First PPT and Slide Decks Task

    Written in the skill's own terms; replace the bracketed parts with your material.

    Starter prompt
    Validate the generated deck [output.pptx] using the spec [deck-spec.yaml] and builder [builder.py] before client delivery. Run the full quality gate workflow including coordinate contract audit from references/audit-checklist.md, package integrity validation with validate_package.py, and accessibility checks for alt text and reading order. Keep all artifacts together and repair any failures until zero errors remain.

    Source: written from the SKILL.md in the skill's own terms.

    Check the First Result

    What the SKILL.md itself says a correct result looks like:

    • When a renderer is available, inspect previews for clipping, font fallback, contrast, crop, and hierarchy problems

    In OpenDesign import pptx-quality-gates from its SKILL.md link: Plugins → Add → Skill → Import from link, then pick it in the top bar.

    05 Open source, traceable

    Source, License and Verification

    Where this page's facts come from, and when they were last checked.

    Repository
    github.com/wshobson/agents Branch main
    Skill file
    plugins/pptx-deck-creation/skills/pptx-quality-gates/SKILL.md Content checksum recorded at verification; commit 4236bb9
    License
    MIT From LICENSE.
    Repository stars
    39,635 GitHub snapshot taken 2026-09-14 for the whole wshobson/agents repository, which contains 18 skills in this catalog. Not a rating or usage count for pptx-quality-gates.
    Verified by OpenDesign
    2026-09-14 Source file, path, license text and star count were checked. Not bundled in OpenDesign main (checked 2026-08-28); a live run has not been recorded on this page.

    Inside the SKILL.md

    1. WorkflowSeven-step validation process from confirming paths to repairing and rebuilding failed decks
    2. Required artifactsSpec, PPTX, build record, audits, package report, and source manifest kept together with documented exceptions
    3. Pass criteriaZero tolerance for collisions, overflows, bounds errors, geometry issues, and package errors; native editability preserved
    The Skill's Own Description
    “Use when validating or repairing an editable PPTX deck for geometry, accessibility, native editability, source lineage, and OOXML package integrity.”

    Front-matter description from SKILL.md. The full file is about 1,635 characters. Read the full file on GitHub.

    06 Before you install

    Questions About the pptx-quality-gates Skill

    Answers come from the SKILL.md as read on 2026-09-14, not from a recorded run.

    What does this skill validate in a PPTX deck?

    The skill validates geometry through coordinate contracts and layout tree comparison, accessibility by checking document language, slide titles, alt text, reading order, table headers, and source references, and package integrity by running validate_package.py for production decks. It ensures zero content collisions, text overflows, unsafe content bounds, invalid positive geometry, and package-integrity errors.

    PPTX Quality Gates

    Run pptx-quality-gates on a Real PPT and Slide Decks Task.

    Download OpenDesign, import pptx-quality-gates from its SKILL.md link, paste the prompt above, and read the plan before the result.

    Terminal
    npx skills add https://github.com/wshobson/agents --skill pptx-quality-gates

    OpenDesign Desktop

    One design system. Every output unmistakably your brand

    Inside the full Vibe Design Workspace, use the same brand rules across websites, slide decks, interactive prototypes, dashboards, images, and HTML video. Connect Codex, Claude Code, Cursor, and other coding agents already on your computer, then create locally for free.

    • Web, slides, prototypes, dashboards, images, and video
    • 140+ design systems, plus the full template and skill library
    • Connect local Codex and 21+ coding agents · Free to use
    Download free

    Available for macOS and Windows