marp-slide

from softaworks/agent-toolkit

A curated collection of skills for AI coding agents. Skills are packaged instructions and scripts that extend agent capabilities across development, documentation, planning, and professional workflows.

254 stars12 forksUpdated Jan 25, 2026
npx skills add https://github.com/softaworks/agent-toolkit --skill marp-slide

SKILL.md

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

...

Read full content

Repository Stats

Stars254
Forks12
LicenseMIT License