Agent Skills: Markdown → スライド変換 Skill

|

UncategorizedID: knishioka/machine-learning-workshop/markdown-to-slides

Install this agent skill to your local

pnpm dlx add-skill https://github.com/knishioka/machine-learning-workshop/tree/HEAD/claude-skills/markdown-to-slides

Skill Files

Browse the full folder contents for markdown-to-slides.

Download Skill

Loading file tree…

claude-skills/markdown-to-slides/SKILL.md

Skill Metadata

Name
markdown-to-slides
Description
|

Markdown → スライド変換 Skill

MarkdownドキュメントをPowerPointプレゼンテーションに変換します。

クイックスタート

python scripts/md2slides.py input.md output.pptx

Markdown記法

スライド区切り

| 記法 | 動作 | |------|------| | # 見出し1 | タイトルスライドを作成 | | ## 見出し2 | 新しいコンテンツスライドを作成 | | --- | 強制的にスライドを分割 |

サポートする要素

  • 太字斜体 テキスト
  • 箇条書きリスト(2階層までネスト可)
  • 番号付きリスト
  • コードブロック(等幅フォントで表示)
  • 画像 ![alt](path) (ローカルパスのみ)

ワークフロー

  1. ソースMarkdownを読み込む - Readツールでコンテンツ取得
  2. PPTXに変換 - 変換スクリプトを実行
  3. 出力を確認 - 生成ファイルの存在確認

スクリプトインターフェース

入力

python scripts/md2slides.py <input.md> [output.pptx] [--title "タイトル"]

出力

  • 成功: 出力パスを stdout に表示、終了コード 0
  • 失敗: エラーを stderr に表示、終了コード 1

オプション

  • --title: プレゼンテーションタイトルを上書き(デフォルト: 最初のH1またはファイル名)
  • --theme: カラーテーマ(default, dark, corporate)
  • --aspect: アスペクト比(16:9, 4:3)デフォルト: 16:9

エラーハンドリング

| エラー | 原因 | 対処 | |--------|------|------| | 入力ファイルが見つからない | パスが間違っている | パスを確認 | | 無効なMarkdown | 構文エラー | 該当箇所をスキップして警告 | | 画像が見つからない | パスが間違っている | プレースホルダーを表示 |

使用例

基本的な使い方

python scripts/md2slides.py presentation.md slides.pptx

オプション指定

python scripts/md2slides.py notes.md output.pptx --title "Q4レビュー" --theme corporate

テスト実行

cd /path/to/markdown-to-slides
pytest tests/ -v

依存関係

  • python-pptx(Claude API環境ではプリインストール済み)
  • 標準ライブラリのみ(パース処理)

ファイル構成

markdown-to-slides/
├── SKILL.md           # このファイル
├── scripts/
│   ├── md2slides.py   # CLIエントリポイント
│   ├── parser.py      # Markdownパース
│   └── generator.py   # PPTX生成
├── tests/
│   └── test_md2slides.py
└── resources/
    └── example.md     # サンプル入力
Markdown → スライド変換 Skill Skill | Agent Skills