← Back
minorun365

minorun365/minorun-marp-skill

Marpで登壇スライドを作るための、ストーリー・図・デザインバランスのスキル集と黒地テーマ、検査ツール

View on GitHub ↗
agent-skillsclaude-codemarppresentation
Stars
398
Forks
14
Watchers
398
Open issues
0
Contributors
1
Language
Python
License
Apache License 2.0
Default branch
main
Created Sep 20, 2026Updated Sep 28, 2026

Star growth

Today—
This week—
This month—

Star history will appear here once this repo has been tracked for a couple of days.

README

minorun-marp-skill

登壇スライドを 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」タブ（または Claude Code）で、このURLを渡して頼むだけです。

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

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

インストールを頼まれた Claude へ

この節は 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

License

Apache License 2.0. Copyright 2026 Minoru Onda

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