mcpField
M
marp-slide-quality

marp-slide-quality

github.com/podoDocuments29161 installsUpdated 1d ago
Repository

About marp-slide-quality

marp-slide-quality is a skill that analyzes Marp Markdown presentations before rendering. It reports visual-quality issues such as overflow, contrast, text density, missing structure, and layout anti-patterns, with scored results and suggested fixes.

Key features

  1. 01Detects slide content overflow
  2. 02Checks color contrast
  3. 03Flags excessive text density
  4. 04Finds missing structure and layout issues
  5. 05Provides scored reports and fix suggestions

Use cases

  1. 01Reviewing a Marp deck after drafting
  2. 02Finding overflow before rendering slides
  3. 03Checking presentation contrast and text density
  4. 04Prioritizing fixes with a quality report

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/podo/design-agent-skills --skill marp-slide-quality

After installing, type/marp-slide-qualityin Claude Code to confirm it loaded.

Bundled filesstub.yaml

Details

From the project README

marp-slide-quality

Catalogue stub — full skill: nibzard/marp-slide-quality

Decision tree

  1. Is the full skill already installed? Check whether the skill at this location still has a das: block:

    • Global: grep -q "^das:" ~/.agents/skills/marp-slide-quality/SKILL.md 2>/dev/null && echo "pointer" || echo "installed"
    • Project: grep -q "^das:" .agents/skills/marp-slide-quality/SKILL.md 2>/dev/null && echo "pointer" || echo "installed"
    • No das: block → full skill installed, invoke it and proceed
    • das: block present → go to step 2

  2. Detect scope, then install:

    To detect scope:

    [ -e ~/.agents/skills/marp-slide-quality ] && echo "global" || echo "project"

    Global (installed with -g):

    npx skills add nibzard/marp-slide-quality --skill marp-slide-quality -g -y

    Project (installed without -g):

    npx skills add nibzard/marp-slide-quality --skill marp-slide-quality -y

    Claude Code: send either command as a chat message starting with ! to run it without leaving the conversation.

Invoke after install

Skill name: marp-slide-quality, triggers: "marp slide quality", "SlideGauge", "marp-slide-quality", "nibzard marp"

What it does

Runs SlideGauge quality analysis on Marp Markdown presentations before they are rendered, catching problems that only appear visually at render time. Detects content overflow (text spilling past slide boundaries), insufficient color contrast, excessive text density, missing structure elements, and layout anti-patterns. Produces a scored report with specific fix recommendations. Best used as a post-creation review pass after marp-slides generates the initial deck.

When NOT to use

  • Reveal.js or Slidev presentations — SlideGauge is Marp-specific
  • Creating slides from scratch — use marp-slides first, then run this for quality review
  • When you need Marp rendered output — this analyzes the Markdown source, not the render

Comments

Markdown supported