登壇スライドを Marp で作るときの、ストーリー・図・デザインバランスの型をまとめたものです。AIエージェント（Claude Code など）に読ませるスキルの形にしてあり、人が読んでもそのまま使えます。

AIにスライドを書かせると、体裁は整うのに話が薄くなりがちです。作者（@minorun365）が自分の登壇資料を作るなかで、エージェントへ繰り返し伝えてきた直し方を、規則と検査スクリプトに落としました。

Claude デスクトップアプリの「Code」タブ（または Claude Code）で、このURLを渡して頼むだけです。

https://github.com/minorun365/minorun-marp-skill のスキルを入れて

入れ終わったら新しいセッションを始め、「黒地のテーマで、勉強会の20分のスライドを作って」のように頼むと使われます。新しい版が出たときは「minorun-marp-skill を最新にして」で更新できます。

この節は Claude が読むための手順です。自分で入れる人も、この順に進めれば入れられます。

1. リポジトリを ~/.claude/skill-repos/minorun-marp-skill へ置く。無ければ git clone、あれば git pull
2. skills/ の3つ（slide-story slide-figures slide-design-dark）を ~/.claude/skills/ へコピーする。同じ名前があれば上書きする
3. 書き出しと検査に使う道具があるかを確かめ、無いものを入れる。Marp CLI（npm i -g @marp-team/marp-cli）、Google Chrome、poppler と mupdf-tools（macOS なら brew install poppler mupdf-tools）、Python 3 と Pillow。check-svg-box-fit.mjs は Marp CLI 同梱の puppeteer-core を借りるので、場所が違う環境では MARP_NODE_MODULES と CHROME_PATH で指定する
4. 結果は、何が使えるようになったかと頼み方の例を、コマンドを見せずに平易な言葉で伝える

スライドを作るときは、~/.claude/skill-repos/minorun-marp-skill から theme/ と tools/ を作業フォルダへコピーして使う。

marp --no-stdin deck.md --pdf --theme theme/minorun-dark.css --allow-local-files

python3 tools/check-dark-margins.py deck.pdf    # 中身の下端と右端の空き
python3 tools/check-dark-gaps.py deck.pdf       # 図や箱と、隣の本文の間隔
python3 tools/check-figure-text.py deck.pdf     # 図の中の小さい文字、箱の縁に詰まった文字
node tools/check-svg-box-fit.mjs images/*.svg   # SVGの文字が箱に収まっているか
python3 tools/check-reuse-diff.py new.md old.md # 流用したスライドの、見出しと図の対応
python3 tools/check-ai-smell.py deck.md         # 書き換えたスライドの文の型の反復

テーマは丸ゴシック系を想定しています。第一候補の Zen Maru Gothic を入れておくと揃い、未導入の macOS ではヒラギノ丸ゴで表示されます。作者の手元では有償の丸ゴシック書体を使っているので、公開されている登壇資料とは字形が少し違います。

作者のスライドには「いらすとや」の挿絵がよく登場します。画像はこのリポジトリに同梱していないので、見本デッキを書き出す前に取得してください。利用条件は各自で確かめてください。

sh examples/sample/fetch-illustrations.sh

Apache License 2.0. Copyright 2026 Minoru Onda

見本デッキの一覧画像に写っている挿絵は「いらすとや」の著作物で、このライセンスの対象外です。