presentation

Author review-gated Slidev decks from normalized briefs with deterministic lint and pixel-based critic approval.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/sergeiwallace/skills --skill presentation-sergeiwallace
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: presentation
Source: https://github.com/sergeiwallace/skills/tree/main/skills/presentation
Command: npx skills add https://github.com/sergeiwallace/skills --skill presentation-sergeiwallace

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jsonschema, pillow, @slidev/cli, @slidev/theme-default, playwright, playwright-chromium, and includes scripts (resource) components.

What problem does it solve? Creating a presentation that is structurally sound, visually consistent, and rehearsed usually requires manual slide design, ad-hoc review, and no guarantee that rendered output matches the plan. This Skill enforces a gated Slidev authoring workflow where every deck passes digest-bound story-outline, visual-system, and rehearsal-export approvals before it is considered done. ## Core Features & Use Cases - Brief-driven deck authoring: Normalize and validate an event brief plus optional research into a schema-validated deck manifest with registered layouts, named slots, and speaker notes. - Deterministic render and lint: Render decks offline with a local Slidev/Playwright toolchain, then run DOM-based lint checks for contrast, overflow, token drift, broken links, and external requests. - Pixel-grounded critic gate: Dispatch a configurable visual-review adapter over contact sheets and per-slide PNGs, validating rubric coverage against a JSON schema before committing the review. - Use Case: Given a conference talk brief and research notes, produce a 20-minute Slidev deck with a narrative arc, themed layouts, PDF/PNG exports, and a recorded multi-stage approval trail. ## Quick Start Ask the agent to create a presentation from your brief file, for example: build a Slidev deck from brief.md with audience internal and output directory my-deck.

Frequently Asked Questions about presentation

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

FAQPage Schema
How do I create a Slidev presentation from a brief?

Provide a brief file and optional research paths; the skill normalizes and validates them, builds a schema-validated deck manifest, and renders the deck with the local Slidev toolchain. Each deck must pass story-outline, visual-system, and rehearsal-export approvals.

What dependencies does the Slidev presentation workflow need?

It requires Python packages jsonschema and Pillow, plus Node packages @slidev/cli, @slidev/theme-default, playwright, and playwright-chromium. Run the documented bootstrap to install them and download the Chromium browser for rendering.

How does the visual review gate for slides work?

Set PRESENTATION_REVIEWER_DISPATCH to an adapter command that receives the contact sheet and per-slide PNGs and writes JSON matching the critic-review schema. The critic validates rubric coverage and binds the review to the render digest; without the variable it fails closed.

Can the deck load remote fonts or CDN assets?

No. The render resolves an offline local theme from the manifest, and lint fails on any external requests detected during headless inspection. All fonts and assets must be local to keep rendering deterministic.

What slide layouts are supported in the deck manifest?

Eight registered layouts are allowed: title, thesis, comparison, process, evidence, code, demo, and close. Each declares required named slots and density ranges enforced during render and lint.

Why does the critic step fail even when lint passes?

Lint is deterministic DOM evidence, not visual review. The critic requires a configured reviewer dispatch that judges rendered pixels; it never derives results from DOM inspection and fails if the adapter is unset or returns invalid output.