Agent skill · software engineering · alirezarezvani
md-slides
Turn a markdown file into a single-file HTML slide deck with keyboard navigation, presenter notes and print-to-PDF. Use whenever the user wants slides or a presentation from markdown or notes.
Why this skill is useful
Adds specific scripts for converting markdown to a structured HTML presentation with advanced features like presenter mode and keyboard navigation.
What it needs
Requires python3 installed locally. About 3k tokens when loaded. Last updated 2026-08-05. 23,939 stars on the source repository.
What this skill does
md-slides — Markdown deck → single-file HTML presentation The slide-deck converter. Reads a markdown deck (HR or H1 boundaries, optional presenter notes), emits a single-file HTML presentation that runs in any browser with keyboard navigation, presenter mode, and print-to-PDF. Three stdlib tools pipeline together: When to invoke Symptom Action --- --- markdown-html-orchestrator routes input as SLIDES Invoke this skill User runs /cs-md-slides <path>.md directly Invoke this skill Input has 3+ --- HR lines OR 5+ H1 headings with short bodies Invoke this skill Input is a long-form spec Route to md-document instead Input is a code review Route to md-review instead Input has no clear slide boundaries Refuse, route to md-document Input would produce 1 slide Refuse (it's a poster) Pipeline What ships in the HTML All slides as <section class="slide"> — one visible at a time, controlled by JS Keyboard nav — → / Space / PgDn advance; ← / PgUp previous; Home/End jump; P presenter mode; Esc exits presenter URL-hash deep linking — #3 jumps to slide 3; browser back/forward walks slides; share deck.html#5 to send someone directly there Progress bar — 3px at top showing position through the deck Slide counter — bottom-right ("3 / 12") Presenter mode (P key) — splits the window: current slide on left (60% width), panel on right with clock + speaker notes + next-slide preview Print stylesheet — Cmd+P produces a PDF with one slide per page @media (prefers-reduced-motion: reduce) honored 12 brand CSS custom properties from design-system; designstyle affects layout density Reuses md-document's markdown parser — slide bodies render with consistent paragraph/list/code/table/callout handling Hard rules 1. Refuses input with no clear slide boundaries. Auto mode needs ≥ 3 HR lines or ≥ 5 H1 headings. Otherwise exit 6 — route to md-document. 2. Refuses 1-slide decks. That's a poster, not a deck. Exit 5. 3. Refuses input < 100 lines. Same Shihipar threshold as all converters. 4. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills alirezarezvani/md-slides--bdabeb