Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
115 changes: 115 additions & 0 deletions .claude/skills/marp-creator/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,115 @@
---
name: marp-creator
description: Marpでスライド資料を作成するスキル。メモの整理、スライド設計、Marpファイル生成の3ステップで資料を作成する。提案書や勉強会資料の作成時に使用する。
---

# Marp Creator

Marpで提案書や勉強会資料を作成する。内容整理とスライド化を分離し、段階的に進めることで質の高い資料を作成する。

## ワークフロー

3つのステップで資料を作成する。

```
メモ・要件(任意の形式・ファイル名)
[ステップ1] 内容整理 → 01_organized_*.md
[ステップ2] スライド設計 → 02_slide-design_*.md
[ステップ3] Marp資料作成 → 03_marp_*.md(最終成果物)
```

Comment on lines +10 to +23
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

一度使ってみたところステップ1から3まで勝手に進んでしまいました。
そのためワークフローを人間のチェックを確実に入れるように修正した方がいいと思いました。
他にも少しだけ注意書きを増やしたほうがいいかもしれません。

メモ・要件(任意の形式・ファイル名)
    ↓
[ステップ1] 内容整理 → 01_organized_*.md
    ↓
※ ユーザー確認(内容の過不足、構成の修正)
    ↓
[ステップ2] スライド設計 → 02_slide-design_*.md
    ↓
※ ユーザー確認(スライド構成、レイアウト、枚数)
    ↓
[ステップ3] Marp資料作成 → 03_marp_*.md(最終成果物)

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@yoshida-takeshi-classmethod
自分がテストした際は、一つずつ確認しながら実行してくれたんですけどね。。。
ちょっと実際の挙動を確認させてください。

## 開始ステップの判断

入力ファイルの種類に応じて、開始するステップを自動判断する。

| 入力ファイル | 開始ステップ |
|-------------|-------------|
| メモ・要件(接頭辞なし) | ステップ1から開始 |
| `01_organized_*.md` | ステップ2から開始 |
| `02_slide-design_*.md` | ステップ3から開始 |

各ステップは1つずつ実行し、出力後に次のステップへ進むか確認する。途中から再開する場合は、該当する接頭辞のファイルを入力として渡す。

## ステップ1: 内容整理

メモや箇条書きを構造化されたMarkdownに整理する。Marpの記法やスライド枚数は意識せず、伝えたい内容の構造化に集中する。

**入力:** メモファイル、資料の目的、対象者
**出力:** `01_organized_[資料名].md`

詳細な手順は [organize-content.md](organize-content.md) を参照。

## ステップ2: スライド設計

整理した内容をスライドに分割し、各スライドの構成を定義する。レイアウトや情報量を調整する中間成果物を作成する。

**入力:** `01_organized_[資料名].md`、発表時間(任意)
**出力:** `02_slide-design_[資料名].md`

**発表時間とスライド枚数の目安:**
- 5分: 5〜8枚
- 10分: 10〜15枚
- 15分: 15〜20枚
- 30分: 20〜30枚

詳細な手順は [slide-design.md](slide-design.md) を参照。

## ステップ3: Marp資料作成

スライド設計書に基づき、Marp形式の最終資料を生成する。

**入力:** `02_slide-design_[資料名].md`
**出力:** `03_marp_[資料名].md`(最終成果物)

詳細な手順は [build-marp.md](build-marp.md) を参照。

## レイアウトクラス一覧

| レイアウトクラス | 用途 |
|-----------------|------|
| title | 表紙 |
| section | セクション区切り |
| (指定なし)基本 | テキスト中心、箇条書きが主体 |
| image | 図表のみを大きく表示 |
| content-image | 図表とキャプション |
| content-image-right | 文章と図表を横並び(図が右) |
| content-image-left | 文章と図表を横並び(図が左) |
| column-layout | 複数項目を横並び |
| small-text | 情報量が多い場合の文字縮小 |

テンプレートとサンプルの取得方法は [get-sample-slide.md](get-sample-slide.md) を参照。

## ファイル命名規則

| 接頭辞 | 説明 |
|--------|------|
| 01_organized_ | ステップ1の出力(整理済み) |
| 02_slide-design_ | ステップ2の出力(設計書) |
| 03_marp_ | ステップ3の出力(最終成果物) |

## 反復的な改善

初回作成後、以下のサイクルで品質を高める。

1. スライド設計書を確認し、構成の過不足をチェック
2. 必要に応じて整理済みmdを修正
3. 再度スライド設計書を生成
4. 問題なければMarp資料を生成

## トラブルシューティング

**スライド枚数が多すぎる:**
- 内容を絞り込む(整理済みmdを修正)
- 複数のスライドを統合する(設計書で調整)

**情報が1スライドに収まらない:**
- スライドを分割する
- 箇条書きを簡潔にする
- small-textレイアウトを検討(最終手段)

**レイアウトが思い通りにならない:**
- 最新のサンプルスライドを取得して確認([get-sample-slide.md](get-sample-slide.md))
- `_class` のコメント記法が正しいか確認
Loading