marp-check
Skill1 starsChanged 4 months agoMITView on GitHub
Marpスライドの視覚検証ワークフロー。スライドをPNG画像に書き出して1枚ずつ目視チェックする。「スライドを確認して」「レイアウト崩れがないか見て」「検証して」、またはmarp-deckスキルでスライドを作成・編集した後の最終確認で必ず使う。
In this repository5 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- marp-deckSkill
- marp-shotsSkill
- marp-themeSkill
The file
Files
スライド視覚検証ワークフロー
スライドのMarkdown/CSSを編集しただけでは崩れに気づけない。必ず画像に書き出して1枚ずつ確認する。
手順
- PNG書き出し:
npm run build -- slides/<deck> pngslides/<deck>/png/slide.001.png形式で全スライドが出力される
- 全スライドをReadツールで開いて目視確認する。チェック項目:
- テキストがカードやスライド端からあふれていない(オーバーフロー)
- 画像が枠内に収まり、極端に小さく/大きくなっていない
- 見出しの改行位置が不自然でない
- アクセント色が1スライド1〜2箇所に収まっている
- 空白が偏っていない(下半分がスカスカ等)
- 誤字・全角半角の混在がない
- 問題があれば修正して 1. に戻る。テキスト量を減らす・スライドを分割するのが第一選択。CSSいじりは最終手段
- 全スライドがパスしたら成果物をビルド:
npm run build -- slides/<deck>およびnpm run build -- slides/<deck> pdf - 検証用の
png/ディレクトリは .gitignore 済みなので残してよい
注意
- PNG/PDF出力にはChrome/Chromiumが必要(marp-cliがローカルのブラウザを使う)
- 確認結果は「スライドN: 問題なし / 問題あり(内容)」の形で報告する
HTML/PNGとPDFの描画差
PDFだけはChromeの印刷経路で描画されるため、HTML・PNG(画面メディア)と結果が一致しないことがある。制約の詳細は .steering/marp-constraints.md を参照。新しく影・フィルタ・半透明の装飾をテーマに足したら、PDFでも必ず確認する。
PDF単体の見え方は次の方法で確認できる(sipsは1ページ目のみ変換)。
npm run build -- slides/<deck> pdf
sips -s format png slides/<deck>/slides.pdf --out /tmp/page1.png特定ページを見たいときは、そのスライドだけの一時デッキを slides/ 配下に作ってPDF化するのが早い(slides/ の外だとビルドが通らないことがある)。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

