pptx-converter

name	pptx-converter
description	PPTXテンプレート変換 & ゼロからデッキ生成。テーマ・アニメーション・SmartArtを保持してコンテンツを書き換え。 「PPTX変換」「スライド作成」「パワポ書き換え」「デッキ生成」等のリクエストで発動。
triggers	["PPTX変換","スライド作成","パワポ書き換え","デッキ生成","pptx-converter","PowerPoint変換","テンプレートを使ってスライド作成"]
version	1.0.0
author	CursorBootcamp
dependencies	[{"python":"3.8+"},{"packages":["python-pptx","pyyaml","lxml","google-generativeai","python-dotenv","Pillow"]}]

トリガーワード

「PPTX変換」「スライド作成」「パワポ書き換え」「デッキ生成」「PowerPoint」

PPTX Converter

PowerPointファイルのテンプレート変換とゼロからのデッキ生成ツール。

機能

1. convert - テンプレート変換（1コマンド完結）

元PPTXをコピーして、全要素をGeminiで意味解析し、新トピックに合わせてコンテンツを自動書き換え。

python skills/pptx-converter/scripts/pptx_converter.py convert \
    source.pptx \
    --topic "2026年Q1営業報告" \
    -o output/slides/q1_report.pptx

保持されるもの: スライドマスター、テーマカラー、フォント定義、アニメーション、トランジション、SmartArt構造、レイアウト配置

2. extract - マッピングYAML生成

元PPTXの全要素を抽出・意味解析し、座標-要素マッピングYAMLを生成。手動確認・編集用。

python skills/pptx-converter/scripts/pptx_converter.py extract \
    source.pptx \
    -o mapping.yaml

3. build - マッピング + データ → PPTX

手動編集したデータYAMLで要素を書き換え。

python skills/pptx-converter/scripts/pptx_converter.py build \
    source.pptx \
    mapping.yaml \
    --data data.yaml \
    -o output.pptx

4. deck - ゼロからデッキ生成

トピックからGeminiでアウトライン生成 → PPTX自動作成。

python skills/pptx-converter/scripts/pptx_converter.py deck \
    --topic "AIエージェント活用提案" \
    --type proposal \
    --style corporate \
    -o output/slides/proposal.pptx

deck オプション:

• --type: auto / presentation / proposal / report / educational / pitch
• --style: corporate / creative / minimal / academic
• --slides N: スライド枚数（0=AI決定）
• --audience: 対象者
• --outline-only: アウトラインYAMLのみ出力

対応要素タイプ

タイプ	抽出	書き換え	備考
テキスト	o	o	スタイル（フォント・色・太字等）完全保持
チャート	o	o	chart.replace_data() でデータのみ差し替え
テーブル	o	o	セルスタイル保持、行列内容のみ差し替え
画像	o	o	デフォルト保持、個別に差し替え指定可能
図形	o	o	図形内テキストの差し替え
グループ	o	o	子要素を再帰的に処理（深さ3まで）
SmartArt	o	部分	テキストノードのみXML直接操作で差し替え

マッピングYAML構造

source: "source.pptx"
generated_at: "2026-02-09T15:30:00"
slide_width: 12192000
slide_height: 6858000

slides:
  - slide_number: 1
    layout: "Title Slide"
    elements:
      - id: 2
        name: "Title 1"
        type: text
        role: title
        hint: "メインタイトル。15-25文字。"
        position: { left: 457200, top: 274638, width: 8229600, height: 1143000 }
        style: { font: "Meiryo UI", size: 36, bold: true, color: "2563EB" }
        value: "2025年度 営業戦略"
        placeholder: "{{slide_1_title}}"

placeholders:
  - key: "{{slide_1_title}}"
    type: text
     
     

ワークフロー判断

• テンプレートPPTXがある → convert（1コマンド完結）
• マッピングを手動確認したい → extract → YAML編集 → build
• ゼロから作成 → deck

環境変数

• GEMINI_API_KEY or GOOGLE_API_KEY: Gemini API キー（必須）
• GEMINI_FLASH_MODEL: テキスト処理モデル（デフォルト: gemini-2.5-flash）