skills.rest
takusaotome
takusaotomeCOMMUNITY
Explore all skills by this author →
GitHub

marp-layout-debugger

Diagnose MARP markdown layout issues and generate JSON reports.

5|4|Updated Nov 9, 2025
Search Tags:#markdown#marp#auto-fix#diff report#layout debugging#css optimization#slide rendering
One-click install
npx skills add https://github.com/takusaotome/claude-skills-library --skill marp-layout-debugger
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: marp-layout-debugger
Source: https://github.com/takusaotome/claude-skills-library/tree/main/skills/marp-layout-debugger
Command: npx skills add https://github.com/takusaotome/claude-skills-library --skill marp-layout-debugger

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you diagnose and correct common MARP slide rendering problems such as whitespace gaps, misaligned boxes, broken bullet indentation, and CSS inconsistencies that cause layout drift.

Core Features & Use Cases

  • Automated layout issue detection: Scans MARP markdown for whitespace (WS*), bullet formatting (BL*), overflow risks (OF*), alignment/CSS anti-patterns (AL*/CS*), and produces a structured JSON report.
  • Safe auto-fixing for common issues: Applies only auto-fixable transformations (when requested) like trailing whitespace removal, tab-to-space conversion, list marker normalization, unsized image sizing, and zero-unit CSS cleanup.
  • Before/after review with diffs: Generates a markdown diff report to make it easy to inspect what changed and what needs manual attention.

Quick Start

Diagnose your slides by running the MARP analyzer on the input markdown file and reviewing the generated issues report before applying fixes.

Frequently Asked Questions about marp-layout-debugger

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix MARP slide layout issues like whitespace gaps and misaligned bullets?▼

Scan MARP markdown to detect whitespace gaps, bullet formatting errors, and alignment problems, then review a structured JSON report categorizing each issue before applying safe auto-fixes.

Why does my MARP markdown render with unexpected CSS inconsistencies and layout drift?▼

MARP markdown renders with CSS inconsistencies and layout drift due to anti-patterns like zero-unit properties or unsized images. A diagnostic scan identifies these CSS issues and categorizes them for manual review or automated cleanup.

Can I automatically normalize bullet formatting and remove trailing whitespace in MARP slides?▼

Automatically normalize bullet formatting and remove trailing whitespace in MARP slides by applying auto-fixable transformations that convert tabs to spaces and normalize list markers for consistent rendering.

What is the best way to review layout fixes applied to MARP markdown?▼

Review MARP markdown layout fixes using a generated markdown diff report that highlights before-and-after changes, distinguishing auto-fixed transformations from items needing manual attention.

Does MARP layout debugging detect overflow risks in slide content?▼

MARP layout debugging detects overflow risks in slide content by scanning markdown for structural formatting issues and categorizing them in a JSON report to prevent content from spilling off slide boundaries.

How do I handle MARP slide rendering problems that cannot be auto-fixed?▼

Review the diagnostic JSON report to identify non-auto-fixable MARP slide rendering problems requiring manual intervention, using the accompanying diff report to guide targeted corrections.

Related Skills

Explore More Design & Creative Skills→
takusaotometakusaotome
5

fujisoft-presentation-creator

Generate FUJISOFT America branded MARP-format Markdown slide decks with template layouts.

Community
Advanced
ivanrvpereiraivanrvpereira
17

marp

Convert Marp-compatible Markdown into PDF, PPTX, and HTML slide decks.

Community
Intermediate
gtheysgtheys
14

marpit-slides

Generate Marpit/Marp slide decks from Markdown content with front-matter and directives.

Community
Intermediate
rezosndrezosnd

excel-generator

Generate styled Excel workbooks with formulas, charts, and data validation.

Community
Intermediate