Slidegauge

SlideGauge

[](https://github.com/nibzard/slidegauge/actions/workflows/test.yml) [](https://www.python.org/downloads/) [](https://opensource.org/licenses/MIT)

**Static analyzer for Marp Markdown decks** - validates slide quality with AI-agent-friendly feedback

SlideGauge is a zero-dependency Python tool that analyzes Marp markdown presentations and provides actionable feedback on slide quality. Designed specifically for AI coding agents to use when creating slides, but useful for humans too.

# Try it instantly with uvx (no installation)
uvx --from git+https://github.com/nibzard/slidegauge slidegauge example.md --text

Features

• 🎯 AI-Agent Optimized - Clear, actionable diagnostics with specific suggestions
• 📊 Comprehensive Analysis - Content length, bullets, lines, colors, accessibility, code blocks
• 🎨 Accessibility Checks - WCAG contrast ratios, alt text validation
• 🚀 Zero Dependencies - Single Python file, no external packages
• ⚡ Smart Caching - UUID-based caching for fast re-analysis
• 🔧 Multiple Formats - JSON (default), SARIF, text output

Quick Start

Run with uvx (no installation)

# Analyze a presentation
uvx --from git+https://github.com/nibzard/slidegauge slidegauge presentation.md

# Get text summary
uvx --from git+https://github.com/nibzard/slidegauge slidegauge presentation.md --text

# JSON output (default)
uvx --from git+https://github.com/nibzard/slidegauge slidegauge presentation.md --json

# Try the included example
uvx --from git+https://github.com/nibzard/slidegauge slidegauge example.md --text

Install with uv

# Install globally
uv tool install git+https://github.com/nibzard/slidegauge

# Use it
slidegauge presentation.md

Traditional inst