102.7K+Download
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
Download OpenDesignView usage guide
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 defines a pre-delivery audit and repair workflow for editable PPTX decks: coordinate contracts, slide geometry, accessibility checks and OOXML package integrity. It requires evidence from the actual deck rather than treating the checklist as a guarantee.

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.

What it produces

  • A repaired PPTX when needed, alongside the spec and build record.
  • Geometry and accessibility audits, a production package-validation report and the source manifest.
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

    Check document language, slide titles, meaningful-image alt text, reading order, table headers and source references. Report checks actually performed and remaining limitations; this is not a general accessibility certification.

  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

Know the Boundaries

  • Requires companion tools and build inputsThe full audit uses references/audit-checklist.md and, for production, pptx-reference-deck-analysis/scripts/validate_package.py. The SKILL.md alone is not a validator.
  • Visual review is conditionalInspect previews only when a compatible renderer is already available. Do not install one merely to satisfy this workflow; disclose skipped visual checks.

What to Provide

  • Deck, spec and builderSupply paths to the PPTX, layout/coordinate specification, task-local builder and build record.
  • Source and audit pathsProvide the source manifest, expected audit locations and available companion checklist/package validator.

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. Obtain the companion audit checklist and production package validator with their runtime dependencies; a single-file import may not include them.

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
Audit [deck.pptx] against [spec/layout tree] and [builder], with [source manifest] and audit outputs at [directory]. Confirm the companion checklist and production package validator are available. Check geometry, native editability, source lineage and accessibility; save evidence. Repair the spec or task-local builder, rebuild and rerun failed checks. Use only an already available renderer and disclose skipped checks or blockers rather than claiming a pass.

Editorial starter prompt based on the dated SKILL.md snapshot; not a recorded execution or verified result.

Check the First Result

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

  • Compare reopened slide count, bounds, hidden slides and requested geometry with the layout tree.
  • Save the production package-validator JSON and inspect native editability plus the listed accessibility fields.
  • Inspect previews only with an already available compatible renderer, and disclose when this was not possible.
  • Keep the spec, deck, build record, audits and source manifest together; identify exceptions by slide/object, owner, reason and review date.

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

Download OpenDesignRead the quickstart

05 Open source, traceable

Source, License and Verification

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

Author
Seth Hobson
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?

It checks coordinate contracts and reopened slide geometry, native editability, source lineage, accessibility fields, and production OOXML package integrity through a companion validator. Its pass criteria require zero listed geometry and package errors; the page does not claim that a particular deck has passed.

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.

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