Better Slides
hanley-tech/better-slides
Apresentações teatrais em HTML geradas por IA, com roteiro integrado
Ver no GitHubSkill que gera apresentações em HTML puro, com teatralidade de Keynote, design responsivo e metodologia integrada para estruturar o discurso. Um agente de IA escreve um arquivo HTML portátil que funciona offline, com animações sincronizadas, design sonoro e escalabilidade garantida em qualquer tela.
Instalação
npx convez-ai hanley-tech/better-slides1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Gerar decks de apresentação em conferências com design profissional e teatral
- Criar apresentações que escalam perfeitamente em qualquer resolução de tela
- Estruturar talks com metodologia de narrativa e discurso integrado
Veredito

Better Slides preenche lacuna real entre ferramentas AI de slides (estáticas) e apresentadores profissionais (sem IA). Execução sólida para palestrantes que precisam de teatralidade, portabilidade garantida e metodologia de conteúdo — não é apenas gerador de slides, é engine de performance.
README
A tradução para o português deste README ainda está na fila.
better-slides
Slides that perform — Apple-keynote theatrics in a single HTML file your coding agent writes for you.
by Hanley Leung · hanley.world · born from the LunaTechs Speaker Playbook
Most slide tools make a document. better-slides makes a performance: big type, timed reveals, sound design, and a "one more thing" finale — the theatrics of an Apple keynote, the openness of the web, authored by a coding agent, with a built-in methodology that tells you what to actually say.
Don't be boring. Be unforgettable.

Live demos: Be Unforgettable (Spotlight) · This is not a slideshow (Noir) — arrow keys to advance, m for sound, f for fullscreen.
This is an agent skill (works with Claude Code and any coding agent that can read a repo
and run a shell). Point it at your talk; get back one portable .html file that opens in
any browser, scales to any screen, and runs entirely offline-ish (one fonts request).
Why this exists
There's a gap nobody fills:
| Theatrics | Open / web | AI-authored | Tells you what to say | |
|---|---|---|---|---|
| Apple Keynote | ✅ | ❌ | ❌ | ❌ |
| reveal.js | ~ | ✅ | ❌ | ❌ |
| AI slide tools | ❌ | ✅ | ✅ | ❌ |
| better-slides | ✅ | ✅ | ✅ | ✅ |
Most AI slide generators optimize for removing friction and ship a static, pretty document. better-slides optimizes for the opposite: a deck that's felt — that applauds, swooshes, lands a reveal, and leaves the room itching to act.
Built for the podium
Conference screens are a graveyard of mismatched resolutions and aspect ratios. Most decks were authored for one screen and break on the rest — text reflows, a chart slips off the edge, the hero number wraps. better-slides sidesteps the whole class of problem: the deck is a fixed composition that scales and letterboxes, so it is pixel-identical on every projector, every time. Plug in, present, don't think about it.
What you get
- Event-proof stage engine — authored once at a fixed 1920×1080 and scaled as one unit to whatever screen the venue hands you: 1080p laptop, 4:3 hall projector, 16:10 panel, ultrawide, confidence monitor, phone. It letterboxes instead of reflowing — what you designed is exactly what shows, on every screen, with zero last-minute surprises at the podium. Keyboard / swipe / deep-link nav, glass control menu, progress bar.
- The performance layer — GSAP-driven timed reveals, staggered builds, and an
omt("one more thing") finale recipe. Optional sound design: applause beds, swooshes, chimes, and a live waveform — wired through the Web Audio API. - Performance styles — four full design systems (not just themes): typography, palette, motion grammar, and sound palette per style. Loaded progressively.
- The Speaker Playbook — a built-in methodology for what to put on stage: distill to
one idea, narrative over data, one huge number, build a hero slide worth screenshotting,
stick the landing. (
playbook/speaker-playbook.md) - Inline editing — press
ein any deck, click any text and type,Ctrl/Cmd+Sdownloads the edited file. Fix a typo at the venue with nothing but a browser. - PPTX conversion — point it at a
.pptx; it extracts every slide, note, and image, then re-authors the content as a performance (not a 1:1 port — the playbook applies). - Share scripts — one command to deploy to a live URL
(
scripts/deploy.sh) or export a print-faithful PDF (scripts/export-pdf.sh). - Zero dependencies — one HTML file (plus optional audio assets). Works in 10 years. No npm, no build step, no framework.
Performance styles
| Style | Voice | Reach for it when |
|---|---|---|
| Noir | Black stage, white light, one accent — Apple-keynote theatrics | Product launches, vision talks, founder pitches |
| Spotlight | Electric blue + gold on navy, friendly and loud | Meetups, teaching, lightning talks, hype moments |
| Terminal | GitHub-dark, terminal green, all mono | Dev-tool launches, security talks, hackathons |
| Broadsheet | Ink-dark editorial serif, one crimson accent | Research, strategy, essays-as-talks, policy |
Each is a full design.md with motion grammar and sound palette — and the skill always
offers a custom wildcard when none of these fits the brief.
The demos
demo/ is the "Be Unforgettable" talk — the Speaker Playbook itself, rebuilt
on the better-slides engine with the full performance treatment (Spotlight style). It's the
worked example and the marketing: a talk about being unforgettable that is itself
unforgettable. (live)
demo/noir/ is "This is not a slideshow" — a short launch keynote in the
Noir style: black stage, white light, one accent, held pauses, and the "one more thing"
finale. (live)

open demo/index.html # Be Unforgettable (Spotlight)
open demo/noir/index.html # This is not a slideshow (Noir)
Install
Claude Code — marketplace
/plugin marketplace add https://github.com/hanley-tech/better-slides
then, as a separate message:
/plugin install better-slides@better-slides
Use it with /better-slides:better-slides.
Claude Code — manual skill
git clone https://github.com/hanley-tech/better-slides.git ~/.claude/skills/better-slides
Then use it by typing /better-slides.
Any other coding agent
Send the agent this repo link and ask it to use the better-slides skill. It should start
from SKILL.md and load only the referenced support files it needs:
playbook/speaker-playbook.md— the methodologyperformance-styles/— style index, preview cards, design systemsengine/— the deck template + stage CSSreference/— layouts, motion, audio, themingscripts/— PPTX extraction, deploy, PDF export
How it works
- Brief — purpose, length, and register (speaker-led vs. reading), plus your
content: a topic, rough notes, finished material, or an existing
.pptxto convert. - Method pass — the agent applies the Speaker Playbook: finds your one idea, your hero slide, your landing.
- Style — pick a performance style from generated live previews.
- Build — one self-contained HTML deck, themed, with the motion and (optionally) sound layer wired in.
- Perform / share — present it (
ffullscreen,msound), edit inline (e, thenCtrl/Cmd+Sto save), deploy to a URL, or export a PDF.
Architecture (progressive disclosure)
| File | Purpose | Loaded when |
|---|---|---|
SKILL.md | Core workflow + invariants | Always |
playbook/speaker-playbook.md | What to say — the methodology | Phase 1 (content) |
performance-styles/selection-index.json | Compact style metadata | Phase 2 (style) |
performance-styles/*/preview.md | Title-slide preview cards | Phase 2 (shortlist) |
performance-styles/*/design.md | Full design system for the chosen style | Phase 3 (generate) |
engine/template.html | Base deck (stage + nav + chrome) | Phase 3 |
engine/stage.css | Mandatory fixed-stage CSS | Phase 3 |
reference/layouts.md | Slide recipes | Phase 3 |
reference/motion.md | Timed-reveal / GSAP / omt patterns | Phase 3 |
reference/audio.md | Sound design + Web Audio wiring | Phase 3 (if sound) |
reference/theming.md | Token swap | Phase 3 |
scripts/extract-pptx.py | PPTX content extraction | Phase 0 (conversion) |
scripts/deploy.sh | Deploy to a live URL (Vercel) | Phase 4 (share) |
scripts/export-pdf.sh | Export to PDF | Phase 4 (share) |
Philosophy
- A deck is a performance, not a document. Optimize for what the room feels.
- One idea, said in one breath. If it doesn't fit in a breath, it isn't one idea yet.
- The hero slide does the spreading. Build one visual worth photographing.
- Dependencies are debt. One HTML file works forever.
- Tell them what to say, not just how it looks. Design without a point of view is slop.
Credits
By Hanley Leung (hanley.world) / LunaTechs. Engine extracted from the LunaTechs Speaker Playbook deck.
License
MIT — use it, modify it, share it.