convez.ai
SkillProdutividadeIntermediário
hanley-tech

Better Slides

hanley-tech/better-slides

Apresentações teatrais em HTML geradas por IA, com roteiro integrado

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill 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-slides

1 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

Estrelas
3
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
1

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.

better-slides — the "Be Unforgettable" flagship deck and the Noir style, performing

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:

TheatricsOpen / webAI-authoredTells 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 e in any deck, click any text and type, Ctrl/Cmd+S downloads 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

StyleVoiceReach for it when
NoirBlack stage, white light, one accent — Apple-keynote theatricsProduct launches, vision talks, founder pitches
SpotlightElectric blue + gold on navy, friendly and loudMeetups, teaching, lightning talks, hype moments
TerminalGitHub-dark, terminal green, all monoDev-tool launches, security talks, hackathons
BroadsheetInk-dark editorial serif, one crimson accentResearch, 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)

The Noir style — black stage, white light, one accent

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 methodology
  • performance-styles/ — style index, preview cards, design systems
  • engine/ — the deck template + stage CSS
  • reference/ — layouts, motion, audio, theming
  • scripts/ — PPTX extraction, deploy, PDF export

How it works

  1. Brief — purpose, length, and register (speaker-led vs. reading), plus your content: a topic, rough notes, finished material, or an existing .pptx to convert.
  2. Method pass — the agent applies the Speaker Playbook: finds your one idea, your hero slide, your landing.
  3. Style — pick a performance style from generated live previews.
  4. Build — one self-contained HTML deck, themed, with the motion and (optionally) sound layer wired in.
  5. Perform / share — present it (f fullscreen, m sound), edit inline (e, then Ctrl/Cmd+S to save), deploy to a URL, or export a PDF.

Architecture (progressive disclosure)

FilePurposeLoaded when
SKILL.mdCore workflow + invariantsAlways
playbook/speaker-playbook.mdWhat to say — the methodologyPhase 1 (content)
performance-styles/selection-index.jsonCompact style metadataPhase 2 (style)
performance-styles/*/preview.mdTitle-slide preview cardsPhase 2 (shortlist)
performance-styles/*/design.mdFull design system for the chosen stylePhase 3 (generate)
engine/template.htmlBase deck (stage + nav + chrome)Phase 3
engine/stage.cssMandatory fixed-stage CSSPhase 3
reference/layouts.mdSlide recipesPhase 3
reference/motion.mdTimed-reveal / GSAP / omt patternsPhase 3
reference/audio.mdSound design + Web Audio wiringPhase 3 (if sound)
reference/theming.mdToken swapPhase 3
scripts/extract-pptx.pyPPTX content extractionPhase 0 (conversion)
scripts/deploy.shDeploy to a live URL (Vercel)Phase 4 (share)
scripts/export-pdf.shExport to PDFPhase 4 (share)

Philosophy

  1. A deck is a performance, not a document. Optimize for what the room feels.
  2. One idea, said in one breath. If it doesn't fit in a breath, it isn't one idea yet.
  3. The hero slide does the spreading. Build one visual worth photographing.
  4. Dependencies are debt. One HTML file works forever.
  5. 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.

Ver o original no GitHub

Bom para

Relacionados