LearnPrompt/humanize-ppt

Humanize PPT – AI駆動の「話せる」スライドデッキ

何であるか – Humanize PPT は、原始的な資料（Markdown、メモ、データ）を プレゼンテーション用 のスライドデッキに変換する、小さな Python ベースのオーケストレーションレイヤーです。視覚的デザイン自体をレンダリングするものではありません。代わりに、物語の流れ（「AST」：Audience-State-Transferアウトライン）を決定し、どのスライドに画像、SVGチャート、または短い動画が必要かを判断し、その決定を下流のレンダリングスキル（HTMLスライドジェネレータ、ネイティブPowerPointエクスポート、Remotion動画プロデューサーなど）に引き渡します。レンダリング後、自動的な プレゼンテーションチェック を実行し、「見栄えは良いが話せない」スライド（例：バッジにテキストが隠れている、スピーカーノートが欠落している）を検出し、レンダラーに修正を指示するプロンプトを生成します。

コアコンセプト

コンセプト	Humanize PPT の役割
ASTアウトライン	ソース資料を解析し、各スライドについて、観客の初期状態、スライド後の意図された状態、およびスライドの目的を記録した JSON プラン（`slide_plan.json`）を生成します。
ビジュアル強化	各スライドに対して、画像、決定論的SVGチャート、またはRemotion動画が必要かどうかを判断し、そのリクエスト（プロンプトヒント + ターゲットパス）をプランに記録します。実際のアセットは `baoyu-image-gen`（ローカルCodex CLI）や `remotion-video-production` などのプラグインスキルによって生成されます。
スタイルギャラリー	アウトラインが確定する前に、レンダラーにカバーページ候補（4つ以上）を生成させ、ユーザーがデッキ全体をコミットせずに視覚スタイルを選択できます。
プレゼンテーションチェックアップ	下流レンダラーが完了後、Humanize PPT は出力結果をスキャンし、ASTプランと比較して「失敗した」スライド（例：テキストオーバーフロー、バッジがテキストを覆う、スピーカーノートが欠落）を自動的に報告します。`fix_prompt.md` を出力し、レンダラーに2回目の実行を依頼するためのプロンプトを提供します（最大3回のイテレーション）。
プレゼンテーションモード	軽量なHTMLプレゼンター（`presenter-shell.html`）を生成し、現在のスライド、タイマー、スピーカーノート、次のスライドのプレビュー、スライドマップを表示します。これにより、最終的なデッキがレンダリングされる前でもリハーサルが可能です。

AIエージェントワークフローへの統合方法

スキルとしてインストール – Claude‑Code、Codex、Hermesなどのエージェントは、1行でスキルを追加できます（npx skills add LearnPrompt/humanize-ppt）。
エージェントにプロンプト – 「Humanize PPT を使ってこのMarkdownを中国語のPPTに変換し、guizang-ppt-skill でネイティブレンダリング、画像は baoyu-image-gen、動画はRemotionで作成してください。」
Humanize PPTが実行 – ASTプランを作成し、guizang-production-prompt.md、ppt-master-production-prompt.md などの簡潔なプロンプトを生成して、選択されたレンダラーに渡します。
レンダラーがデッキを生成 – HTMLスライドセット、ネイティブ.pptx、またはMP4動画のセットが生成されます。
自動QA – Humanize PPT はレンダリングされたファイルを読み取り、3ラウンドのチェックアップを実行し、簡潔なレポート（qa_report.md）と修正プロンプトを返します。
イテレーションまたはプレゼン – 修正プロンプトをレンダラーに再投入するか、プレゼンター・シェルに直接移行してリハーサルを開始します。

主要コンポーネント（リポジトリに記載）

scripts/humanize_ppt.py – CLIエントリポイント。ソースMarkdown、出力フォルダ、タイトル、レンダラー選択、スタイルフラグなどを受け取ります。
slide_plan.json – 機械可読のプラン。すべてのスライド、そのAST状態、メディアスロット、スタイル選択をリストアップします。
presenter-shell.html – 任意のレンダリングデッキと連携可能な最小限のHTMLプレゼンター。スライド、タイマー、スピーカーノート、ナビゲーションを表示します。
qa_report.md / fix_prompt.md – 人間が読める診断情報と、下流レンダラーに問題を修正させるための正確なプロンプト。

下流スキルのエコシステム（フルパイプラインに必要なものとしてリスト）

スキル	レンダリング内容	リポジトリ
`guizang-ppt-skill`	中国語ネイティブPPT（マガジン／スイススタイル）	https://github.com/op7418/guizang-ppt-skill
`frontend-slides`	英語HTMLスライドデッキ（ビューポート対応）	https://github.com/zarazhangrui/frontend-slides
`beautiful-html-templates`	英語マルチテンプレートHTMLデッキ	https://github.com/zarazhangrui/beautiful-html-templates
`ppt-master`	編集可能な完全な`.pptx`（DrawingML、ノート、トランジション）	https://github.com/hugohe3/ppt-master
`remotion-video-production`	スライドごとの説明用MP4動画	(Remotionエコシステム)
`baoyu-image-gen`	ローカルCodex‑CLIによる画像生成（APIキー不要）	https://github.com/JimLiu/baoyu-skills/tree/main/skills/baoyu-image-gen

クイックスタート例（READMEから）

# エージェント用にスキルをインストール
npx skills add LearnPrompt/humanize-ppt -g

# エージェントに1つのプロンプトで全パイプラインを実行
"用 humanize-ppt 把这份材料做成中文演讲 PPT：先出 AST 大纲和每页意图，
按大纲调 guizang-ppt-skill 原生渲染，配图用 baoyu-image-gen、视频用 remotion，
渲染完跑一遍演讲体检告诉我哪几页只能看不能讲，最后出演讲模式。"

エージェントは以下の通りに動作します：

humanize_ppt.py を呼び出し → guizang-production-prompt.md を生成。
guizang-ppt-skill を実行 → 美しいHTML/PPTXデッキを取得。
baoyu-image-gen とRemotionでメディアアセットを生成。
HumanizeのQAステップを実行 → 問題スライドのリストを受信。
必要に応じて、生成された修正プロンプトでレンダラーを再実行。
presenter-shell.html を開いてリハーサルを開始。

あなたが得るもの

AST駆動のスライドプラン（slide_plan.json）。
レンダラー固有の簡潔なプロンプト（*-production-prompt.md）。
オプションのスタイルギャラリーHTML（カバースタイルの選択用）。
メディアアセット（実際の画像、SVGチャート、MP4動画）を指定されたパスに配置。
QAレポート（qa_report.md）：「見せるだけ」で話せないスライドを特定。
編集可能なネイティブPPTX（ppt-masterを使用時）または、プレゼン用に準備されたHTMLデッキ。
即時リハーサル用のプレゼンター・シェル。

ライセンス

MIT – 使用、変更、他のAIエージェントツールチェーンへの統合を自由に可能です。

まとめ

Humanize PPT は視覚テンプレートライブラリではありません。それは、AI生成スライドデッキを 話せる ものにする ストーリーオーケストレーションレイヤー です。コンテンツ計画（AST） と ビジュアルレンダリング を分離し、自動「プレゼンテーション健全性チェック」を提供することで、LLM駆動エージェントが、見た目も良く、ライブプレゼンに適したデッキを生成できるようにします。