creating-marp-slides
Skill8 starsChanged 2 months agoMITView on GitHub
このリポジトリの Marp スライドを作成・修正・レビューし、HTML/PDF/PPTX に出力する際に使用する。画像配置、対象を絞ったビルド、表示確認を扱う。
The file
Files
Marp スライド作成
Claude Code / Codex 共通の作業ガイド。特定のサブエージェントや MCP ツールを前提にしない。 パスとコマンドは、特記しない限りリポジトリルートを基準とする。
作成・修正
対象ファイルと依頼された内容・出力形式を確認する。既存スライドのテーマや構成を尊重し、 新規作成で指定がなければ次の Front Matter を出発点にする。
---
marp: true
theme: default
paginate: true
---marp: true は必須。テーマとページ番号は用途に合わせて変更する。
- スライドは
slides/*.md、画像はslides/images/、カスタムテーマはthemes/*.css。 - 画像は
./images/filename.pngで参照する。プレビューと HTML 出力で同じ相対配置を保つための規約。 - 組み込みテーマは
default/gaia/uncover。いずれもinvertをサポートする。 - Marp 設定は
.marprc.yml、コマンドの定義はpackage.jsonを正とする。
開発コマンド
依存関係がなければ bun install。以下の scripts は全スライドを対象にする。
| コマンド | 用途 |
bun run preview | http://localhost:8080/slides/<name>.md を表示 |
bun run build | HTML + PDF |
bun run build:html | HTML と dist/images/ への画像コピー |
bun run build:pdf | |
bun run build:pptx | PPTX |
bun run lint | Markdown と JavaScript の lint |
特定ファイルのみの依頼では、インストール済みの CLI で対象を絞る。例:
mkdir -p dist
bun run copy:images
bun run -- marp slides/example.md -o dist/example.html --html --allow-local-files
bun run -- marp slides/example.md -o dist/example.pdf --pdf --allow-local-files
bun run -- marp slides/example.md -o dist/example.pptx --pptx --allow-local-files
bun run -- markdownlint slides/example.md必要な形式だけ実行する。画像コピーは HTML 用。HTML を渡す場合は dist/images/ も含める。
PDF/PPTX の出力には対応ブラウザが必要。通常の PPTX はスライドを画像として格納するため、
編集可能なテキストや図形が必要という依頼なら、この出力で要件を満たすか確認する。
検証
- 変更対象を lint し、要求された形式を生成してファイルの存在を確認する。
- 表示に関わる変更は利用可能なブラウザや画像出力で確認する。レビュー依頼では対象の全スライドを確認する。
- lint / ビルド成功だけで、見切れや画像表示の確認済みとはしない。
- 結果には対象、実行した検証、出力先、未確認の事項を簡潔に記す。
情報量や見切れを調整するときは コンテンツ最適化、 画像・テーマ・変換の問題があるときは トラブルシューティング を読む。
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.

