convez.ai
SkillProdutividadeIntermediário
adewale

Slide Maker

adewale/slide-maker

Transforma repositórios GitHub em apresentações Slidev editáveis

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill que converte repositórios GitHub em decks de apresentação Slidev automaticamente. Lê código-fonte, documentação e aproveita contexto técnico para gerar slides editáveis em Markdown nativo, compiláveis em HTML estático e implantáveis em qualquer lugar.

Instalação

$npx convez-ai adewale/slide-maker

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
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 2 semanas
Versão
v0.2.1
Issues abertas
2
Contribuidores
1

Casos de uso

  • Documentar arquitetura de projetos via slides automatizadas
  • Criar decks de pitch e demonstração de produtos técnicos
  • Gerar apresentações executivas a partir de código e docs existentes

Veredito

Skill sólida para transformar conhecimento técnico disperso em apresentações visuais prontas. Integração com Slidev garante portabilidade e edição posterior fácil, útil para equipes que precisam documentar projetos rapidamente.

README

A tradução para o português deste README ainda está na fila.

Slide Maker

skills.sh

An Agent Skill that creates Slidev presentation decks. Point it at a GitHub repo or describe what you want — it reads source code, architecture docs, and lessons learned to produce slides grounded in what's actually there.

Output is native Slidev Markdown: editable by hand, buildable to static HTML, deployable anywhere.

See example decks live

Install

npx skills add adewale/slide-maker

Skills appear on skills.sh automatically after users install the repo with the skills CLI. Install counts and leaderboard rankings come from anonymous CLI telemetry; opt out with DISABLE_TELEMETRY=1. The repo page customization in skills.sh.json is picked up after the repository is seen by telemetry and the cache refreshes.

Agent compatibility

The installable skill directory is skills/slide-maker. It uses the Agent Skills SKILL.md format and is configured for Codex, OpenCode, Pi, Gemini CLI, and Claude Code.

Slide Maker can be loaded by any Agent Skills-compatible client. Full rendered validation uses this repo's tools/ directory; when only skills/slide-maker is copied, run the bundled checklist plus native Slidev build/export commands instead of repo-specific tools.

Agent/clientInstall or use
Codexcp -R skills/slide-maker ~/.codex/skills/slide-maker
OpenCodecp -R skills/slide-maker ~/.config/opencode/skills/slide-maker or use .opencode/skills/slide-maker in a project
Pipi install https://github.com/adewale/slide-maker or pi --skill skills/slide-maker
Gemini CLIgemini skills install https://github.com/adewale/slide-maker --path skills/slide-maker or copy to .gemini/skills/slide-maker
Claude Codenpx skills add adewale/slide-maker or copy to .claude/skills/slide-maker

Create a deck

/slide-maker Create a deck about this project's architecture using the editorial-dark preset
/slide-maker Create a 7-slide pitch deck about our API monitoring tool using bold-modern

The skill walks through intake, style direction, spec writing, compilation, and validation. You approve the visual direction before any slides are written.

Update a deck

/slide-maker Update slides.md — split slide 8 into two slides
/slide-maker Add a comparison slide after slide 4, showing before/after latency numbers

Preview and share

npx slidev                # preview locally at localhost:3030
npx slidev export         # export as PDF
python tools/deploy-cf.py # deploy when this repo's tools/ are available

Every built deck includes a PDF download button. To deploy manually, npx slidev build produces a static dist/ folder — deploy it to any host (Cloudflare Pages, Vercel, Netlify, GitHub Pages).

What it produces

FilePurpose
deck.spec.mdPlanning document — locks visual direction before slides are written
slides.mdThe presentation, in standard Slidev Markdown
styles/tokens.cssColor, typography, and spacing tokens (--deck-* CSS variables)
styles/theme.cssLayout-specific styling that references the tokens
README.mdQuick start, build, and share instructions

Edit the spec to change direction; edit the slides to change content.

Presets

PresetTypographyBackground
editorial-darkPlayfair DisplayNear-black
swiss-minimalDM SansWhite
bold-modernBebas NeueSaturated color
tufte-dataEB GaramondLight, 60/30 split
cloudflareSource Sans 3 / Young SerifWarm cream
material-designRobotoM3 surfaces
croissant-warmYoung SerifWarm cream

Quality checks

The compiler validates its own output against:

  • WCAG AA contrast ratios (4.5:1 body text, 3:1 large text)
  • 60+ LLM-tell anti-patterns (generic phrases, overused fonts, purple gradients)
  • CRAP design principles (Contrast, Repetition, Alignment, Proximity)
  • Viewport overflow — every slide must fit the screen, no scrolling

Two CLI tools run post-build:

node tools/deck-lint.mjs          # static analysis: tokens, density, Mermaid, alignment
node tools/screenshot-audit.mjs   # visual: contrast, overlap, overflow, column balance

Keyboard shortcuts

KeyAction
?Toggle shortcut help
qShare current slide as QR code
pPresenter mode
fFullscreen
dDark / light mode
oSlide overview

Mobile

On portrait phones (< 640px), decks switch to a vertical scroll view with snap-scrolling and all click animations resolved.

Programmatic access

Built decks expose Markdown for LLMs and tooling:

PathContent
/slides.mdFull presentation source
/slides/1.mdIndividual slide
/slides/countTotal slide count
/llms.txtManifest of all decks (llmstxt.org)

License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados