minorun-marp-skill

Name: minorun-marp-skill
Author: minorun365

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

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

見本デッキ

中身

場所	内容
`skills/slide-story`	つかみ、中扉、段階的な開示、見出しの文体、締め方、尺の見積り
`skills/slide-figures`	図の情報量の絞り方、SVGの描き方、文字サイズの下限、挿絵の置き方
`skills/slide-design-dark`	余白の測り方、縦のバランス、黒地の配色、表とコードのデザイン、Marpの罠
`theme/minorun-dark.css`	黒地にシアンの Marp テーマ
`tools/`	書き出したPDFとSVGを実測する検査スクリプト
`examples/sample`	見本デッキ。`examples/broken` は検査が反応することを確かめるための、わざと崩した版

使い方

Claude Code で使うなら、skills/ の3つを自分のスキル置き場へコピーします。

cp -r skills/* ~/.claude/skills/

テーマと検査スクリプトは、スライドを置くリポジトリへ 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 # 流用したスライドの、見出しと図の対応

検査スクリプトが使うもの:

Marp CLI（npm i -g @marp-team/marp-cli）と Google Chrome
poppler（pdftoppm pdfinfo）と mupdf-tools（mutool）。macOS なら brew install poppler mupdf-tools
Python 3 と Pillow

check-svg-box-fit.mjs は Marp CLI に同梱の puppeteer-core を借ります。場所が違う環境では MARP_NODE_MODULES と CHROME_PATH で指定できます。

フォント

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

挿絵について

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

sh examples/sample/fetch-illustrations.sh

License

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

minorun-marp-skill

中身

使い方

フォント

挿絵について

License

Reviews (0)