marp-slides — Claude Code skill: Marp decks from Markdown
marp-slides — a skill that walks the agent through Marp Markdown decks: slide density, visual hierarchy, plus ready SVG charts and a dark or light theme.
MIT 204 installs ★ 35 updated 2026-10-21
npx skills add podo/design-agent-skills --skill marp-slides -a claude-codeWhat marp-slides does
The agent gets a set of example decks to look at before writing its own, covering different content types and looks. Chart pieces are SVG, dashboard-style blocks are included, and there are two theme variants. From those examples the agent picks up how much text a slide can hold and how to keep the hierarchy readable.
Rendering is not part of it. You need the Marp for VS Code extension with markdown.marp.enableHtml and markdown.marp.allowLocalFiles switched on, or @marp-team/marp-cli run through npx for a PDF.
Picking this for animated or interactive slides is a mistake: that is revealjs-skill territory, and decks built from Vue components belong to slidev-skill. A review pass over an existing deck is a separate job, handled by marp-slide-quality.
What it helps with
- turn a Markdown file into a slide deck for a team talk
- drop an SVG chart onto a slide without hand-coding the layout
- build a dashboard slide with several metrics side by side
- switch a deck to the dark theme
- keep text density even across every slide
Example prompts for the agent
- Build a Marp presentation from
report.mdwith five slides in the dark theme. - Add a slide with an SVG chart based on
metrics.csv. - Rework
pitch.mdinto the light theme, text density like the marp-slides examples.
How to install marp-slides
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill marp-slides -a claude-code2Manually: put the files in place
~/.claude/skills/marp-slides/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/marp-slides/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill marp-slides -a codex2Manually: put the files in place
.agents/skills/marp-slides/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill marp-slides -a cursor2Manually: put the files in place
.cursor/skills/marp-slides/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install podo/design-agent-skills skills/marp-slides2Manually: put the files in place
.github/skills/marp-slides/SKILL.md1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill marp-slides -a gemini-cli2Platform CLI
gemini skills install https://github.com/podo/design-agent-skills --path skills/marp-slidesManually: put the files in place
.devin/skills/marp-slides/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill marp-slides -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about marp-slides
How do I install marp-slides in Claude Code?
Run npx skills add podo/design-agent-skills --skill marp-slides -a claude-code. The skill lands at ~/.claude/skills/marp-slides/SKILL.md.
What does marp-slides do?
It teaches the agent to build Marp presentations from Markdown, with example decks, SVG charts, dashboard blocks and two themes to draw on.
How is it different from revealjs-skill and slidev-skill?
Animated or interactive slides go to revealjs-skill, and decks made of Vue components go to slidev-skill. marp-slides sticks to plain Markdown and static layout.
Source text
SKILL.md · MIT
--- name: marp-slides description: | Marp presentation skill with a library of curated example decks, SVG charts, dashboard components, and dark/light themes. Teaches slide composition and visual quality patterns for Markdown-based presentations rendered with the Marp framework. triggers: - "Marp" - "marp-slides" - "Marp presentation" - "robonuggets slides" das: type: skill category: presentations upstream: "https://github.com/robonuggets/marp-slides" upstream_path: "SKILL.md" version: latest install: true --- # marp-slides > Catalogue stub — full skill: [robonuggets/marp-slides](https://github.com/robonuggets/marp-slides) <!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block --> ## Decision tree 1. **Is the full skill already installed?** - Global: `f=~/.agents/skills/marp-slides/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - Project: `f=.agents/skills/marp-slides/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - `installed` → the skill is installed as `marp-slides`, invoke it and proceed - `pointer` → go to step 2 2. **Detect scope, then install:** ```bash [ -e ~/.agents/skills/marp-slides ] && echo "global" || echo "project" ``` **Global:** ```bash npx skills add robonuggets/marp-slides --skill marp-slides -g -y ``` **Project:** ```bash npx skills add robonuggets/marp-slides --skill marp-slides -y ``` > **Claude Code:** send a command as a chat message starting with `!` to run it without leaving the conversation. **Heads-up** - **Requires:** Marp for VS Code extension (or @marp-team/marp-cli, run with npx, to export PDF) - **License:** no LICENSE file in the repo <!-- das:install:end --> ## Invoke after install - Skill name: `marp-slides` - Trigger phrases: "Marp", "marp-slides", "Marp presentation", "robonuggets slides" ## What it does Creates Marp Markdown presentations informed by a set of curated real-world example decks covering different content types and visual styles. Includes SVG-based chart components, dashboard-style layout components, and dark/light theme variants. The examples teach the skill correct slide composition: appropriate information density, visual hierarchy, and component reuse patterns. Rendering and export need the Marp for VS Code extension (with `markdown.marp.enableHtml` and `markdown.marp.allowLocalFiles` on) or `@marp-team/marp-cli`. ## When NOT to use - Animated or interactive slides — use `revealjs-skill` instead - Vue-component developer presentations — use `slidev-skill` instead - Quality-checking an existing Marp deck — use `marp-slide-quality` as a companion after creation
© podo · MIT · podo/design-agent-skills