presentation-builder

Generates Marp slide decks with assertion-evidence structure, Mermaid diagrams, and automated visual critique.

1|Updated Aug 6, 2026
One-click install
npx skills add https://github.com/YoLaub/JohnAI --skill presentation-builder-yolaub
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: presentation-builder
Source: https://github.com/YoLaub/JohnAI/tree/main/.claude/skills/presentation-builder
Command: npx skills add https://github.com/YoLaub/JohnAI --skill presentation-builder-yolaub

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @marp-team/marp-cli, @mermaid-js/mermaid-cli, and includes references (resource) components.

What problem does it solve? Building a presentation for a defense, pitch, or talk often produces overloaded, jargon-heavy slides with weak titles and no speaker notes. This Skill enforces the assertion-evidence model and a closed design system so every slide carries one provable claim, one dominant visual, and speaker notes, then validates the deck through an automated critique gate before delivery. ## Core Features & Use Cases - Structured 7-step workflow: blocking intake (audience, goal, duration, context, source material, visual identity), narrative arc, human-validated storyboard, visuals, speaker notes, Marp assembly, and a mandatory control gate. - Closed design system: 8 locked layouts (cover, section, statement, quote, image-caption, diagram, chart, image-full) with fixed typography and spacing tokens; only the accent color is customizable per deck. - Automated visuals: Mermaid diagrams pre-rendered to PNG, charts built only from real provided data, and a strict placeholder format for screenshots not yet available. - Automated critique gate: a fresh sub-agent audits content rules (verb-based titles, max 3 bullets, max 15 words, sourced figures, glossed jargon) and rendered PNG visuals, looping until the deck is CONFORME. - Use Case: A student preparing a thesis defense provides notes and data; the Skill produces a Marp deck exportable to .pptx and PDF with diagrams, sourced charts, and full speaker notes. ## Quick Start Ask the assistant to build a slide deck for your presentation, providing your audience, goal, duration, and source material so it can run the intake step.

Frequently Asked Questions about presentation-builder

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

FAQPage Schema
How do I create a presentation deck with Marp?▼

Write slides in Markdown with a marp: true frontmatter and a custom theme, then export with marp-cli to pptx or PDF. This Skill assembles the theme by concatenating tokens, layouts, and an accent override, since Marp does not resolve local @import.

How do I add Mermaid diagrams to presentation slides?▼

Write each diagram in a .mmd file and pre-render it to PNG with mermaid-cli using a transparent background, then embed the image with the diagram layout class. PlantUML is the fallback for diagrams beyond Mermaid's capabilities.

What is the assertion-evidence model for slides?▼

Each slide title must be a full sentence with a conjugated verb stating a claim, and the body contains one visual proving it. Detail, definitions, and sources move to speaker notes instead of crowding the projected slide.

Can the deck include charts without real data?▼

No. Charts are only produced from explicitly provided data such as CSV files or tool outputs; inventing values or trends is forbidden. Without data, the Skill asks for it or substitutes a diagram or declared placeholder.

Why does Marp export fail to show local images?▼

Marp CLI blocks local files by default, so images in diagrams or images folders will not render. Pass the --allow-local-files flag to marp-cli whenever the deck embeds local image assets.

What are the slide content limits enforced by the critique gate?▼

Each slide allows at most 3 bullets, about 15 body words, code blocks of 4 lines maximum, and must include HTML comment speaker notes. Figures need an explicit source on the slide or in its notes, and jargon must be glossed.