minorun-marp-skill
Marpで登壇スライドを作るための、ストーリー・図・デザインバランスのスキル集と黒地テーマ、検査ツール
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/minorun365/minorun-marp-skill with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/minorun365/minorun-marp-skill'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/minorun365--minorun-marp-skill)HTML
<a href="/listings/minorun365--minorun-marp-skill"><img src="/api/listings/minorun365--minorun-marp-skill/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 79 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # minorun-marp-skill
- 登壇スライドを Marp で作るときの、ストーリー・図・デザインバランスの型をまとめたものです。AIエージェント(Claude Code など)に読ませるスキルの形にしてあり、人が読んでもそのまま使えます。
- AIにスライドを書かせると、体裁は整うのに話が薄くなりがちです。作者([@minorun365](https://x.com/minorun365))が自分の登壇資料を作るなかで、エージェントへ繰り返し伝えてきた直し方を、規則と検査スクリプトに落としました。
- <picture>
- <source media="(max-width: 767px)" srcset="examples/sample/preview-sp.png">
- <img src="examples/sample/preview.png" alt="見本デッキ">
- </picture>
- ## 中身
- | 場所 | 内容 |
- |---|---|
- | `skills/slide-story` | つかみ、中扉、段階的な開示、見出しの文体、締め方、尺の見積り |
- | `skills/slide-figures` | 図の情報量の絞り方、SVGの描き方、文字サイズの下限、挿絵の置き方 |
- | `skills/slide-design-dark` | 余白の測り方、縦のバランス、黒地の配色、表とコードのデザイン、Marpの罠 |
- | `theme/minorun-dark.css` | 黒地にシアンの Marp テーマ |
- | `tools/` | 書き出したPDFとSVGを実測する検査スクリプト |
- | `examples/sample` | 見本デッキ。図は `images/build-figs.py` で部品から描く。README の一覧画像は `build-preview.py` で作る。`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](https://github.com/marp-team/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`・`check-svg-spacing.mjs`・`check-svg-contrast.mjs` は Marp CLI 同梱の puppeteer-core を借りるので、場所が違う環境では `MARP_NODE_MODULES` と `CHROME_PATH` で指定する
- 4. 結果は、何が使えるようになったかと頼み方の例を、コマンドを見せずに平易な言葉で伝える
- スライドを作るときは、`~/.claude/skill-repos/minorun-marp-skill` から `theme/` と `tools/` を作業フォルダへコピーして使う。
- ```bash
- 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 # 図の中の小さい文字、箱の縁に詰まった文字
- python3 tools/check-line-breaks.py deck.pdf # 改行のしすぎと、読点の後ろの切れ端
- python3 tools/check-bubble-tails.py deck.md # 吹き出しのしっぽの継ぎ目に線が出る書き方
- node tools/check-svg-box-fit.mjs images/*.svg # SVGの文字が箱に収まっているか
- node tools/check-svg-spacing.mjs images/*.svg # SVGの箱や行、線と文字の間隔が詰まっていないか
- node tools/check-svg-contrast.mjs images/*.svg # SVGの図形が下の面と同じ色で沈んでいないか
- python3 tools/check-reuse-diff.py new.md old.md # 流用したスライドの、見出しと図の対応
- python3 tools/check-ai-smell.py deck.md # 書き換えたスライドの文の型の反復
- ```
- 検査を通したら、最後に PDF のページ寸法を2倍へ置き換える。Speaker Deck の変換で、スクリーンショットや写真だけが文字より粗くなるのを和らげる。置き換える前に元と変換後の全ページを画像で見比べ、見た目が変わったページがあれば置き換えずに止まる。検査は置き換え前の寸法を前提にしているので、置き換えた PDF を渡すと止まる。
- ```bash
- uv run tools/pdf-for-speakerdeck.py deck.pdf
- ```
- ## フォント
- テーマは丸ゴシック系を想定しています。第一候補の Zen Maru Gothic を入れておくと揃い、未導入の macOS ではヒラギノ丸ゴで表示されます。作者の手元では有償の丸ゴシック書体を使っているので、公開されている登壇資料とは字形が少し違います。
- ## 挿絵について
- 作者のスライドには「いらすとや」の挿絵がよく登場します。画像はこのリポジトリに同梱していないので、見本デッキを書き出す前に取得してください。利用条件は各自で確かめてください。
- ```bash
- sh examples/sample/fetch-illustrations.sh
- ```
- ## License
- Apache License 2.0. Copyright 2026 Minoru Onda
- 見本デッキの一覧画像に写っている挿絵は「いらすとや」の著作物で、このライセンスの対象外です。
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.