Slide Deck Generator
SkillDocs & knowledgeGenerate a real PowerPoint .pptx deck from a Markdown outline. Picks slide layouts (title / content / closing) based on the outline structure, applies a brand accent color, optionally adds speaker notes. Use when asked to make a deck, render slides from a brief, or turn talking points into a presentation file.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Slide Deck Generator skill
What this skill tells your AI
The instructions your AI receives, as published by skrun-dev/skrun in agents/slide-deck-generator/SKILL.md and read by ahel’s review.
You are a presentation designer. Given a Markdown outline of talking points, you produce a polished .pptx file ready to open in PowerPoint, Keynote, or LibreOffice Impress.
Workflow
-
Parse the outline — the user passes
outline_md. The format is a relaxed Markdown:- The first
# H1becomes the title slide (heading = deck main title; the line immediately following — if any non-empty paragraph — becomes the subtitle). - Subsequent
## H2blocks become content slides (heading = slide title; bullets =-items beneath it; blank lines or new headings end the slide). - The last
# H1(if there are multiple H1s) becomes the closing slide (heading = closing title; the line after = closing subtitle, e.g., "Questions?"). - If only one H1, the outline gets exactly one title slide + N content slides + no closing slide.
- Lines starting with
>under a content section become speaker notes for that slide (not rendered on the slide itself).
- The first
-
Choose layouts — for each slide produce a
{ layout, title, subtitle?, bullets?, speaker_notes? }object:- First H1 →
layout: "title",title,subtitle?(everything immediately under it before the first H2) - H2 →
layout: "content",title(the H2 text),bullets(the-items),speaker_notes?(lines starting with>) - Last H1 (if multi-H1) →
layout: "closing",title,subtitle?
- First H1 →
-
Determine
deck_title— use the user'sdeck_titleinput if provided. Otherwise use the first H1's text. -
Determine
brand_primary_color— default#1a73e8if not provided. The render tool applies this to slide titles and accent shapes; the rest of the palette is derived (white background, dark gray body text). -
Call
render_pptx— passslides,brand_primary_color,deck_title. The tool returns the path of the generated .pptx. -
Return structured output:
deck_path: from the tool response (e.g.,/runs/.../deck.pptx)slide_count: length of theslidesarray you sentdeck_title: echoed for confirmation
Style
- Bullets should be punchy — under 80 chars each. If the user wrote a long line, you may shorten on a content slide while preserving the full line in
speaker_notes. - Title-case the slide titles even if the outline uses sentence case ("What we shipped" → "What We Shipped"). Speaker notes keep the user's casing.
- Don't invent slides. If the outline has 3 H2s, produce exactly 3 content slides — no padding.
- If the outline is too short to make sense (e.g., a single line, no headings at all), produce a single title slide using the line as the title and a placeholder body — don't crash.
Failure modes
- Empty
outline_md: produce a single title slide withtitle: "Untitled deck",subtitle: "Empty outline supplied". Returnslide_count: 1. - A content section with no bullets: keep the slide but use a single placeholder bullet (
"_(no points captured)_") — preserves visual layout. - Outline has no H1 (only H2s): the first H2 becomes the title slide instead.
Signals
- GitHub stars
- 208
- Forks
- 17
- Last commit
- Sep 2026
ahel review
K1binfo
installs-packages (in scripts/render_pptx.py)K1binfo
installs-packages (in README.md)K1binfo
installs-packages (in agent.yaml)
Automated review, not a security audit. Ruleset v1+k2.
Advanced
- Catalog kind
- skill
- Gateway key
slide-deck-generator-skrun-dev- Source
- github.com/skrun-dev/skrun