marp-slides
CLAUDE.md8 starsChanged 2 months agoMITView on GitHub
Bun と Marp CLI で Markdown スライドを作成・出力する。 AGENTS.md はこのファイルへのシンボリックリンク。共通の指示はここで管理する。 - スライド: slides/*.md。Front Matter に marp: true を指定する。 - 画像: slides/images/ に置き、スライドから ./images/filename.png で参照する。 - カスタムテーマ: themes/*.css。Marp の設定は .marprc.yml。 - ビルド出力: dist/(Git 管理対象外)。 - スライド作成・修正時は .claude/skills/creating-marp-slides/SKILL.md を参照する。 情報量・レイアウトの指針とトラブルシューティングは同ディレクトリの references/ にある。 コマンドはプロジェクトルートで実行する。依存関係の導入は bun install。 スライド変更時は lint に加え、プレビューで画像・見切れ・レイアウトを確認する。 ビルド変更時は対象形式の出力を確認する。実行できなかった検証は報告する。 セットアップや基本操作は README.md を参照する。 Claude Code では、依頼に応じて .claude/agents/ のエージェントを使用する:
In this repository2 other files it gives its agents.
- AGENTS.mdAGENTS.md
- creating-marp-slidesSkill
The file
Files
Marp スライドプロジェクト
Bun と Marp CLI で Markdown スライドを作成・出力する。
AGENTS.md はこのファイルへのシンボリックリンク。共通の指示はここで管理する。
配置と作成ルール
- スライド:
slides/*.md。Front Matter にmarp: trueを指定する。 - 画像:
slides/images/に置き、スライドから./images/filename.pngで参照する。 - カスタムテーマ:
themes/*.css。Marp の設定は.marprc.yml。 - ビルド出力:
dist/(Git 管理対象外)。 - スライド作成・修正時は .claude/skills/creating-marp-slides/SKILL.md を参照する。
情報量・レイアウトの指針とトラブルシューティングは同ディレクトリの
references/にある。
開発と検証
コマンドはプロジェクトルートで実行する。依存関係の導入は bun install。
| コマンド | 用途 |
bun run preview | プレビュー(http://localhost:8080/slides/<name>.md) |
bun run build | HTML + PDF を出力 |
bun run build:html / build:pdf / build:pptx | 指定形式を出力 |
bun run lint | スライドの Markdown と scripts/ の JavaScript を検証 |
bun run lint:js | JavaScript のみ検証 |
スライド変更時は lint に加え、プレビューで画像・見切れ・レイアウトを確認する。 ビルド変更時は対象形式の出力を確認する。実行できなかった検証は報告する。 セットアップや基本操作は README.md を参照する。
Claude Code 用エージェント
Claude Code では、依頼に応じて .claude/agents/ のエージェントを使用する:
slide-creator: 新規スライド作成slide-reviewer: 品質・表示の確認slide-builder: ビルド・エクスポート
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.

