baoyu-slide-deck

スライドデッキ生成ツール

コンテンツを、柔軟なスタイルオプションでプロフェッショナルなスライドデッキ画像に変換します。

使用方法

/baoyu-slide-deck path/to/content.md
/baoyu-slide-deck path/to/content.md --style sketch-notes
/baoyu-slide-deck path/to/content.md --audience executives
/baoyu-slide-deck path/to/content.md --lang zh
/baoyu-slide-deck path/to/content.md --slides 10
/baoyu-slide-deck path/to/content.md --outline-only
/baoyu-slide-deck  # Then paste content

スクリプトディレクトリ

重要：すべてのスクリプトは、このスキルの scripts/ サブディレクトリにあります。

エージェントの実行手順：

1. この SKILL.md ファイルのディレクトリパスを SKILL_DIR として特定します
2. スクリプトのパス = ${SKILL_DIR}/scripts/<script-name>.ts
3. このドキュメント内のすべての ${SKILL_DIR} を実際のパスに置き換えます

スクリプトの参照：

スクリプト	用途
scripts/merge-to-pptx.ts	スライドを PowerPoint に統合
scripts/merge-to-pdf.ts	スライドを PDF に統合

オプション

オプション	説明
--style <name>	ビジュアルスタイル（スタイルギャラリーを参照）
--audience <type>	対象者：初心者、中級者、エキスパート、経営幹部、一般
--lang <code>	出力言語（en、zh、ja など）
--slides <number>	スライドの目標枚数
--outline-only	アウトラインのみを生成し、画像の生成をスキップ

スタイルギャラリー

スタイル	説明	最適な用途
blueprint（デフォルト）	技術的な設計図、グリッドテクスチャ	アーキテクチャ、システム設計
chalkboard	黒板、カラフルなチョーク	教育、チュートリアル、教室
notion	SaaS ダッシュボード、カードベースのレイアウト	製品デモ、SaaS、B2B
bold-editorial	雑誌の表紙、大胆なタイポグラフィ、ダーク	製品発表、基調講演
corporate	ネイビー／ゴールド、構成的なレイアウト	投資家向け資料、提案書
dark-atmospheric	映画のようなダークモード、光るアクセント	エンターテインメント、ゲーム
editorial-infographic	雑誌風の解説、フラットなイラスト	技術解説、研究
fantasy-animation	ジブリ／ディズニー風、手描き	教育、ストーリーテリング
intuition-machine	技術ブリーフィング、バイリンガルのラベル	技術文書、学術
minimal	極めてすっきりとしたデザイン、最大限の余白	経営幹部向けブリーフィング、高級感のある資料
pixel-art	レトロな8ビット、粗めのピクセル	ゲーム、開発者向け講演
scientific	学術的な図、精密なラベル	生物学、化学、医療
sketch-notes	手描き、温かく親しみやすい雰囲気	教育、チュートリアル
vector-illustration	フラットなベクター、レトロでかわいいデザイン	クリエイティブ、子ども向けコンテンツ
vintage	古びた紙、歴史を感じさせるスタイル	歴史、伝統、伝記
watercolor	手描きの質感、自然な温かみ	ライフスタイル、ウェルネス、旅行

スタイルの自動選択

コンテンツの特徴	選択されるスタイル
tutorial, learn, education, guide, intro, beginner	sketch-notes
classroom, teaching, school, chalkboard, blackboard	chalkboard
architecture, system, data, analysis, technical	blueprint
creative, children, kids, cute, illustration	vector-illustration
briefing, academic, research, bilingual, infographic, concept	intuition-machine
executive, minimal, clean, simple, elegant	minimal
saas, product, dashboard, metrics, productivity	notion
investor, quarterly, business, corporate, proposal	corporate
launch, marketing, keynote, bold, impact, magazine	bold-editorial
entertainment, music, gaming, creative, atmospheric	dark-atmospheric
explainer, journalism, science communication	editorial-infographic
story, fantasy, animation, magical, whimsical	fantasy-animation
gaming, retro, pixel, developer, nostalgia	pixel-art
biology, chemistry, medical, pathway, scientific	scientific
history, heritage, vintage, expedition, historical	vintage
lifestyle, wellness, travel, artistic, natural	watercolor
デフォルト	blueprint

設計方針

このデッキは、ライブプレゼンテーションではなく、閲覧と共有を目的として設計されています。

• 各スライドは、口頭での説明がなくても内容が理解できる必要があります
• スクロールしたときに論理的な流れになるようコンテンツを構成します
• 各スライドに必要なコンテキストをすべて含めます
• ソーシャルメディアでの共有とオフラインでの閲覧に最適化します

ファイル管理

出力ディレクトリ

各セッションでは、コンテンツのスラッグを名前にした独立したディレクトリを作成します。

slide-deck/{topic-slug}/
├── source-{slug}.{ext}    # Source files (text, images, etc.)
├── outline.md
├── outline-{style}.md     # Style variant outlines
├── prompts/
│   └── 01-slide-cover.md, 02-slide-{slug}.md, ...
├── 01-slide-cover.png, 02-slide-{slug}.png, ...
├── {topic-slug}.pptx
└── {topic-slug}.pdf

スラッグの生成：

1. コンテンツから主なトピックを抽出します（2〜4語、ケバブケース）
2. 例：「Introduction to Machine Learning」→ intro-machine-learning

競合の解決

slide-deck/{topic-slug}/ がすでに存在する場合：

• タイムスタンプを追加します：{topic-slug}-YYYYMMDD-HHMMSS
• 例：intro-ml が存在する場合 → intro-ml-20260118-143052

ソースファイル

すべてのソースを source-{slug}.{ext} という名前でコピーします：

• source-article.md（メインテキストのコンテンツ）
• source-diagram.png（会話で共有された画像）
• source-data.xlsx（追加ファイル）

複数のソースに対応しています：会話内のテキスト、画像、ファイル。

ワークフロー

ステップ 1：コンテンツを分析する

1. ソースコンテンツを保存します（貼り付けられた場合は source.md として保存）
2. 詳細なコンテンツ分析には references/analysis-framework.md に従います
3. スタイルを決定します（--style を使用するか、シグナルに基づいて自動選択）
4. 言語を検出します（ソースとユーザーの希望）
5. スライド数を計画します（--slides または動的に設定）

ステップ 2：アウトラインのバリエーションを生成する

1. コンテンツ分析に基づいて、スタイルの異なるアウトラインを3つ生成します
2. 構成には references/outline-template.md に従います
3. 各バリエーションを outline-{style}.md として保存します

ステップ 3：ユーザーによる確認

該当するすべての選択肢を含めて、AskUserQuestion を1回だけ実行します。

質問	尋ねるタイミング
スタイルのバリエーション	常に（3つの選択肢＋カスタム）
言語	ソースの言語 ≠ ユーザーの言語の場合のみ

選択後：

• 選択した outline-{style}.md を outline.md にコピーします
• 別の言語がリクエストされた場合は、再生成します
• ユーザーは微調整のために outline.md を編集できます

--outline-only が指定されている場合は、ここで停止します。

ステップ 4：プロンプトを生成する

1. references/base-prompt.md を読み込みます
2. アウトラインに記載されたスタイルの指示と組み合わせます
3. スライド固有のコンテンツを追加します
4. prompts/ ディレクトリに保存します

ステップ 5：画像を生成する

1. 利用可能な画像生成スキルを選択します
2. セッション ID を生成します：slides-{topic-slug}-{timestamp}
3. 同じセッション ID を使って各スライドを生成します
4. 進捗を報告します：「X/N 枚を生成しました」

ステップ 6：PPTX と PDF に統合する

npx -y bun ${SKILL_DIR}/scripts/merge-to-pptx.ts <slide-deck-dir>
npx -y bun ${SKILL_DIR}/scripts/merge-to-pdf.ts <slide-deck-dir>

ステップ 7：出力の概要

Slide Deck Complete!

Topic: [topic]
Style: [style name]
Location: [directory path]
Slides: N total

- 01-slide-cover.png ✓ Cover
- 02-slide-intro.png ✓ Content
- ...
- {NN}-slide-back-cover.png ✓ Back Cover

Outline: outline.md
PPTX: {topic-slug}.pptx
PDF: {topic-slug}.pdf

スライドの変更

以下については、references/modification-guide.md を参照してください。

• 1枚のスライドを編集するワークフロー
• 新しいスライドの追加（番号の振り直しを含む）
• スライドの削除（番号の振り直しを含む）
• ファイルの命名規則

参考資料

ファイル	内容
references/analysis-framework.md	プレゼンテーション用の詳細なコンテンツ分析
references/outline-template.md	アウトラインの構成と STYLE_INSTRUCTIONS の形式
references/modification-guide.md	スライドの編集、追加、削除のワークフロー
references/content-rules.md	コンテンツとスタイルのガイドライン
references/base-prompt.md	画像生成用のベースプロンプト
references/styles/<style>.md	スタイルの詳細な仕様

メモ

• 画像の生成：スライド1枚あたり10〜30秒
• 生成に失敗した場合は1回自動で再試行します
• 公人を扱う場合は、様式化した代替表現を使用します
• セッション ID を使用してスタイルの一貫性を保ちます

拡張機能のサポート

EXTEND.md を使用して、カスタムスタイルや設定を追加できます。

パスを確認（優先順位順）：

1. .baoyu-skills/baoyu-slide-deck/EXTEND.md（プロジェクト）
2. ~/.baoyu-skills/baoyu-slide-deck/EXTEND.md（ユーザー）

見つかった場合は、ステップ 1 の前に読み込みます。拡張コンテンツはデフォルト設定より優先されます。