| name | presentation-builder |
| description | This skill should be used when the user asks to "create a presentation", "make slides", "build a slide deck", "create a talk", "make a keynote", "create a Reveal.js presentation", "generate presentation slides", "make a conference talk", "create a lecture", "build a poster presentation", "create presentation JSON", or mentions presentations, slides, slide decks, Reveal.js, talk preparation, conference presentations, or lecture slides. |
| version | 0.1.0 |
Presentation Builder
Create interactive Reveal.js presentations from JSON using the Agentic Presentation Builder. The builder transforms structured JSON definitions into professional, interactive web-based presentations with Mermaid diagrams, LaTeX math, syntax-highlighted code, and animated progressive reveals.
Pipeline Overview
1. Plan structure --> 2. Author JSON --> 3. Validate --> 4. Serve & present
(outline, theme) (schema-driven) (CLI validator) (Vite dev server)
Prerequisites
The Agentic Presentation Builder must be available locally. Check common locations:
ls -d ~/Documents/git/casual-vibers/agent-presentation 2>/dev/null || \
ls -d ./agent-presentation 2>/dev/null || \
echo "Not found -- clone from https://github.com/neuromechanist/agentic-presentation-builder"
If not present:
git clone https://github.com/neuromechanist/agentic-presentation-builder.git
cd agentic-presentation-builder && bun install
Step 1: Plan the Presentation
Before writing JSON, determine:
- Topic and audience: Shapes content depth and vocabulary
- Slide count: 8-12 for a short talk, 15-25 for a full session
- Theme:
academic for research talks, default for general, dark for tech demos
- Key visuals: Which slides need Mermaid diagrams, images, code blocks, or tables
- Speaker notes: Include delivery guidance for each slide
Step 2: Author the Presentation JSON
Write a presentation.json following the schema. See references/schema-reference.md for the complete field reference and references/authoring-guide.md for best practices.
Minimal structure
{
"presentation": {
"metadata": {
"title": "My Presentation",
"author": "Author Name",
"theme": "academic",
"aspectRatio": "16:9",
"controls": {
"slideNumbers": true,
"progress": true
}
},
"slides": [
{
"id": "title",
"layout": "title",
"elements": [
{
"type": "text",
"content": "# Presentation Title",
"style": { "fontSize": "xxl", "alignment": "center" },
"position": { "area": "center" }
},
{
"type": "text",
"content": "Author Name -- Conference 2026",
"style": { "fontSize": "large", "alignment": "center", "color": "#64748B" },
"position": { "area": "center", "order": 1 }
}
]
}
]
}
}
Slide patterns
Content slide (single-column):
{
"id": "key-findings",
"layout": "single-column",
"speakerNotes": "Emphasize the 3x improvement in latency.",
"elements": [
{
"type": "text",
"content": "## Key Findings",
"style": { "fontSize": "xl" },
"position": { "area": "header" }
},
{
"type": "bullets",
"items": [
"**3x reduction** in processing latency",
"95% accuracy on held-out test set",
"Compatible with existing EEG pipelines"
],
"position": { "area": "content" }
}
]
}
Comparison slide (two-column):
{
"id": "comparison",
"layout": "two-column",
"elements": [
{
"type": "text",
"content": "## Before vs After",
"style": { "fontSize": "xl" },
"position": { "area": "header" }
},
{
"type": "bullets",
"items": ["Manual annotation", "Hours per session", "Inconsistent labels"],
"position": { "area": "left" }
},
{
"type": "bullets",
"items": ["Automated pipeline", "Minutes per session", "Standardized HED tags"],
"position": { "area": "right" }
}
]
}
Diagram slide (Mermaid):
{
"id": "architecture",
"layout": "single-column",
"elements": [
{
"type": "text",
"content": "## System Architecture",
"style": { "fontSize": "xl" },
"position": { "area": "header" }
},
{
"type": "mermaid",
"diagram": "graph LR\n A[Raw EEG] --> B[Preprocessing]\n B --> C[Feature Extraction]\n C --> D[Classification]\n D --> E[BCI Output]",
"position": { "area": "content" }
}
]
}
Element types summary
| Type | Required fields | Key options |
|---|
text | type, content | Markdown, LaTeX math, style, animation |
bullets | type, items | bulletStyle, nested items, animation |
image | type, src | alt, width, height, caption |
mermaid | type, diagram | theme (default/dark/forest/neutral) |
callout | type, content | calloutType (tip/warning/important/note/info), title |
code | type, code | language, caption, lineNumbers |
table | type, headers, rows | caption |
Step 3: Validate
Run the CLI validator before serving:
cd <builder-directory>
bun run validate -- path/to/presentation.json --json
The --json flag returns structured output with valid, summary.errorCount, summary.warningCount, errors[], and warnings[]. Each issue includes code, severity, path, message, and suggestion.
Fix all schema errors. Address advisory warnings to improve slide quality (see references/authoring-guide.md for the full list and thresholds).
Step 4: Serve and Present
Copy the JSON file to the builder's public/ directory (or reference it directly):
cd <builder-directory>
cp path/to/presentation.json public/
bun run dev
Open in browser: http://localhost:3000/?presentation=./presentation.json
Press P to toggle between authoring and presentation modes, S for speaker notes, O for slide overview. See references/authoring-guide.md for the full keyboard shortcuts and delivery modes.
To open a synced audience screen, use ?presentation=./presentation.json&role=audience&mode=presentation.
Additional Resources
Reference files
references/schema-reference.md -- Complete field reference for all element typesreferences/authoring-guide.md -- Layout patterns, content density guidelines, theme selection, validation workflow
External documentation
