---
name: "marp-markdown-presentation-styler"
description: "Write slick presentation slides in plain Markdown with Marp CLI and custom CSS themes."
metadata:
  author: "Marp"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "compile marp markdown to slides"
  - "export marp to pdf"
  - "create custom marp theme"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

# Marp Markdown Presentation Engine

Converts Markdown files into responsive HTML5 slides, PDFs, or PPTX presentations using Marp core directives: theme, paginate, header, footer, and scoped CSS styling.

## When to Invoke
Invoke this skill whenever you need to:
- compile marp markdown to slides
- export marp to pdf
- create custom marp theme

## Execution SOP & Rules
1. Define presentation settings in frontmatter: marp: true, theme: gaia, paginate: true.
2. Separate slides cleanly using triple dashes (---).
3. Use scoped CSS rules (<style scoped> ... </style>) to style specific hero or section divider slides.
4. Export slides via marp --pdf presentation.md -o presentation.pdf --allow-local-files.

## Verification Checklist
- Run local linting, syntax validation, and type-checks before reporting completion.
- Ensure all created or modified files adhere to workspace boundaries and avoid uncommitted secrets.
- Verify tests or build commands exit cleanly with return code 0.