marp-slide

Überblick über den marp-slide Skill

Was marp-slide leistet

Der Skill marp-slide hilft einem Agenten dabei, aus groben Präsentationsanforderungen ausgereifte Marp-Foliensätze zu erstellen – mit fertigen Themes, Leitlinien für die Folienstruktur und Referenzen zur Marp-spezifischen Syntax. Am meisten bringt marp-slide Menschen, die schnell brauchbares Slide-Markdown brauchen und nicht nur eine generische Antwort à la „schreib mir ein paar Folien“.

Für wen sich marp-slide eignet

Nutze marp-slide, wenn du:

• Foliensätze aus Notizen, Gliederungen oder Meeting-Inhalten erstellst
• Marp-kompatibles Markdown statt reiner PowerPoint-Ausgabe willst
• mehr visuelle Konsistenz brauchst, ohne CSS von Hand zu gestalten
• einen Agenten oft bittest, „es gut aussehen zu lassen“, und dafür einen belastbaren Workflow statt bloßer Improvisation willst

Wofür marp-slide am besten passt

Die eigentliche Aufgabe ist nicht „ein paar Bulletpoints generieren“. Sie lautet: ein passendes Theme wählen, Folien so strukturieren, dass sie sich gut präsentieren lassen, und Marp-Markdown erzeugen, das fast renderfertig ist. Das ist besonders wichtig, wenn du schnell von der Idee zum Deck kommen willst, ohne Marp-Syntax, Bildmuster und Theme-Styling erst manuell recherchieren zu müssen.

Was diesen Skill von anderen unterscheidet

Im Vergleich zu einem gewöhnlichen Prompt bietet marp-slide dir:

• 7 enthaltene visuelle Richtungen: default, minimal, colorful, dark, gradient, tech, business
• Template-Dateien in assets/, die du direkt wiederverwenden kannst
• Referenzdokumente zu Marp-Syntax, Bildlayouts, Theme-Auswahl, erweiterten Funktionen und CSS-Anpassung
• einen klaren, meinungsstarken Workflow für vage Anfragen wie „mach es professionell“ oder „mach es cooler“

Worauf Nutzer vor der Installation achten

Die entscheidenden Fragen vor dem Einsatz sind einfach:

• Spart es Zeit gegenüber einem Prompt von null? In der Regel ja, wenn du konkret Marp-Ausgabe brauchst.
• Ist es flexibel? Ja bei Theme-Wahl und Deck-Entwurf; weniger, wenn du stark individuelle Markensysteme brauchst.
• Ist es einsteigerfreundlich? Größtenteils ja, weil Templates und Referenzen viel Marp-Ratespiel vermeiden.
• Ist es für jedes Präsentationsformat gedacht? Nein. Seine Stärke liegt klar bei Marp-Markdown als Zielformat.

So nutzt du den marp-slide Skill

Installationskontext für marp-slide

Wenn deine Agent-Umgebung die Installation von Skills unterstützt, ist dieses Toolkit-Muster üblich:

npx skills add softaworks/agent-toolkit --skill marp-slide

Falls dein Setup diesen Installer nicht nutzt, öffne den Skill-Ordner direkt unter skills/marp-slide im Repository und verwende die Dateien dort als Arbeitsgrundlage. Wichtig ist: marp-slide ist dann am nützlichsten, wenn der Agent sowohl SKILL.md als auch die unterstützenden Dateien in assets/ und references/ lesen kann.

Diese Dateien solltest du zuerst lesen

Für den schnellsten Einstieg lies in dieser Reihenfolge:

1. SKILL.md
2. references/marp-syntax.md
3. references/theme-selection.md
4. assets/template-*.md passend zu deinem Anwendungsfall
5. references/image-patterns.md, wenn visuelle Elemente wichtig sind
6. references/advanced-features.md und references/theme-css-guide.md, wenn du Anpassungen brauchst

Mit diesem Leseweg holst du den größten Informationsgewinn heraus, ohne dich tief durchs Repository arbeiten zu müssen.

Welche Eingaben marp-slide braucht

marp-slide funktioniert am besten, wenn du Folgendes mitgibst:

• Zielgruppe: Führungskräfte, Studierende, Engineers, Kunden
• Ziel: überzeugen, erklären, lehren, Status berichten
• Deck-Länge: gewünschte Folienzahl oder Zeitlimit
• Ausgangsmaterial: Notizen, Bulletpoints, Dokumentauszug, Meeting-Zusammenfassung
• Tonalität: formell, technisch, minimalistisch, dynamisch
• visuelle Präferenz: Theme, hell/dunkel, bildlastig vs. textarm
• Ausgabevorgabe: reines Marp-Markdown, mit oder ohne Speaker Notes

Wenn du nur sagst „mach ein Slide Deck“, kann der Skill zwar trotzdem etwas entwerfen, aber Theme-Wahl und Foliendichte werden dann schnell zum Ratespiel.

So machst du aus einer vagen Anfrage einen starken marp-slide Prompt

Schwacher Prompt:

• „Create slides about our API migration.“

Stärkerer Prompt:

• “Use marp-slide to create a 10-slide Marp deck for engineering managers about our API migration. Audience knows the old system but not the rollout plan. Use the tech theme, keep slides concise, include one architecture slide, one risk slide, and one migration timeline slide. Optimize for a 12-minute internal presentation.”

Diese Version gibt dem Skill genug Kontext, um Struktur, Informationsdichte und Theme passend zu wählen.

Theme-Auswahl, die das Ergebnis wirklich verändert

Die Theme-Entscheidung beeinflusst Lesbarkeit und Passung stärker, als viele erwarten:

• tech: Engineering, Produktarchitektur, Talks für Entwickler
• business: Quartalsreviews, Vorschläge, kundennahe interne Reports
• minimal: akademische Inhalte, Workshops, dokumentationsartige Decks
• colorful oder gradient: Event-, Kreativ- oder Promo-Kontext, lockerere Tonalität
• dark: Präsentationen in dunklen Räumen oder wenn du stärkeren visuellen Kontrast willst
• default: sichere Wahl, wenn das Briefing breit oder unklar ist

Wenn dir die Stilrichtung nicht besonders wichtig ist, entscheide eher nach Zielgruppe als nach persönlichem Geschmack.

Mit einem Template starten statt mit einem leeren Deck

Ein praxisnaher marp-slide-Workflow ist, das passendste Template in assets/ zu öffnen und anzupassen:

• assets/template-business.md
• assets/template-tech.md
• assets/template-minimal.md
• assets/template-dark.md
• assets/template-colorful.md
• assets/template-gradient.md
• assets/template-basic.md

Das ist besser, als den Agenten das Format komplett neu erfinden zu lassen, weil diese Templates Layout-, Typografie- und Abstandsentscheidungen bereits vorgeben.

Empfohlener Workflow für echte Slide-Erstellung

Ein belastbarer Ablauf in der Praxis:

1. Theme wählen
2. Botschaft und Zielgruppe herausarbeiten
3. zuerst eine Foliengliederung entwerfen
4. dann jede Folie in Marp-Markdown ausformulieren
5. Bilder oder Diagramme nur dort ergänzen, wo sie wirklich klären
6. rendern und textlastige Folien straffen
7. CSS erst anpassen, wenn das Deck strukturell bereits funktioniert

Diese Reihenfolge vermeidet einen häufigen Fehler: Zeit in Styling zu investieren, bevor die Logik der Folien stimmt.

Tipps, die die Deck-Qualität spürbar verbessern

Für bessere Ergebnisse mit marp-slide:

• bitte zuerst um eine Foliengliederung, wenn dein Briefing noch unordentlich ist
• gib „max. 3–5 Bulletpoints pro Folie“ vor, wenn das Deck präsentationsfähig bleiben soll
• sag dem Agenten, welche Folien visuell und nicht nur textlich sein sollen
• fordere Titel- und Schlussfolie explizit an, wenn du sie brauchst
• gib eine Sprechdauer an; sie beeinflusst Folienzahl und Dichte stark

Diese Angaben verbessern den ersten Entwurf mehr als generische Formulierungen wie „bitte professionell“.

Wann du die Marp-Referenzen einsetzen solltest

Die Referenzen sind nicht nur Hintergrundmaterial; sie lösen typische Hürden im Arbeitsablauf:

• references/marp-syntax.md: grundlegendes Authoring und Direktiven
• references/image-patterns.md: Bildplatzierung und offizielle Marpit-Muster
• references/best-practices.md: Foliendichte und Struktur
• references/advanced-features.md: komplexere Layouts und Effekte
• references/theme-css-guide.md: individuelle CSS-Anpassungen
• references/official-themes.md: breiterer Kontext zu Marp-Themes

Nutze sie, wenn du nicht nur gut lesbares Markdown willst, sondern Ausgabe, die auch sauber rendert.

Beispiel für einen marp-slide Prompt

Du kannst den Skill mit einem Prompt wie diesem aufrufen:

“Use marp-slide to create a Marp deck from these notes. Audience: startup investors. Goal: explain product traction and funding use. Length: 8 slides. Theme: business. Include a strong lead slide, one market slide, one traction slide, one roadmap slide, and a closing ask. Keep each slide presentation-friendly, not document-heavy.”

Dieser Prompt ist konkret genug, um den Mehrwert des Skills auszulösen, ohne den Entwurf unnötig zu stark einzuengen.

FAQ zum marp-slide Skill

Ist marp-slide besser als ein normaler Prompt zum Schreiben von Folien?

Meist ja, wenn du Marp-Ausgabe brauchst. Ein normaler Prompt kann brauchbaren Folientext liefern, aber marp-slide ergänzt Theme-Auswahl, wiederverwendbare Templates, Marp-spezifische Formatierungsreferenzen und einen besseren Standard-Workflow.

Ist marp-slide nur für Entwickler gedacht?

Nein. Das Repository enthält Themes für Business-, akademische und kreative Einsatzszenarien. Technisch ist die Basis zwar Marp als Markdown-System, aber die tatsächlichen Anwendungsfälle gehen deutlich über klassische Developer-Talks hinaus.

Können Einsteiger den marp-slide Skill nutzen?

Ja, besonders wenn sie den Templates folgen. Der einfachste Weg ist: das passendste Theme auswählen, Zielgruppe und Ziel angeben und dann den Agenten ein kurzes Deck entwerfen lassen. Du musst Marp nicht im Detail beherrschen, um davon zu profitieren.

Wann passt marp-slide nicht gut?

Verzichte auf marp-slide, wenn:

• du einen PowerPoint-nativen Workflow mit viel manueller Animation brauchst
• Markenrichtlinien individuelle Corporate-Templates verlangen, die hier nicht abgebildet sind
• deine Ausgabe eigentlich ein längerer Bericht und kein Foliensatz ist
• du Marp oder Markdown überhaupt nicht verwenden willst

Unterstützt marp-slide individuelles Styling?

Teilweise. Die enthaltenen CSS-Themes decken bereits viel ab, und references/theme-css-guide.md hilft bei Anpassungen. Wenn du jedoch ein vollständig maßgeschneidertes Designsystem brauchst, musst du über den Basis-Skill hinaus mit zusätzlicher Nacharbeit rechnen.

Funktioniert marp-slide auch für bildlastige Decks?

Ja, aber nur, wenn du die Bildabsicht klar formulierst. Der Skill enthält references/image-patterns.md, und das ist wichtig, weil Bildlayout in Marp syntaxsensibel ist. Wenn visuelle Elemente zentral sind, sag explizit, welche Folien sie enthalten sollen und welche Funktion sie erfüllen.

So verbesserst du den marp-slide Skill im Einsatz

Besseres Ausgangsmaterial liefern

Der größte Qualitätssprung kommt durch bessere Eingaben, nicht durch mehr Adjektive. Gute Quellen sind zum Beispiel:

• eine grobe Gliederung mit priorisierten Punkten
• rohe Notizen, nach Themen gruppiert
• ein Dokumentabschnitt, der verdichtet werden soll
• gewünschte Folienzahl und Zeitvorgabe
• Beispiele für Decks, an denen sich das Ergebnis orientieren soll

Unsortierte Materialsammlungen zwingen den Agenten dazu, die Erzählstruktur zu erraten.

Zielgruppe und gewünschtes Ergebnis benennen

Ein gutes marp-slide-Briefing sagt, was die Zielgruppe nach dem Deck verstehen oder tun soll. Zum Beispiel:

• einen Migrationsplan freigeben
• ein Forschungsergebnis verstehen
• zwischen Optionen entscheiden
• Lehrinhalte behalten

Das hilft dem Agenten zu erkennen, was eine eigene Folie verdient und was besser gestrichen wird.

Zu textlastige Erstentwürfe vermeiden

Ein typischer Fehlmodus sind überladene Folien. Um die Ausgabe von marp-slide zu verbessern, frage gezielt nach:

• weniger Bulletpoints pro Folie
• kürzeren Überschriften
• Aufteilung dichter Themen auf zwei Folien
• einer Botschaft pro Folie
• präsentationsgerechter Formulierung statt dokumentartiger Prosa

Das ist besonders wichtig, wenn dein Ausgangsmaterial ein Memo oder Transkript ist.

Das richtige Template wählen, bevor du CSS bearbeitest

Viele steigen zu früh in Theme-CSS ein. Bessere Praxis:

1. das nächstliegende Template wählen
2. Struktur und Lesbarkeit validieren
3. erst danach Farben, Abstände oder Typografie feinjustieren, falls nötig

Wenn das Deck strukturell schwach ist, retten CSS-Anpassungen es nicht.

Mit gezielten Überarbeitungswünschen iterieren

Nach dem ersten Entwurf solltest du nicht nur „improve this“ als Follow-up schicken. Bessere Revisionsprompts sind zum Beispiel:

• “Reduce slide 4 to three bullets and add a clearer takeaway.”
• “Convert slides 5 and 6 into a problem/solution pair.”
• “Switch from default to business and tighten the tone for executives.”
• “Add one image-friendly slide using Marp-compatible layout patterns.”

Gezielte Revisionen liefern meist bessere zweite Fassungen als breite Stilwünsche.

Repository-Referenzen als Qualitätscheckliste nutzen

Ein praktischer Weg, die Ergebnisse von marp-slide zu verbessern, ist, die Referenzdateien als Prüfpunkt nach dem ersten Entwurf zu behandeln:

• Syntax-Korrektheit: references/marp-syntax.md
• korrekte Bildverwendung: references/image-patterns.md
• Design-Feinschliff: references/best-practices.md
• tiefere Anpassungen: references/advanced-features.md und references/theme-css-guide.md

So wird aus einem Einmal-Prompt ein wiederholbarer Workflow für Foliensätze.

Den wichtigsten Trade-off von marp-slide kennen

Die Stärke von marp-slide ist Geschwindigkeit auf dem Weg zu glaubwürdigen Marp-Decks. Der Trade-off ist, dass der Skill klar auf Marp-Struktur und die enthaltenen Themes ausgerichtet ist. Wenn du pixelgenaues, vollständig individuelles Präsentationsdesign brauchst, nutze ihn für schnelles Drafting und eine gute Struktur – und passe danach weiter an, statt im ersten Durchgang perfekte Markenpräzision zu erwarten.