Agent skill

Slide Deck Generator

by skrun-dev in skrun-dev/skrun

Generate a real PowerPoint .pptx deck from a Markdown outline.

MITAuto-check passedDocuments & Office

Install Slide Deck Generator

skills CLI
$ npx skills add skrun-dev/skrun --skill slide-deck-generator -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install skrun-dev/skrun slide-deck-generator --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/skrun-dev/skrun.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agents/slide-deck-generator .claude/skills/slide-deck-generator && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
slide-deck-generator
GitHub stars
210
Token cost
~866 tokens
SKILL.md length
441 words
Files
6 (incl. scripts)
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

Generate a real PowerPoint .pptx deck from a Markdown outline.

  • Works in 6 steps: Parse the outline — the user passes… → Choose layouts — for each slide produce… → Determine deck_title — use the user's… → …
  • Asked to make a deck
  • SKILL.md covers Workflow, Style and Failure modes
  • Runs Python scripts from its folder

What it does

Slide Deck Generator is an agent skill from skrun-dev/skrun. Generate 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.

Its SKILL.md is about 870 tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts (for example `README.md`, `agent.yaml` and `fixtures/outline.md`).

It sits in Documents & Office, covering Slides and decks and PowerPoint presentations. It works with Microsoft PowerPoint. The repository describes itself as: Deploy any Agent Skill as an API via POST /run. The open-source multi-model alternative to Claude Managed Agents, Microsoft Foundry & Mistral/Koyeb — works with any LLM. The licence is MIT.

When your agent uses it

  • Asked to make a deck
  • Render slides from a brief
  • Turn talking points into a presentation file

Example prompts

  • “/slide-deck-generator”

Requirements

  • Python 3

Workflow steps

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

  1. Parse the outline — the user passes outline_md. The format is a relaxed Markdown
  2. Choose layouts — for each slide produce a { layout, title, subtitle?, bullets?, speaker_notes? } object
  3. Determine deck_title — use the user's deck_title input if provided. Otherwise use the first H1's text.
  4. Determine brand_primary_color — default #1a73e8 if not provided. The render tool applies this to slide titles and accent shapes; the rest…
  5. Call render_pptx — pass slides, brand_primary_color, deck_title. The tool returns the path of the generated .pptx.
  6. Return structured output

What it can do on your machine

Read from SKILL.md and the folder at commit b1d963b. 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 1 file in scripts/ (Python), which the agent can run.

    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

Slide Deck Generator loads about 866 tokens when it runs. Until then it costs about 83 tokens; SKILL.md has 441 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~83
When it runs · the whole SKILL.md, loaded when a task matches
~866

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

Auto-check passed

The automated check found no risky patterns in SKILL.md.

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 skrun-dev/skrun at commit b1d963b, republished under its MIT licence (© skrun-dev). 441 words, ~866 tokens.

Download SKILL.mdSave it as .claude/skills/slide-deck-generator/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
slide-deck-generator
description
Generate 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.

Slide Deck Generator

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

  1. Parse the outline — the user passes outline_md. The format is a relaxed Markdown:

    • The first # H1 becomes the title slide (heading = deck main title; the line immediately following — if any non-empty paragraph — becomes the subtitle).
    • Subsequent ## H2 blocks 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).
  2. 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?
  3. Determine deck_title — use the user's deck_title input if provided. Otherwise use the first H1's text.

  4. Determine brand_primary_color — default #1a73e8 if 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).

  5. Call render_pptx — pass slides, brand_primary_color, deck_title. The tool returns the path of the generated .pptx.

  6. Return structured output:

    • deck_path: from the tool response (e.g., /runs/.../deck.pptx)
    • slide_count: length of the slides array you sent
    • deck_title: echoed for confirmation
Show full SKILL.md (158 more words)Show less

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 with title: "Untitled deck", subtitle: "Empty outline supplied". Return slide_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.

© skrun-dev, 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 5 other files (scripts) in agents/slide-deck-generator of skrun-dev/skrun.

  • SKILL.md
  • README.md
  • agent.yaml
  • fixtures/outline.md
  • requirements.txt
  • scripts/render_pptx.py

Open the folder on GitHubat commit b1d963b

Compare with similar skills

Slide Deck Generator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Slide Deck Generator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Slide Deck Generator this skillskrun-dev/skrun210—~866Automated safety check: PassMIT
Image To Editable Pptningzimu/image-to-editable-ppt-skill2.8k—~4.3kAutomated safety check: PassMIT
Slidesfcakyon/claude-codex-settings1.2k1 repos~1.1kAutomated safety check: PassMIT
Ppt Image FirstNyxTides/ppt-image-first1.2k—~1.6kAutomated safety check: PassApache-2.0
Gpt Image2 PptJuneYaooo/gpt-image2-ppt-skills1.3k—~8.9kAutomated safety check: NotesApache-2.0
HTML Slide To PPTXmucsbr/ppt-agent-workflow-san643—~1.1kAutomated safety check: PassNone

Similar skills

  • Image To Editable Ppt

    ningzimu/image-to-editable-ppt-skill

    Rebuild slide images, scanned or image-based PPT/PPTX files, and PDF decks into object-level editable PowerPoint (.pptx), preserving speaker notes when supplied.

    2.8k GitHub stars~4.3k tokensUpdated 22 days ago
    Documents & OfficeAuto-check passed
  • Slides

    fcakyon/claude-codex-settings

    Create and edit presentation slide decks (.pptx) with PptxGenJS, bundled layout helpers, and render/validation utilities.

    1.2k GitHub starsUsed in 1 repo~1.1k tokens
    Documents & OfficeAuto-check passed
  • Ppt Image First

    NyxTides/ppt-image-first

    Build presentation plans for PPT / slides / decks through a conversation-first workflow, then propose multiple visual directions with preview images before writing deck specs.

    1.2k GitHub stars~1.6k tokensUpdated 5 mo ago
    Documents & OfficeAuto-check passed
  • Gpt Image2 Ppt

    JuneYaooo/gpt-image2-ppt-skills

    Generate visually striking PPT slides via OpenAI's gpt-image-2 -- use any style in styles/<collection/STYLEID.md or mimic a user-supplied .pptx template; outputs high-res slide PNGs and a 16:9 .pptx.

    1.3k GitHub stars~8.9k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check: notes
  • HTML Slide To PPTX

    mucsbr/ppt-agent-workflow-san

    Convert structured single-slide or small deck HTML files into editable PPTX slides with native text boxes, shapes, chips, arrows, and panels.

    643 GitHub stars~1.1k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Paper Deck

    zsyggg/paper-craft-skills

    将论文、技术文章或知识内容制作成高真实感的 AIGC 幻灯片。先做叙事结构和逐页视觉导演,再调用生图模型生成每一页 16:9 slide image,最后合成为 PPTX/PDF。适合论文汇报、组会、公开课、技术分享、商业化研究展示;当用户提到“论文PPT”“AI生成PPT”“不像AI的PPT”“高质感幻灯片”“逐页生图PPT”时使用。

    1.3k GitHub stars~1.4k tokensUpdated 4 mo ago
    Documents & OfficeAuto-check passed

More from skrun-dev/skrun

All 14 skills in this repo
  • Adr Writer

    skrun-dev/skrun

    Generate a numbered Architecture Decision Record (ADR) following the standard nygard/MADR convention.

    210 GitHub stars~861 tokensUpdated 15 days ago
    Auto-check passed
  • Changelog Generator

    skrun-dev/skrun

    Generate a polished CHANGELOG.md and release-notes.md from a local git repository (or a captured .git-log.txt dump).

    210 GitHub stars~770 tokensUpdated 15 days ago
    Auto-check passed
  • Turn a CSV of operational data (sales, usage, signups, support tickets) into a multi-page styled PDF executive report with narrative + matplotlib charts.

    210 GitHub stars~1.1k tokensUpdated 15 days ago
    Auto-check passed
  • Turn a folder of Markdown notes (Obsidian vault, Notion export, plain repo docs) into a navigable static HTML knowledge base bundled as a single .zip file.

    210 GitHub stars~1.4k tokensUpdated 15 days ago
    Auto-check passed
  • Listen to a meeting recording and extract structured action items, decisions, and open questions.

    210 GitHub stars~1.3k tokensUpdated 15 days ago
    Auto-check passed
  • Semgrep Rule Creator

    skrun-dev/skrun

    Generate a complete Semgrep rule bundle (rule.yml + tests.md + README.md) from a CVE description and a bad-code example.

    210 GitHub stars~1.3k tokensUpdated 15 days ago
    Auto-check passed

Questions about Slide Deck Generator

What does Slide Deck Generator do?

Generate a real PowerPoint .pptx deck from a Markdown outline. Slide Deck Generator is an agent skill from skrun-dev/skrun.pptx deck from a Markdown outline.

When should I use Slide Deck Generator?

Slide Deck Generator fits situations like: asked to make a deck; render slides from a brief; turn talking points into a presentation file.

How do I install Slide Deck Generator in Claude Code?

Run `npx skills add skrun-dev/skrun --skill slide-deck-generator -a claude-code`. Or copy the skill folder (agents/slide-deck-generator in skrun-dev/skrun) into .claude/skills/slide-deck-generator in your project. Claude Code loads it when a task matches its description.

How do I install Slide Deck Generator in Codex?

Run `npx skills add skrun-dev/skrun --skill slide-deck-generator -a codex`. Or copy the skill folder (agents/slide-deck-generator in skrun-dev/skrun) into .agents/skills/slide-deck-generator in your project. Codex loads it when a task matches its description.

Can I use Slide Deck Generator in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add skrun-dev/skrun --skill slide-deck-generator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/slide-deck-generator, .gemini/skills/slide-deck-generator, .github/skills/slide-deck-generator and .opencode/skills/slide-deck-generator in your project.

What does Slide Deck Generator need to run?

Going by SKILL.md and its folder, Slide Deck Generator needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Slide Deck Generator access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Slide Deck Generator safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Slide Deck Generator use?

Slide Deck Generator is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Slide Deck Generator use?

About 866 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Slide Deck Generator?

Skills that share tags, products or a category with Slide Deck Generator: Image To Editable Ppt (ningzimu/image-to-editable-ppt-skill, 2.8k stars), Slides (fcakyon/claude-codex-settings, 1.2k stars), Ppt Image First (NyxTides/ppt-image-first, 1.2k stars) and Gpt Image2 Ppt (JuneYaooo/gpt-image2-ppt-skills, 1.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Slide Deck Generator?

skrun-dev (a GitHub organization) maintains it in skrun-dev/skrun, which has 210 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on September 22, 2026.

Source: skrun-dev/skrun on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.