marp-slide-quality

name	marp-slide-quality
description	Analyze and improve Marp markdown presentations using SlideGauge. Use when working with Marp slides, presentation files ending in .md with marp frontmatter, or when user asks to check, analyze, improve, or validate slide quality. Requires slidegauge package (installed via uvx).
allowed-tools	Read, Edit, Bash, Grep, Glob

Marp Slide Quality Analyzer

This Skill uses SlideGauge to analyze Marp markdown presentations and help you create high-quality slides that follow best practices.

When to use this Skill

• User is working on a Marp presentation (.md file with marp: true frontmatter)
• User asks to check, analyze, validate, or improve slide quality
• User mentions SlideGauge or slide quality issues
• User wants to fix specific slide problems (too many bullets, long content, etc.)

Instructions

1. Initial Analysis

When user asks to analyze their slides:

# Run SlideGauge with text output for quick overview
uvx --from git+https://github.com/nibzard/slidegauge slidegauge <path-to-presentation.md> --text

Explain the results:

• Overall score and passing rate
• Number of issues found
• Category breakdown (a11y, code, color, content, layout)

2. Detailed Analysis

For slides that need fixing (score < 80):

# Get JSON output with detailed diagnostics
uvx --from git+https://github.com/nibzard/slidegauge slidegauge <path-to-presentation.md> --json | jq