agentleFS
toku345toku345/marp-slides/CLAUDE.md

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/ のエージェントを使用する:

The file

Files
CLAUDE.md

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 buildHTML + PDF を出力
bun run build:html / build:pdf / build:pptx指定形式を出力
bun run lintスライドの Markdown と scripts/ の JavaScript を検証
bun run lint:jsJavaScript のみ検証

スライド変更時は lint に加え、プレビューで画像・見切れ・レイアウトを確認する。 ビルド変更時は対象形式の出力を確認する。実行できなかった検証は報告する。 セットアップや基本操作は README.md を参照する。

Claude Code 用エージェント

Claude Code では、依頼に応じて .claude/agents/ のエージェントを使用する:

  • slide-creator: 新規スライド作成
  • slide-reviewer: 品質・表示の確認
  • slide-builder: ビルド・エクスポート

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.