Md Slides

What it does

When your agent uses it

• The markdown-html-orchestrator classifies an input as SLIDES
• Invoked directly via /cs:md-slides

Example prompts

• “Use the md-slides skill to convert a markdown deck (slides separated by --- HR boundaries or by H1 headings, with optional <!-- notes: ..”
• “/md-slides”

Requirements

• Python 3

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

1. 1Refuses input with no clear slide boundaries. Auto mode needs ≥ 3 HR lines or ≥ 5 H1 headings. Otherwise exit 6 — route to md-document.
2. 2Refuses 1-slide decks. That's a poster, not a deck. Exit 5.
3. 3Refuses input < 100 lines. Same Shihipar threshold as all converters.
4. 4Refuses without onboarding. Same gate as every converter.
5. 5strict-notes refuses < 50% notes coverage. A deck where most slides have no notes isn't set up for presenter mode. Exit 7.
6. 6Soft-warns slides > 40 source lines. Signal-to-noise; renders anyway but surfaces the count.
7. 7Single-file output. All CSS + JS inline. Only external is Google Fonts CSS. Prism.js is opt-in via --syntax.
8. 8No JS framework runtime. Vanilla JS + keyboard event handlers, no React/Vue/Svelte.

What it can do on your machine

Read from SKILL.md and the folder at commit 19392f7. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 3 files in scripts/ (Python), which the agent can run.

  Shell commands in SKILL.md call:

  • python3

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Md Slides loads about 1.6k tokens when it runs, and up to ~5.4k if it reads all its reference files. Until then it costs about 209 tokens; SKILL.md has 596 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~209

When it runs · the whole SKILL.md, loaded when a task matches

~1.6k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~5.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from alirezarezvani/claude-skills at commit 19392f7, republished under its MIT licence (© alirezarezvani). 596 words, ~1,627 tokens.

name

md-slides

description

Converts a markdown deck (slides separated by `---` HR boundaries or by `# ` H1 headings, with optional `<!-- notes: ... -->` presenter notes blocks) into a single-file HTML presentation with arrow-key / space / PgDn / PgUp / Home / End / P / Esc keyboard navigation, presenter mode (split view with current slide + speaker notes + clock + next-slide preview), URL-hash deep linking, and `@media print` page-per-slide for PDF export. Triggers when the markdown-html-orchestrator classifies an input as SLIDES, or when invoked directly via /cs:md-slides. Reuses md-document's markdown parser for slide-body rendering and reads design-system tokens via config_loader.py. Refuses if input has no clear slide boundaries, produces a 1-slide deck, or `--strict-notes` is on with < 50% notes coverage. Use after orchestrator routing.

version

2.10.3

author

Alireza Rezvani

license

MIT

tags

markdown, html, slides, deck, presenter-mode, keyboard-nav, print-to-pdf, single-file, design-system

compatible_tools

claude-code, codex-cli, cursor, antigravity, opencode, gemini-cli

slide_splitter.py  →  presenter_notes_parser.py  →  deck_html_renderer.py
   (md → ordered      (extract <!-- notes:         (slides + design-system
    slides with       --> blocks, attach            tokens → single-file
    titles)           per slide)                    HTML with keyboard nav)

# 1. Split slides on --- or H1 (auto-detect by default)
python3 markdown-html/skills/md-slides/scripts/slide_splitter.py \
    --input <path>.md --output /tmp/slides.json

# 2. Extract <!-- notes: ... --> blocks from each slide
python3 markdown-html/skills/md-slides/scripts/presenter_notes_parser.py \
    --slides /tmp/slides.json --output /tmp/deck.json

# 3. Render single-file HTML deck
python3 markdown-html/skills/md-slides/scripts/deck_html_renderer.py \
    --slides /tmp/deck.json --title "My Talk" --output deck.html

© alirezarezvani, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 7 other files (scripts, references, assets) in markdown-html/skills/md-slides of alirezarezvani/claude-skills.

• SKILL.md
• assets/md_slides_template.html
• references/keyboard_nav_patterns.md
• references/presentation_ux.md
• references/single_file_deck_conventions.md
• scripts/deck_html_renderer.py
• scripts/presenter_notes_parser.py
• scripts/slide_splitter.py

Open the folder on GitHubat commit 19392f7

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in alirezarezvani/claude-skills, which our catalogue first saw on October 7, 2026.

• majiayu000/claude-skill-registryskills/bash/md-slides-rovan-tech-ocr-placas-previsao-