Skip to content
Back to search

marp-slides

SkillWorks with Claude CodeGitHub

Create beautiful MARP presentation decks with SVG charts, interactive elements, dashboard components, animations, dark/light themes. Triggers on 'marp', 'slides', 'presentation', 'deck'.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/robonuggets--marp-slides/badge.svg)](/listings/robonuggets--marp-slides)

HTML

<a href="/listings/robonuggets--marp-slides"><img src="/api/listings/robonuggets--marp-slides/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Install the skill

git clone https://github.com/robonuggets/marp-slides

2. Add it to Claude Code

Point Claude Code at the skill folder:

claude --add-dir ./marp-slides

Or add it manually to your project's `.claude/skills/` directory.

3. Install the VS Code extension

Install **Marp for VS Code** and enable these settings:

{
  "markdown.marp.enableHtml": true,
  "markdown.marp.allowLocalFiles": true
}

4. Ask for a presentation

Create a MARP presentation reviewing my Q1 sales data. Dark theme, include stat cards and a bar chart.
Make me a deck about my favorite coffee brewing methods. Editorial style, warm tones.
Build a fitness dashboard presentation from this CSV data.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 203 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: marp-slides
  3. description: Create beautiful MARP presentation decks with SVG charts, interactive elements, dashboard components, animations, dark/light themes. Triggers on 'marp', 'slides', 'presentation', 'deck'.
  4. version: 2.0
  5. updated: 2026-04-08
  6. ---
  7. # MARP Slides v2
  8. ## Prerequisites
  9. - VS Code extension "Marp for VS Code"
  10. - Settings: `markdown.marp.enableHtml: true` + `markdown.marp.allowLocalFiles: true`
  11. - Export: `npx @marp-team/marp-cli slides.md --pdf --allow-local-files`
  12. ## Example Decks (CRITICAL — read before generating)
  13. The `examples/` folder contains 22 curated reference decks. **Before generating any deck, read 2-3 examples that match the requested style.** These are the quality bar — match their composition, spacing, and visual density. Key examples by category:
  14. | Category | Examples to read |
  15. |---|---|
  16. | Data / dashboard | `marp_facebook-ads.md`, `marp_fitness.md`, `marp_comparison.md` |
  17. | Lifestyle / editorial | `marp_coffee.md`, `marp_wine-tasting.md`, `marp_cocktail.md` |
  18. | Guide / how-to | `marp_garden.md`, `marp_houseplant.md`, `marp_home-gym.md` |
  19. | Fun / creative | `marp_kids-party.md`, `marp_board-game.md`, `marp_film-director.md` |
  20. | Travel / location | `marp_travel.md`, `marp_walking-tour.md`, `marp_road-trip.md` |
  21. | Showcase / hero | `marp_hero.md`, `marp_apartment.md`, `marp_wardrobe.md` |
  22. | Reference / sampler | `marp_sample.md` (component showcase) |
  23. ## Core Rules
  24. - Slides separated by `---`
  25. - YAML frontmatter controls theme/pagination/styles
  26. - `enableHtml` unlocks SVG, cards, charts, animations, interactive elements
  27. - Default 16:9 (1280x720)
  28. ## Dark Starter Template
  29. The dark template uses Outfit 800 for headings and Raleway 100-200 for body text. CSS variables:
  30. ```css
  31. @import url('https://fonts.googleapis.com/css2?family=Outfit:wght@400;600;700;800&family=Raleway:wght@100;200;300&display=swap');
  32. :root {
  33. --accent: #ff6b1a; --accent-hover: #ff8c4a;
  34. --dark: #000; --card: #080808; --border: #111;
  35. --body: #999; --label: #666; --muted: #555; --light: #fff;
  36. --green: #22c55e; --red: #ef4444; --yellow: #f5a623;
  37. }
  38. section { background: var(--dark); color: var(--light); font-family: 'Raleway', sans-serif; font-weight: 200; padding: 56px 72px; }
  39. h1 { font-family: 'Outfit'; font-weight: 800; font-size: 3em; color: var(--light); }
  40. h2 { font-family: 'Raleway'; font-weight: 100; font-size: 1.3em; color: #888; }
  41. h3 { font-family: 'Outfit'; font-weight: 600; font-size: 0.6em; color: var(--muted); text-transform: uppercase; letter-spacing: 0.2em; }
  42. strong { color: var(--accent); font-weight: 300; }
  43. section.lead { display: flex; flex-direction: column; justify-content: center; align-items: center; text-align: center; }
  44. header { text-align: right; } header img { margin: 0; }
  45. .row:hover { background: #0c0c0c; } .row { transition: background 0.2s; border-radius: 6px; }
  46. details { background: var(--card); border: 1px solid var(--border); border-radius: 10px; padding: 14px 18px; margin-top: 8px; }
  47. details summary { color: var(--accent); font-family: 'Outfit'; font-weight: 600; font-size: 0.8em; cursor: pointer; }
  48. details p { color: var(--body); font-size: 0.78em; margin-top: 8px; }
  49. .tag { font-family: 'Outfit'; font-weight: 600; font-size: 0.55em; letter-spacing: 0.12em; text-transform: uppercase; padding: 3px 10px; border-radius: 4px; }
  50. abbr { text-decoration: none; border-bottom: 1px dotted #333; cursor: help; }
  51. ```
  52. Frontmatter includes: `header: '![w:100](./logo.png)'`
  53. ## Light Theme
  54. Swap vars: `--accent: #2563eb; --dark: #fafafa; --card: #fff; --border: #eee; --body: #666; --label: #bbb; --light: #1a1a1a;`
  55. Use Space Grotesk + IBM Plex Mono or Plus Jakarta Sans.
  56. ## Heading Hierarchy
  57. - h1 = title slides (white, extra large)
  58. - h2 = subtitle (grey, thin)
  59. - h3 = section label (muted, uppercase, small)
  60. ## Font Pairings (Tested)
  61. | Heading | Body | Use |
  62. |---|---|---|
  63. | Outfit 800 | Raleway 100 | Dashboard, data (default) |
  64. | DM Serif Display | DM Sans 300 | Recipes, editorial |
  65. | Space Grotesk 700 | IBM Plex Mono 300 | Travel, light themes |
  66. | Sora 700 | Sora 200 | Product comparisons |
  67. | Urbanist 800 | Urbanist 100 | Music, Spotify-style |
  68. | Plus Jakarta Sans 800 | Plus Jakarta Sans 200 | Retros, team decks |
  69. ## Images
  70. CRITICAL: Relative paths only. `./image.png` works. Absolute paths break in preview.
  71. - Logo header: `header: '![w:100](./logo.png)'` — hide per slide: `<!-- _header: '' -->`
  72. - Photo bg: `![bg brightness:0.15](https://unsplash.com/photo-ID?w=1400)`
  73. - Split: `![bg right:35% brightness:0.2 blur:3px](url)` or `![bg left:30%](url)`
  74. - CDN logos: `<img src="https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/name.png" style="width:200px;" />`
  75. - Centered inline: wrap img in `<div style="display:flex; justify-content:center;">` with border-radius and border
  76. ## Dashboard Components
  77. ### Metric Card (gradient top border)
  78. Card with `position:relative; overflow:hidden;` and absolute div at top with `background:linear-gradient(90deg, var(--accent), transparent); height:2px;`. Icon + label + big number + trend arrow.
  79. ### Status Dots
  80. Inline SVG circles: green (#22c55e) = active, yellow (#f5a623) = learning, red (#ef4444) = paused.
  81. `<svg width="8" height="8" viewBox="0 0 8 8"><circle cx="4" cy="4" r="4" fill="#22c55e"/></svg>`
  82. ### Verdict Tags
  83. `<span class="tag" style="background:#22c55e12; color:var(--green); border:1px solid #22c55e22;">Scale</span>`
  84. Swap colors for red (kill) and yellow (review).
  85. ### Hover Rows
  86. Wrap content in `<div class="row">` for hover highlight effect.
  87. ## SVG Charts
  88. ### Line / Area Chart
  89. SVG polyline for the line + polygon with linearGradient fill for area under the line. Add grid lines, dashed target line, circle data points. Use viewBox="0 0 900 240" with preserveAspectRatio="none".
  90. ### Pie / Donut Chart
  91. Each segment = separate circle with stroke-dasharray and stroke-dashoffset. Math: circumference = 2*pi*r. For r=110: ~691. Segment = (pct/100)*691. Offsets accumulate negatively. stroke-width controls ring thickness. Always transform="rotate(-90 cx cy)".
  92. ### Gauge / Half-Circle Meter
  93. SVG path arc for background + colored value arc. Needle line from center + circle pivot. For scores 0-100. stroke-linecap="round".
  94. ### Donut Ring
  95. Single circle stroke-dasharray. circ = 2*pi*r. Offset = circ - (circ * pct/100). For r=74: circ=465. 89%: offset=51.
  96. ### Sparkline (inline mini)
  97. `<svg width="50" height="16"><polyline points="0,14 8,12 16,10 24,8 50,2" fill="none" stroke="#22c55e" stroke-width="1.2"/></svg>`
  98. ### Stacked Bar
  99. Flex div with colored width-percent segments, border-radius, overflow:hidden.
  100. ### Vertical Bar Chart
  101. Flex container align-items:flex-end. Gradient bars: `background:linear-gradient(180deg, var(--accent), #cc5515); border-radius:3px 3px 0 0;`
  102. ### Radar / Spider
  103. SVG polygon for hexagonal grid + data shape with fill-opacity:0.1 and stroke outline.
  104. ## Interactive Elements
  105. - Collapsible: `<details><summary>Title</summary><p>Content</p></details>`
  106. - Tooltip: `<abbr title="Full text">TERM</abbr>`
  107. - Slider: `<input type="range" style="accent-color:var(--accent);" />`
  108. - Checkbox: `<input type="checkbox" checked style="accent-color:var(--accent);" />`
  109. - Progress: `<progress value="76" max="100" style="accent-color:var(--accent);"></progress>`
  110. ## Layout Components
  111. - Before/After Split — two flex panels, border-top red vs green
  112. - Terminal Mockup — traffic light dots + monospace body
  113. - Browser Mockup — dots + URL bar div
  114. - Chat Bubbles — user (left) + agent (right, orange-tinted)
  115. - Flowchart — boxes + SVG arrow connectors
  116. - Timeline — vertical border-left + dot circles
  117. - Card Row — display:flex; gap:14px; with flex:1 children
  118. ## SVG Icons
  119. All wrapped in `<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="var(--accent)" stroke-width="1.5">`. Sizes: inline=16, cards=44, features=32.
  120. Dollar: path d="M12 2v20M17 5H9.5a3.5 3.5 0 1 0 0 7h5a3.5 3.5 0 1 1 0 7H6"
  121. Heartbeat: polyline points="22 12 18 12 15 21 9 3 6 12 2 12"
  122. Check (#22c55e): path d="M22 11.08V12a10 10 0 1 1-5.93-9.14" + polyline points="22 4 12 14.01 9 11.01"
  123. Arrow up (#22c55e): polyline points="18 15 12 9 6 15"
  124. Arrow down (#ef4444): polyline points="18 9 12 15 6 9"
  125. X circle (#ef4444): circle cx=12 cy=12 r=10 + two crossing lines
  126. Clock: circle cx=12 cy=12 r=10 + polyline points="12 6 12 12 16 14"
  127. Eye: path d="M1 12s4-8 11-8 11 8 11 8-4 8-11 8-11-8-11-8z" + circle cx=12 cy=12 r=3
  128. Lightning: path d="M13 2L3 14h9l-1 8 10-12h-9l1-8z"
  129. Warning (#f5a623): triangle path
  130. Search: circle cx=11 cy=11 r=8 + line to corner
  131. Bars: three vertical paths
  132. Users: user silhouette path + circle
  133. Globe: circle + horizontal line + vertical ellipse path
  134. Lock: rect + arch path
  135. Book: two paths for book shape
  136. ## Animations (HTML export + preview only)
  137. float: translateY(0) to -8px and back
  138. glow: box-shadow pulse with accent color
  139. blink: border-color toggle for cursors
  140. Stagger with delay: animation: float 4s ease-in-out 0.5s infinite;
  141. ## Export
  142. npx @marp-team/marp-cli slides.md --pdf --allow-local-files
  143. npx @marp-team/marp-cli slides.md --pptx --allow-local-files
  144. npx @marp-team/marp-cli slides.md --html --allow-local-files
  145. --pptx-editable needs LibreOffice. Animations + details only in HTML.
  146. ## Design Rules
  147. 1. One idea per slide. Overflow clips silently.
  148. 2. h1 = white. Accent for data highlights only.
  149. 3. Body text #999, labels #666. Never darker than #555.
  150. 4. Max 6 rows per list slide.
  151. 5. Charts over numbers. Mix visual types across slides.
  152. 6. Relative paths only for images.
  153. 7. Always preview — no overflow warnings in source.
  154. 8. Per-slide overrides: _backgroundColor, _header, _paginate, _footer
  155. Custom dimensions: section { width: 540px; height: 720px; } (CSS not size: frontmatter).
  156. Portrait: stack vertically, scale down 15-20%.
README.md · README · 108 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # MARP Slides
  2. A Claude Code skill for creating beautiful presentations using [MARP](https://marp.app) — SVG charts, dashboard components, dark/light themes, and 22 curated example decks to learn from.
  3. ## What it does
  4. Give Claude Code a topic and it builds a polished MARP deck. The skill teaches it how to compose slides using SVG charts, metric cards, gauges, sparklines, progress bars, expandable sections, and more — all in raw HTML inside Markdown.
  5. The 22 example decks are the secret sauce. Instead of just knowing the building blocks, Claude reads real decks that look good and matches that quality bar.
  6. ## Quick start
  7. ### 1. Install the skill
  8. ```bash
  9. git clone https://github.com/robonuggets/marp-slides
  10. ```
  11. ### 2. Add it to Claude Code
  12. Point Claude Code at the skill folder:
  13. ```bash
  14. claude --add-dir ./marp-slides
  15. ```
  16. Or add it manually to your project's `.claude/skills/` directory.
  17. ### 3. Install the VS Code extension
  18. Install **Marp for VS Code** and enable these settings:
  19. ```json
  20. {
  21. "markdown.marp.enableHtml": true,
  22. "markdown.marp.allowLocalFiles": true
  23. }
  24. ```
  25. ### 4. Ask for a presentation
  26. ```
  27. Create a MARP presentation reviewing my Q1 sales data. Dark theme, include stat cards and a bar chart.
  28. ```
  29. ```
  30. Make me a deck about my favorite coffee brewing methods. Editorial style, warm tones.
  31. ```
  32. ```
  33. Build a fitness dashboard presentation from this CSV data.
  34. ```
  35. ## What's included
  36. ```
  37. marp-slides/
  38. ├── SKILL.md # The skill — rules, components, design system
  39. └── examples/ # 22 curated reference decks
  40. ├── marp_facebook-ads.md # Data dashboard with SVG charts
  41. ├── marp_coffee.md # Editorial lifestyle deck
  42. ├── marp_fitness.md # Health tracking dashboard
  43. ├── marp_wine-tasting.md # Tasting notes with ratings
  44. ├── marp_travel.md # Travel guide with maps
  45. ├── marp_kids-party.md # Fun creative deck
  46. └── ... 16 more examples
  47. ```
  48. ## Example categories
  49. | Category | Examples | Style |
  50. |---|---|---|
  51. | Data / dashboard | facebook-ads, fitness, comparison | SVG charts, stat cards, gauges |
  52. | Lifestyle / editorial | coffee, wine-tasting, cocktail | Warm tones, photography, ratings |
  53. | Guide / how-to | garden, houseplant, home-gym | Step-by-step, tips, checklists |
  54. | Fun / creative | kids-party, board-game, film-director | Playful, colorful, interactive |
  55. | Travel / location | travel, walking-tour, road-trip | Maps, itineraries, photo backgrounds |
  56. | Showcase | hero, apartment, wardrobe | Visual-first, minimal text |
  57. ## Features
  58. - **Dark and light themes** with tested font pairings (Outfit + Raleway, DM Serif + DM Sans, Space Grotesk + IBM Plex Mono, and more)
  59. - **SVG charts** — line/area, donut/pie, gauges, sparklines, bar charts, radar
  60. - **Dashboard components** — metric cards with gradient borders, status dots, verdict tags, hover rows
  61. - **Interactive elements** — collapsible `<details>` sections, tooltips, progress bars
  62. - **Layout components** — before/after splits, terminal mockups, chat bubbles, timelines, flowcharts
  63. - **SVG icon library** — 16+ inline icons (dollar, heartbeat, check, arrow, lightning, etc.)
  64. ## Export
  65. ```bash
  66. # PDF
  67. npx @marp-team/marp-cli slides.md --pdf --allow-local-files
  68. # PowerPoint
  69. npx @marp-team/marp-cli slides.md --pptx --allow-local-files
  70. # HTML (keeps animations and interactive elements)
  71. npx @marp-team/marp-cli slides.md --html --allow-local-files
  72. ```
  73. ## How the examples help
  74. The skill file (SKILL.md) teaches the building blocks — CSS variables, chart math, icon paths. But the examples teach **composition** — how to combine those blocks into slides that actually look good. When Claude reads the examples before generating, it matches the spacing, density, and visual rhythm of a real polished deck instead of just stacking components.
  75. ## License
  76. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.