The problem with AI-generated slides
When you ask an AI to make a presentation, you usually get:
- A wall of bullet points with no visual design
- Generic templates that all look the same
- Markdown that you then have to manually convert and style
- Output that requires PowerPoint or Google Slides to even open
We wanted something different: tell an AI what you need, get a file you can open in a browser and present immediately.
What html-slides does
html-slides is an open-source skill that works with AI coding agents. It’s a set of instructions that teach your existing AI agent how to generate HTML presentations.
When you install it, your agent learns how to:
- Pick the right interactive components for your content (flip cards, charts, timelines, architecture diagrams, stats cards, and more)
- Apply curated visual themes that don’t look like “AI generated” output
- Produce a single self-contained HTML file — all CSS and JS inline, zero dependencies
- Generate speaker notes alongside the presentation
The output is a .html file you can double-click to open. Arrow keys navigate between slides. That’s it.
How it works
The skill follows the Agent Skills standard — a convention for packaging instructions that AI coding agents can read. One install works across:
- Claude Code
- GitHub Copilot
- Gemini CLI
- OpenAI Codex
- Any Agent Skills compatible tool
Installation is one command:
curl -sSL https://raw.githubusercontent.com/bluedusk/html-slides/main/remote-install.sh | bash
Then you describe what you want:
/html-slides Create a 10-slide pitch deck about our developer platform.
Include stats cards for key metrics and a timeline of milestones.
The skill picks the right components, applies a visual theme, and generates the file.
Two modes
17 themes (5 Pro + 12 Vibe) are available across the two modes:
Pro (default) — Structured interactive components: flip cards, architecture flows, code blocks, charts (via Chart.js), comparison tables, stats cards, timelines, and more. 5 themes available (Obsidian, Excalidraw Light, Excalidraw Dark, Editorial Light, Binary Architect). Best for technical content.
Vibe — Creative themes where the AI decides the layout. You describe the mood you want (“professional”, “energetic”, “calm”), see 3 visual previews, and pick one. 12 themes available. Best for pitch decks and non-technical presentations.
What makes it different
It’s a skill, not an app. It works inside the tools you already use — your terminal, your editor, your AI agent. No new software to learn.
Single file output. No build step, no node_modules, no framework. One .html file with everything inline. Email it, commit it to git, host it on any static server.
Doesn’t look AI-generated. The visual presets avoid the generic look that most AI output has. No purple gradients on white backgrounds. No stock photo layouts.
Share anywhere. Deploy to a live URL with one command, or export to PDF. No special tools needed.
Open source. MIT licensed. Read the code, modify it, contribute to it. The entire skill is on GitHub.
Try it
Install the skill and generate your first deck:
curl -sSL https://raw.githubusercontent.com/bluedusk/html-slides/main/remote-install.sh | bash
See a live example: Introducing HTML Slides
Browse the source: github.com/bluedusk/html-slides