ppt-visual-qa

Analyze PPT decks for quality issues and contract-alignment risks.

2|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/hailingu/llm-prompts --skill ppt-visual-qa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ppt-visual-qa
Source: https://github.com/hailingu/llm-prompts/tree/main/skills/ppt-visual-qa
Command: npx skills add https://github.com/hailingu/llm-prompts --skill ppt-visual-qa

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright, beautifulsoup4, pyyaml, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

PPT decks often suffer from inconsistent visuals and overlooked quality checks. The ppt-visual-qa skill provides an automated, gate-based QA system that surfaces structural, content, chart, layout, visual, and brand risks across slides, driving reliable presentation quality.

Core Features & Use Cases

  • 80+ gates across structural, content, chart, layout, visual, brand, and post-generation checks
  • Runtime profiling across viewport+dpr profiles and per-slide reporting to guide repairs
  • Supports draft and production modes with recovery guidance and contract-aligned outputs

Quick Start

Run the ppt-visual-qa runner against your slide-*.html set to generate a per-slide QA report and a summarized QA overview.

Frequently Asked Questions about ppt-visual-qa

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

FAQPage Schema
How do I automate PPT visual QA checks across multiple slides?

Automate PPT visual QA by running a gate-based runner against your slide HTML files to generate per-slide reports. It applies 80+ automated checks covering structural, content, chart, layout, visual, and brand consistency risks.

What is gate-based presentation quality checking and how does it work?

Gate-based presentation quality checking uses a YAML-defined gate matrix to evaluate slides against specific thresholds. It profiles slides across multiple viewport and dpr profiles, outputting a structured JSON report with actionable repair guidance.

Does the visual QA gate check support HTML slide decks for brand consistency?

Yes, the visual QA gate check supports HTML slide decks and includes dedicated brand consistency gates. It evaluates slides against brand rules and surfaces alignment risks, ensuring stakeholder buy-in through reliable presentation quality.

Can I use Playwright to profile PPT slides across different viewport profiles?

Yes, the system uses Playwright to perform runtime profiling across viewport and dpr profiles during PPT slide analysis. This enables accurate visual quality assessment and generates per-slide reports to guide repairs.

What's the best way to generate a structured QA report for presentation slides?

The best way to generate a structured QA report is running the automated runner against your slide HTML set. It produces a per-slide QA report and a summarized overview, leveraging a YAML gate matrix for contract-aligned outputs.

When should I use draft mode vs production mode for slide deck QA?

Use draft mode for early slide deck QA iterations with recovery guidance, and production mode for final contract-aligned outputs. Both modes apply the 80+ gates to surface structural and visual risks, ensuring reliable presentation quality before stakeholder review.