ppt-deck-pro-max

Orchestrates multi-stage production of commercial PPTX and HTML slide decks from business briefs.

41|1|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/MainQuestAI/PPT-Deck-Pro-Max --skill ppt-deck-pro-max-mainquestai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ppt-deck-pro-max
Source: https://github.com/MainQuestAI/PPT-Deck-Pro-Max
Command: npx skills add https://github.com/MainQuestAI/PPT-Deck-Pro-Max --skill ppt-deck-pro-max-mainquestai

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? AI-generated slide decks often lack narrative structure, visual depth, and real evidence, producing generic text-in-boxes output. This Skill manages the full deck production lifecycle — brief, narrative arc, visual composition, asset capture, build, and QA — so the final deck is commercially persuasive and self-explanatory. ## Core Features & Use Cases - Forced 8-step pipeline with gates: Brief, vibe, narrative arc, layout, compression, visual composition, build, and QA, with structured rollback routing when review fails. - Expert Mode interview: Extracts claims from source material, detects 5 gap types (case, causal, data, contrast, objection), and runs a coverage-driven interview to enrich content with real numbers and cases. - Visual composition specs: Generates per-page visual construction specs (chart types, icons, illustrative data, layout proportions) so build tools receive concrete instructions instead of raw text. - Asset pipeline and QA: Playwright screenshot capture, Pillow device mockups, concept UI skeletons, and 25+ automated QA checks including commercial scoring and geometry stability. - Use Case: Given a 30-page solution brief, initialize a 12-page deck project, run the expert interview to fill content gaps, generate visual specs, build via a PPTX/HTML build tool, and pass formal QA with a commercial scorecard. ## Quick Start Initialize a new deck project by running scripts/run_deck_pipeline.py init with your project directory, page count, and preset, then follow the gated workflow through build and QA.

Frequently Asked Questions about ppt-deck-pro-max

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

FAQPage Schema
How do I create a commercial slide deck from a business brief with AI?

Initialize a project with run_deck_pipeline.py init, specifying page count, preset, and production mode. The pipeline then walks through brief locking, narrative arc, visual composition, build, and QA, with each stage gated before the next begins.

What is the difference between expert mode and quick mode?

Expert mode adds a structured interview step that extracts claims from source material, detects five knowledge gap types, and collects real cases and data from a domain expert before drafting. Quick mode skips the interview and behaves like the v1.x pipeline, suiting smaller or low-risk decks.

Does this skill generate PPTX files directly?

No, it is an orchestration layer that sits above build tools. It produces briefs, visual specs, and QA artifacts, then hands off to build skills such as slides, frontend-design, or officeCLI to generate the actual PPTX or HTML output.

What Python dependencies are required to run the deck pipeline?

The core pipeline requires Python 3.10+ with python-pptx, Pillow, and jsonschema. Playwright is optional and only needed for automatic screenshot capture and page-level visual QA.

What happens when deck QA fails?

Failed checks produce structured findings that are routed to a rollback plan identifying the upstream stage, files to edit, and the responsible AI role. For example, overly long copy rolls back to clean pages, while unstable geometry rolls back to layout rules or page skeletons.

When should I not use this deck production skill?

Avoid it for small edits to an existing PPTX, one-slide fixes, simple document-style presentations, or pure slide reading tasks. Use dedicated PPTX inspection or direct slide creation tools for those cases instead.