perfecting-presentations

Reviews HTML slide decks through an iterative judge-verify-fix convergence loop against explicit standards.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/pgoell/pgoell-claude-tools --skill perfecting-presentations-pgoell
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: perfecting-presentations
Source: https://github.com/pgoell/pgoell-claude-tools/tree/main/plugins/deprecated/skills/perfecting-presentations
Command: npx skills add https://github.com/pgoell/pgoell-claude-tools --skill perfecting-presentations-pgoell

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Reviewing an HTML slide deck by eye tends to stop at "looks good", while self-graded review loops either approve too early or oscillate forever. This Skill defines a strict, convergent review process that only declares a deck done when deterministic checks pass and fresh reviewers stop finding verified issues. ## Core Features & Use Cases - Deterministic hard gates: Measures text overflow, overlap, broken images, console errors, banned characters, contrast, and font loading via browser probes, with no LLM judgment involved. - Adversarial review loop: Dispatches fresh judge subagents per dimension (narrative, clarity, visual, delivery), then adversarially verifies every finding against a written constitution before fixing. - Convergence with a ledger: Tracks rejected findings so they are never re-litigated, terminates after two dry rounds or a round cap, and writes a per-round report with honest verdicts. - Use Case: You have a finished HTML deck built with a deck-stage engine and want it polished before a talk; the Skill serves it over HTTP, screenshots every slide, runs the gates and review rounds, fixes confirmed issues, and reports the evidence for the final verdict. ## Quick Start Review and polish my existing HTML slide deck until it passes all hard gates and two consecutive review rounds find nothing new.

Frequently Asked Questions about perfecting-presentations

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

FAQPage Schema
How do I review an HTML slide deck automatically?

Serve the deck over HTTP, run deterministic probes for overflow, overlap, contrast, broken assets, and console errors, then capture per-slide screenshots. Fresh judge subagents review each dimension against a written standards file, and an adversarial verifier confirms each finding before fixes are applied.

How does the deck review loop know when to stop?

The loop terminates when all hard gates pass and two consecutive rounds produce zero verified findings at or above the severity threshold. A round cap (default 5) prevents infinite looping; if hit, it stops and reports the remaining open findings honestly.

Can this review decks not built with the deck-stage engine?

Yes, the loop works for any HTML deck once you identify the slide container and make all slides laid out for geometry probes. The deck-stage integration is the default, but the probes can be adapted to other engines.

Why do font or overflow checks give false failures offline?

Decks loading webfonts or icons from CDNs render with fallback fonts offline, which changes text metrics and triggers false overflow or font-loading failures. Run the hard gates online, or vendor the assets locally before measuring.

What is the difference between hard gates and soft gates in deck review?

Hard gates are deterministic browser measurements (clipped text, overlap, contrast, console errors) that fail objectively with no judging step. Soft gates are judged by fresh reviewer subagents against written rules covering narrative, clarity, visual design, and delivery.

When should I not use this presentation review skill?

Do not use it for designing deck content or first-pass rendering; it only reviews decks that already exist. It is also deprecated and superseded by presentations:creating-presentations, which includes this loop as an opt-in phase.