ClaudeMap

minorun-marp-skill

Three Japanese-language Marp slide skills plus a black-and-cyan theme and five measurement scripts that catch the layout failures eyes miss.

Skills & Commandsmarpslidespresentationthemeqa-scripts

Built from the corrections @minorun365 kept repeating while making their own conference decks, this pack turns those fixes into rules and check scripts. slide-story covers the narrative: hooks, section dividers, progressive disclosure, heading style, closings and length estimation. slide-figures covers drawing: cutting information density, SVG technique, minimum font sizes, where illustrations go. slide-design-dark covers measuring margins, vertical balance, dark colour schemes, table and code styling, and Marp's traps. The shipped theme is black with cyan accents, and the tools measure exported PDFs and SVGs — bottom and right margin clearance, gaps between figures and body text, small text inside figures, text overflowing SVG boxes, and heading/figure drift in reused slides.

What it does

  • Three skills copy straight into ~/.claude/skills/: slide-story (narrative shape), slide-figures (figures and SVG), slide-design-dark (dark-theme layout and Marp pitfalls)
  • Five check tools ship with a deliberately broken example deck (examples/broken) that proves each check actually fires: check-dark-margins.py, check-dark-gaps.py, check-figure-text.py, check-svg-box-fit.mjs, check-reuse-diff.py
  • theme/minorun-dark.css — a black-background, cyan-accent Marp theme meant for rounded-gothic fonts (Zen Maru Gothic first, Hiragino Maru fallback on macOS without it)
  • Readable by humans too: the author notes the rules work as ordinary slide-making advice, not only as agent instructions

When to use it

Anyone who ships Marp decks via Claude Code and is tired of well-formatted-but-thin output: let the skills shape the story, then let the scripts measure what projectors actually punish — bottom-margin crowding, cramped figure gaps, unreadably small text inside SVGs.

Getting started

git clone https://github.com/minorun365/minorun-marp-skill.git
cp -r minorun-marp-skill/skills/* ~/.claude/skills/
# copy theme/ and tools/ into the repo that holds the deck
cd minorun-marp-skill && npm i -g @marp-team/marp-cli
marp --no-stdin deck.md --pdf --theme theme/minorun-dark.css --allow-local-files
python3 tools/check-dark-margins.py deck.pdf

Things to know

The skills, docs and comments are in Japanese — Claude Code reads them fine, but editing them requires Japanese. The check toolchain needs Marp CLI + Google Chrome, poppler (pdftoppm/pdfinfo), mupdf-tools (mutool) and Python 3 with Pillow; check-svg-box-fit.mjs borrows puppeteer-core from Marp CLI (relocate via MARP_NODE_MODULES / CHROME_PATH). Sample-deck illustrations are いらすとや artwork: not bundled, outside the license — fetch them separately and check their terms yourself. The author's own decks use a paid rounded-gothic font, so published samples differ slightly in letterforms. Apache-2.0.

Repository

minorun365/minorun-marp-skill

Charted

Related on the map

  • Guizang's agent skill turns your repo's recent updates into a finished promo video — real components, code-rendered animation, an original code-written soundtrack — no video editor involved.

    • agent-skill
    • video
    • promo
    • marketing
  • An agent skill that geolocates a photo with nothing readable in it — OSM geometry, elevation skylines and satellite tiles turn “where was this taken?” into a measured answer with an error radius.

    • agent-skill
    • geolocation
    • osint
    • openstreetmap
  • A skill that makes AI coding agents map the architecture and declare the blast radius before they touch a line of code — rendered as one standalone HTML page.

    • skill
    • architecture
    • code-visualization
    • change-scope