md-slidesvon Alireza Rezvani

MD Slides Skill.

Q: Welche Coding-Agents können diesen Skill ausführen?

Die Datei führt claude-code, codex-cli, cursor, antigravity, opencode und gemini-cli als kompatible Tools auf, und der Skill kann auch ausgelöst werden, wenn der markdown-html-orchestrator eine Eingabe als SLIDES klassifiziert.

Q: Was, wenn mein Markdown keine klaren Folien-Grenzen hat?

Der Skill verweigert die Ausführung, statt zu raten, und beendet mit Code 6; der dokumentierte nächste Schritt ist, diese Datei an md-document weiterzuleiten, das ein durchgehendes Dokument statt einzelner Folien verarbeitet.

Q: Wie erhalte ich ein PDF aus der Präsentation?

Verwenden Sie das Print-Stylesheet: Der Ausdruck aus dem Browser erzeugt ein PDF mit einer Folie pro Seite, sodass der Export kein separates Tool benötigt.

Ein Claude Code und Codex skill für PPT und Präsentationen: konvertiert ein Markdown-Deck in gebrandete Folien.

Presentations
HTML-Folien

OpenDesign herunterladen Anleitung ansehen

alirezarezvani/claude-skills · markdown-html/skills/md-slides/SKILL.mdSKILL.md

--- name: md-slides description: Converts a markdown deck (slides separated by `---` HR boundaries or by `# ` H1 headings, with optional `` 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 … --- ## When to invoke ## Pipeline ## What ships in the HTML ## Hard rules ## Forcing-question library (Matt Pocock grill discipline) ## Distinct from

Frontmatter und Abschnittsüberschriften aus der Upstream-Datei vom 14.09.2026 · 6.506 Zeichen insgesamt

01 Was es tut

Was das md-slides Skill in Claude Code und Codex tut

Zusammenfassung, Workflow und Ergebnisse — alles aus der SKILL.md des Skills ausgelesen.

Aus der SKILL.mdGelesen am 14.09.2026 · kein aufgezeichneter Durchlauf

In den eigenen Worten des Skills

md-slides wandelt ein Markdown-Deck in eine einzeldateige HTML-Präsentation um, die in jedem Browser läuft. Ein Deck besteht aus Folien, die durch --- HR-Trennlinien oder # H1-Überschriften getrennt sind, mit optionalen -Blöcken für Präsentatoren-Notizen. Eine Pipeline aus drei stdlib-Python-Skripten: slide_splitter.py, presenter_notes_parser.py, deck_html_renderer.py.

Die Ausgabe bringt Tastaturnavigation, Deep-Linking über URL-Hash, eine Fortschrittsleiste und einen Folienzähler, einen Präsentationsmodus mit Uhr und Vorschau der nächsten Folie sowie ein Print-Stylesheet für den PDF-Export mit einer Folie pro Seite mit. Es nutzt den Markdown-Parser von md-document wieder und liest Design-System-Tokens über config_loader.py. Es lehnt Eingaben ohne klare Foliengrenzen, Decks mit nur 1 Folie, Dateien unter 100 Zeilen sowie Decks, die die --strict-notes-Abdeckung von 50% nicht erreichen, ab.

Was er erzeugt

Das gerenderte HTML-Deck, geschrieben als deck-{slug}.html im aufgelösten Standard-Ausgabeverzeichnis, wobei bei Kollisionen -2, -3 usw. angehängt wird.
Zwischen-JSON-Dateien mit den aufgeteilten Folien und anschließend den Folien mit ihren zugehörigen Notizen.
Ein PDF mit einer Folie pro Seite, erzeugt über das Print-Stylesheet durch Drucken aus dem Browser.

Siehe Beispiel-Prompt ↗

So funktioniert es

01
Das Deck in geordnete Folien aufteilen
slide_splitter.py liest das Quell-Markdown und teilt es an --- HR-Zeilen oder H1-Überschriften auf, wobei der Trennstil standardmäßig automatisch erkannt wird, und schreibt eine geordnete Folienliste.
02
Präsentatoren-Notizen pro Folie zuordnen
presenter_notes_parser.py durchsucht jede Folie nach Notizblöcken und ordnet sie der jeweiligen Folie zu, damit der Präsentationsmodus im rechten Panel etwas anzeigen kann.
03
Das einzeldateige HTML-Deck rendern
deck_html_renderer.py kombiniert Folien mit Design-System-Tokens und erzeugt das Deck, wobei ein Titel und ein Ausgabepfad über die Kommandozeile übergeben werden.
04
Design-System-Tokens anwenden
Zwölf Marken-CSS-Custom-Properties stammen aus dem Design-System, und design_style bestimmt, wie dicht die Folienlayouts sind.
05
Eingaben ablehnen, die keine Decks sind
Der Skill bricht ab, statt zu konvertieren, wenn die Eingabe keine klaren Folien-Grenzen aufweist, nur eine einzige Folie ergeben würde oder das Notes-Coverage-Gate unter --strict-notes nicht besteht.

02 Finden Sie Ihren Favoriten

Wann das md-slides-Skill zu verwenden ist

Verwenden Sie das md-slides-Skill in Claude Code oder Codex, wenn es um PPT- und Foliendecks dieser Art geht. Passform und Grenzen unten sind aus der eigenen Datei des Skills übernommen.

Gut geeignet

Ein Orchestrator hat die Eingabe als SLIDES klassifiziert und hierher geleitet.
Jemand ruft den Skill direkt auf einer Markdown-Datei mit dem Slash-Befehl auf.
Das Markdown enthält bereits 3 oder mehr --- HR-Zeilen oder 5 oder mehr H1-Überschriften mit kurzen Textkörpern.
Das Deck wird live präsentiert, und genau dann sind Präsentationsnotizen wichtig, während sie beim selbstständigen Lesen optional sind.

Grenzen kennen

Die Eingabe ist ein Langform-Spec und kein Deck; das sollte an md-document gehen.
Die Eingabe ist ein Code-Review, das zu md-review gehört.
Es ist kein grafisches Design-Tool: Keynote und PowerPoint decken diesen Bereich ab, während dieses Tool markdown-basierte Decks handhabt, die aus einem Browser projiziert werden.

Was Sie bereitstellen sollten

Die Markdown-Deck-DateiIhr Pfad wird slide_splitter.py mit --input übergeben, und das Ergebnis der Aufteilung wird mit --output in eine JSON-Datei geschrieben.
GrenzstilFolien müssen unterscheidbar sein, entweder durch --- HR-Grenzen oder durch H1-Überschriften, damit der Splitter etwas zum Trennen hat.
Optionale PräsentationsnotizenNotizen werden als HTML-Kommentarblöcke innerhalb der Folien angegeben und im zweiten Pipeline-Schritt pro Folie geparst und angehängt.

03 Innerhalb des Skills

Regeln, die der md-slides Skill Claude Code und Codex vorgibt

8 konkrete Anweisungen, Standardwerte und Grenzen, die die SKILL.md für den Agent festlegt – der Teil der Datei, der das Ergebnis verändert.

Anforderung an Grenzen
Der Auto-Modus benötigt mindestens 3 HR-Zeilen oder mindestens 5 H1-Überschriften in der Quelle; ist keines davon vorhanden, verweigert der Skill die Ausführung, und die Eingabe sollte statt dessen an md-document gehen.
Keine Einzelfolien-Ausgabe
Ein Deck, das sich zu einer einzigen Folie rendert, wird als Poster abgelehnt, nicht als Deck, mit Exit-Code 5.
Mindestens 100 Quellzeilen
Eingaben mit weniger als 100 Zeilen werden abgelehnt, unter Verwendung desselben Shihipar-Schwellenwerts, der bei allen Konvertern angewendet wird.
Onboarding-Gate
Der Skill verweigert die Ausführung ohne Onboarding, dasselbe Gate, das jeder Konverter verwendet.
Strenge Notes-Coverage
Mit --strict-notes lehnt der Skill ein Deck ab, bei dem weniger als 50 % der Folien Notizen enthalten, da es nicht für den Präsentationsmodus ausgelegt ist; diese Ablehnung endet mit Exit-Code 7.
Warnung bei überlangen Folien
Bei Folien mit mehr als 40 Quellzeilen erscheint eine sanfte Warnung zum Signal-Rausch-Verhältnis; das Deck wird trotzdem gerendert, aber die Anzahl wird angezeigt.
Output als Single-File beibehalten
Sämtliches CSS und JS ist inline eingebettet; die einzige externe Ressource ist das Google Fonts CSS, und Prism.js ist über --syntax optional zubuchbar statt standardmäßig gebündelt.
Keine Framework-Runtime
Das Deck verwendet ausschließlich Vanilla-JS und Keyboard-Event-Handler, ohne React-, Vue- oder Svelte-Runtime.

04 In Betrieb nehmen

md-slides in Claude Code oder Codex installieren

Ein npx skills add-Befehl, dann eine erste Aufgabe in Ihrem Agent und eine Checkliste für das Ergebnis.

md-slides zu Claude Code, Codex oder Ihrem Agent hinzufügen

Im eigenen Projekt ausführen; der Installer fragt, welchem Agent er hinzugefügt werden soll.

Terminal

npx skills add https://github.com/alirezarezvani/claude-skills --skill md-slides

Generische skills-CLI-Form für markdown-html/skills/md-slides/SKILL.md; das Repository kann seinen eigenen Pfad dokumentieren.

Geben Sie dem Skill eine erste PPT- und Folienpräsentationsaufgabe

In den eigenen Begriffen des Skills verfasst; ersetzen Sie die Teile in Klammern durch Ihr Material.

Starter prompt

Convert [deck.md] into a presentation. It uses --- HR boundaries for slides and each slide has a <!-- notes: ... --> block. Title it "[Talk title]" and run it with --strict-notes, since it will be presented live rather than read on its own. Write the result to [output/deck.html].

Quelle: verfasst aus der SKILL.md in den eigenen Begriffen des Skills.

Das erste Ergebnis prüfen

Was die SKILL.md selbst als korrektes Ergebnis beschreibt:

Öffnen Sie das Deck in einem Browser und testen Sie die Tasten: Pfeiltasten, Leertaste und Bild-runter blättern vorwärts, Bild-hoch geht zurück, Pos1 und Ende springen, P schaltet den Präsentationsmodus um, Esc verlässt ihn.
Testen Sie Deep-Linking: #3 sollte zu Folie 3 springen, Vorwärts- und Zurück-Buttons des Browsers sollten durch die Folien blättern, und ein geteiltes deck.html#5 sollte direkt auf Folie 5 öffnen.
Prüfen Sie den Folienzähler unten rechts, der wie „3 / 12“ aussieht, gegen die Länge des Decks.
Bestätigen Sie, dass die Reduced-Motion-Media-Query beachtet wird, sodass Animation für Betrachter entfällt, die weniger Bewegung wünschen.

In OpenDesign importieren Sie md-slides über seinen SKILL.md-Link: Plugins → Add → Skill → Import from link, und wählen Sie es dann in der oberen Leiste aus.

OpenDesign herunterladen Quickstart lesen

05 Open Source, nachvollziehbar

Quelle, Lizenz und Verifizierung

Woher die Fakten auf dieser Seite stammen und wann sie zuletzt geprüft wurden.

Author: Alireza Rezvani
Repository: github.com/alirezarezvani/claude-skills Branch main
Skill-Datei: markdown-html/skills/md-slides/SKILL.md Content-Prüfsumme bei Verifizierung aufgezeichnet; Commit 19392f7
License: MIT Aus LICENSE.
Repository-Sterne: 25.934 GitHub-Snapshot vom 14.09.2026 für das gesamte Repository alirezarezvani/claude-skills, das 5 Skills in diesem Katalog enthält. Keine Bewertung oder Nutzungszahl für md-slides.
Verifiziert von OpenDesign: 14.09.2026 Quelldatei, Pfad, Lizenztext und Sternezählung wurden geprüft. Nicht in OpenDesign main gebündelt (geprüft 28.08.2026); ein Live-Durchlauf wurde auf dieser Seite nicht erfasst.

In der SKILL.md

Wann aufrufenRouting-Symptome sowie welche Eingaben abgelehnt oder anderswohin geleitet werden sollten.
PipelineDrei Befehle, die aufteilen, Notizen parsen und das Deck rendern.
Was im HTML enthalten istNavigation, Deep-Linking, Präsentationsmodus, Print-Stylesheet, Tokens, Parser-Wiederverwendung.
Feste RegelnAblehnungsschwellen, sanfte Warnungen und Vorgaben für Single-File-Output.
Bibliothek erzwingender Fragen (Matt-Pocock-Grill-Disziplin)Fünf Fragen, die vor der Konvertierung einer Quelldatei zu klären sind.
Abgrenzung zuWie es sich von md-document, md-review, Landingpages, Keynote unterscheidet.
Output-ArtefaktAuflösung des Ausgabepfads und die Konvention für Kollisions-Suffixe.
ReferenzenQuellen und Kanon hinter den Deck-Konventionen.

Die eigene Beschreibung des Skills

Konvertiert ein Markdown-Deck (Folien getrennt durch `---`-HR-Grenzen oder durch `# `-H1-Überschriften, mit optionalen ``-Präsentatornotizen-Blöcken) in eine HTML-Präsentation als Einzeldatei mit Pfeiltasten- / Leertasten- / Bild↓ / Bild↑ / Pos1 / Ende / P / Esc-Tastaturnavigation, Präsentatormodus (geteilte Ansicht mit aktueller Folie + Notizen + Uhr + Vorschau der nächsten Folie), URL-Hash-Deeplinks und `@media print`-Seitenaufteilung für PDF-Export. Wird aktiviert, wenn der markdown-html-orchestrator eine Eingabe als SLIDES klassifiziert oder direkt über /cs:md-slides aufgerufen wird. Verwendet den Markdown-Parser von md-document für das Rendern des Folieninhalts und liest design-system-Token über config_loader.py. Verweigert die Ausführung, wenn die Eingabe keine klaren Foliengrenzen aufweist, ein 1-Folien-Deck erzeugt oder `--strict-notes` aktiv ist bei < 50 % Notizenabdeckung. Nach dem Orchestrator-Routing verwenden.

Front-Matter-Beschreibung aus SKILL.md. Die vollständige Datei umfasst etwa 6.506 Zeichen. Vollständige Datei auf GitHub lesen.

06 Vor der Installation

Fragen zum md-slides-Skill

Die Antworten stammen aus der SKILL.md, gelesen am 14.09.2026, nicht aus einem protokollierten Lauf.

Welche Coding-Agents können diesen Skill ausführen?

Die Datei führt claude-code, codex-cli, cursor, antigravity, opencode und gemini-cli als kompatible Tools auf, und der Skill kann auch ausgelöst werden, wenn der markdown-html-orchestrator eine Eingabe als SLIDES klassifiziert.

Was, wenn mein Markdown keine klaren Folien-Grenzen hat?

Der Skill verweigert die Ausführung, statt zu raten, und beendet mit Code 6; der dokumentierte nächste Schritt ist, diese Datei an md-document weiterzuleiten, das ein durchgehendes Dokument statt einzelner Folien verarbeitet.

Wie erhalte ich ein PDF aus der Präsentation?

Verwenden Sie das Print-Stylesheet: Der Ausdruck aus dem Browser erzeugt ein PDF mit einer Folie pro Seite, sodass der Export kein separates Tool benötigt.

MD Slides

md-slides bei einer echten PPT- und Foliendeck-Aufgabe ausführen.

OpenDesign herunterladen, md-slides über seinen SKILL.md-Link importieren, den obigen Prompt einfügen und den Plan vor dem Ergebnis lesen.

OpenDesign herunterladen Alle Skills durchsuchen