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: GitHub Pages · Cloudflare

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.

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.

/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.

/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

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).

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

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

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

Built decks expose Markdown for LLMs and tooling:

MIT — see LICENSE.