Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
softaworks avatar

Marp Slide

softaworks/agent-toolkit

  • 3.9k installs
  • 2.2k repo stars
  • Updated March 5, 2026
  • softaworks/agent-toolkit

A skill that generates professional Marp presentation slides with theme selection, template scaffolding, and automatic quality improvements.

About

Marp Slide Creator generates professional presentation slides using Marp markdown syntax with 7 built-in themes (default, minimal, colorful, dark, gradient, tech, business). Developers and educators use this skill when creating lecture materials, seminars, technical talks, or visual presentations from structured content. The skill provides theme selection guidance based on content type, enforces best practices like concise titles and optimal whitespace, supports image integration with Marpit syntax, and handles vague "make it look good" requests by inferring appropriate theme and applying automatic design enhancements. Templates come with embedded CSS for immediate use without external file dependencies. Output files save to a designated directory as markdown with full Marp directives embedded. 7 pre-designed themes (default, minimal, colorful, dark, gradient, tech, business) with embedded CSS Automatic theme selection based on content type and user preference inference Best practices enforced: concise h2 titles, 3-5 bullet points per slide, optimal whitespace Image integration via Marpit syntax with side, centered, and full-background patterns Templates and reference guides for M.

  • 7 pre-designed themes (default, minimal, colorful, dark, gradient, tech, business) with embedded CSS
  • Automatic theme selection based on content type and user preference inference
  • Best practices enforced: concise h2 titles, 3-5 bullet points per slide, optimal whitespace
  • Image integration via Marpit syntax with side, centered, and full-background patterns
  • Templates and reference guides for Marp syntax, image patterns, CSS customization, and advanced features

Marp Slide by the numbers

  • 3,895 all-time installs (skills.sh)
  • +21 installs in the week ending Jul 28, 2026 (Skillselion tracking)
  • Ranked #105 of 1,901 Documentation skills by installs in the Skillselion catalog
  • Security screen: LOW risk (skills.sh audit)
  • Data as of Jul 28, 2026 (Skillselion catalog sync)
At a glance

marp-slide capabilities & compatibility

Capabilities
theme selection and recommendation · template scaffolding with embedded css · best practices enforcement (whitespace, title le · image layout patterns (side, centered, full back · quality checklist verification
Use cases
presentations · documentation · ui design
Platforms
macOS · Windows · Linux
Runs
Runs locally
Pricing
Free
From the docs

What marp-slide says it does

Create professional, visually appealing Marp presentation slides with 7 pre-designed themes and built-in best practices.
SKILL.md - heading
npx skills add https://github.com/softaworks/agent-toolkit --skill marp-slide

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs3.9k
repo stars★ 2.2k
Security audit3 / 3 scanners passed
Last updatedMarch 5, 2026
Repositorysoftaworks/agent-toolkit ↗

What it does

Generate professional presentation slides in Marp format with 7 pre-designed themes and automatic quality formatting.

Who is it for?

Creating lecture materials, seminar presentations, technical talks, business proposals, and event materials

Skip if: Interactive web presentations, real-time collaboration tools, or slide decks with complex animations

When should I use this skill?

User requests slide creation, presentation design, Marp documents, or asks to 'make slides look good'

What you get

A complete Marp markdown file with embedded theme CSS, properly structured content, and ready to export to HTML/PDF.

  • Marp markdown slide deck
  • Themed presentation configuration

By the numbers

  • 7 pre-designed themes available
  • Template structure enforces 3-5 bullet points per slide
  • Title guidance: 5-7 characters for Japanese, 15-25 chars per line for English

Files

SKILL.mdMarkdownGitHub ↗

Marp Slide Creator

Create professional, visually appealing Marp presentation slides with 7 pre-designed themes and built-in best practices.

When to Use This Skill

Use this skill when the user:

  • Requests to create presentation slides or Marp documents
  • Asks to "make slides look good" or "improve slide design"
  • Provides vague instructions like "良い感じにして" (make it nice) or "かっこよく" (make it cool)
  • Wants to create lecture or seminar materials
  • Needs bullet-point focused slides with occasional images

Quick Start

Step 1: Select Theme

First, determine the appropriate theme based on the user's request and content.

Quick theme selection:

  • Technical/Developer content → tech theme
  • Business/Corporate → business theme
  • Creative/Event → colorful or gradient theme
  • Academic/Simple → minimal theme
  • General/Unsure → default theme
  • Dark background preferred → dark or tech theme

For detailed theme selection guidance, read references/theme-selection.md.

Step 2: Create Slides

1. Read relevant references first:

  • Always start by reading references/marp-syntax.md for basic syntax
  • For images: references/image-patterns.md (official Marpit image syntax)
  • For advanced features (math, emoji): references/advanced-features.md
  • For custom themes: references/theme-css-guide.md

2. Copy content from the appropriate template file:

  • assets/template-basic.md - Default theme (most common)
  • assets/template-minimal.md - Minimal theme
  • assets/template-colorful.md - Colorful theme
  • assets/template-dark.md - Dark mode theme
  • assets/template-gradient.md - Gradient theme
  • assets/template-tech.md - Tech/code theme
  • assets/template-business.md - Business theme

3. Read references/best-practices.md for quality guidelines

4. Structure content following best practices:

  • Title slide with <!-- _class: lead -->
  • Concise h2 titles (5-7 characters in Japanese)
  • 3-5 bullet points per slide
  • Adequate whitespace

5. Add images if needed using patterns from references/image-patterns.md

6. Save to /mnt/user-data/outputs/ with .md extension

Available Themes

1. Default Theme

Colors: Beige background, navy text, blue headings Style: Clean, sophisticated with decorative lines Use for: General seminars, lectures, presentations Template: template-basic.md

2. Minimal Theme

Colors: White background, gray text, black headings Style: Minimal decoration, wide margins, light fonts Use for: Content-focused presentations, academic talks Template: template-minimal.md

3. Colorful & Pop Theme

Colors: Pink gradient background, multi-color accents Style: Vibrant gradients, bold fonts, rainbow accents Use for: Youth-oriented events, creative projects Template: template-colorful.md

4. Dark Mode Theme

Colors: Black background, cyan/purple accents Style: Dark theme with glow effects, eye-friendly Use for: Tech presentations, evening talks, modern look Template: template-dark.md

5. Gradient Background Theme

Colors: Purple/pink/blue/green gradients (varies per slide) Style: Different gradient per slide, white text, shadows Use for: Visual-focused, creative presentations Template: template-gradient.md

6. Tech/Code Theme

Colors: GitHub-style dark background, blue/green accents Style: Code fonts, Markdown-style headers with # symbols Use for: Programming tutorials, tech meetups, developer content Template: template-tech.md

7. Business Theme

Colors: White background, navy headings, blue accents Style: Corporate presentation style, top border, table support Use for: Business presentations, proposals, reports Template: template-business.md

Creating Slides Process

Basic Workflow

1. Understand requirements

  • Identify content: title, topics, key points
  • Determine target audience
  • Assess formality level

2. Select theme

  • Use quick selection rules above
  • If uncertain, consult references/theme-selection.md
  • Default to default theme if still unsure

3. Apply template

  • Load appropriate template from assets/
  • CSS is already embedded - no external files needed
  • Maintain template structure

4. Structure content

  • Title slide: <!-- _class: lead --> + h1
  • Content slides: h2 title + bullet points
  • Keep titles to 5-7 characters (Japanese)
  • Use 3-5 bullet points per slide

5. Refine quality

  • Read references/best-practices.md
  • Ensure adequate whitespace
  • Maintain consistency
  • Keep text concise (15-25 chars per line)

6. Add images

  • If needed, consult references/image-patterns.md
  • Common: ![bg right:40%](image.png) for side images
  • Use proper Marp image syntax

7. Output file

  • Save to /mnt/user-data/outputs/
  • Use descriptive filename like presentation.md

Handling "Make It Look Good" Requests

When users give vague instructions like "良い感じにして", "かっこよく", or "make it cool":

1. Infer theme from content:

  • Business content → business theme
  • Technical content → tech or dark theme
  • Creative content → gradient or colorful theme
  • General → default theme

2. Apply best practices automatically:

  • Shorten titles to 5-7 characters
  • Limit bullet points to 3-5 items
  • Add adequate whitespace
  • Use consistent structure

3. Enhance visual hierarchy:

  • Use h3 for sub-sections when appropriate
  • Break up dense text into multiple slides
  • Ensure logical flow (intro → body → conclusion)

4. Maintain professional tone:

  • Match formality to content
  • Use parallel structure in lists
  • Keep technical terms consistent

Image Integration

For slides with images, consult references/image-patterns.md for detailed syntax.

Common patterns:

  • Side image: ![bg right:40%](image.png) - Image on right, text on left
  • Centered: ![w:600px](image.png) - Centered with specific width
  • Full background: ![bg](image.png) - Full-screen background
  • Multiple images: Multiple ![bg] declarations

Example lecture pattern:

## Slide Title

![bg right:40%](diagram.png)

- Explanation point 1
- Explanation point 2
- Explanation point 3

File Output

Always save the final Marp file to /mnt/user-data/outputs/ with .md extension:

  • presentation.md
  • seminar-slides.md
  • lecture-materials.md

Quality Checklist

Before delivering slides, verify:

  • [ ] Theme selected appropriately for content
  • [ ] CSS theme is embedded in the file
  • [ ] Title slide uses <!-- _class: lead -->
  • [ ] All h2 titles are concise (5-7 chars)
  • [ ] Bullet points are 3-5 items per slide
  • [ ] Images use proper Marp syntax
  • [ ] File saved to outputs directory
  • [ ] Content follows best practices

References

Core Documentation

  • Marp syntax: references/marp-syntax.md - Basic Marp/Marpit syntax (directives, frontmatter, pagination, etc.)
  • Image patterns: references/image-patterns.md - Official image syntax (bg, filters, split backgrounds)
  • Theme CSS guide: references/theme-css-guide.md - How to create custom themes based on Marpit specification
  • Advanced features: references/advanced-features.md - Math, emoji, fragmented lists, Marp CLI, VS Code
  • Official themes: references/official-themes.md - default, gaia, uncover themes documentation

Quality & Selection Guides

  • Theme selection: references/theme-selection.md - How to choose the right theme for content
  • Best practices: references/best-practices.md - Quality guidelines for "cool" slides

Templates & Assets

  • Templates: assets/template-*.md - Starting points with embedded CSS for each theme (7 themes)
  • Standalone CSS: assets/theme-*.css - CSS files for reference (already embedded in templates)

Official External Links

  • Marp Official Site: https://marp.app/
  • Marpit Directives: https://marpit.marp.app/directives
  • Marpit Image Syntax: https://marpit.marp.app/image-syntax
  • Marpit Theme CSS: https://marpit.marp.app/theme-css
  • Marp Core GitHub: https://github.com/marp-team/marp-core
  • Marp CLI GitHub: https://github.com/marp-team/marp-cli

Related skills

open.feishu.cnLark MarkdownInstantly turn any markdown file into clean, formatted Lark/Figma-compatible documents without manual reformatting.402klarksuiteLark DocCreate, read, update, summarize, rewrite and manage Feishu/Lark cloud documents directly from agent workflows.377k15.7klarksuiteLark WikiCreate, organize, query, and manage documents, spaces, and members inside Lark (Feishu) knowledge bases directly from AI agent workflows.374k15.7kxixu-meOpensource Guide CoachGet expert, attribution-safe guidance on launching and sustaining an open-source project.270k72xixu-meReadme I18nMaintain consistent, updatable language selector blocks across every README variant in a multilingual repository.270k72juliusbrusseeCavemanCompress SPEC.md files and any spec-adjacent prose into a token-efficient format that preserves precision while slashing context usage.259k1.1k

Forks & variants (1)

Marp Slide has 1 known copy in the catalog totaling 13 installs. They canonicalize to this original listing.

FAQ

How do I choose the right theme for my content?

Use the quick selection rules: tech/developer content → tech theme; business/corporate → business theme; creative/event → colorful or gradient; academic/simple → minimal; general → default. Consult theme-selection.md for detailed guidance.

Can I add images to my slides?

Yes. Use Marpit image syntax like `![bg right:40%](image.png)` for side images, `![w:600px](image.png)` for centered, or `![bg](image.png)` for full backgrounds. See image-patterns.md for complete patterns.

Do I need external CSS files for the themes?

No. All 7 theme templates have CSS embedded, so they work standalone without external dependencies. Save as .md and use directly.

Is Marp Slide safe to install?

skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.

Documentationuibranding
Browse by category
AI & AgentsFrontend & DesignBackend & DataDev ToolsAutomationTesting & ReviewSecurityMonitoring & CloudDocs & Planning
Design & frontend
Design systemsAnimation & motionAccessibility (a11y)CSS & TailwindUI designUXDesign to codeshadcn/uiLanding pagesBest design skills
Most searched skills
find-skillscavemanfrontend-designbrainstormingsystematic-debuggingstop-slopemil-design-engui-ux-pro-maxkarpathy-guidelinesweb-design-guidelinesreact-best-practicesgrill-meimprovemicrosoft-foundryagent-browser
Browse all listings
All agent skillsAll MCP serversAll marketplacesAll plugins

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.