mcpField
P
pptx-profile

pptx-profile

github.com/tristan-mcinnisドキュメント4088 回インストール8 週間前に更新
リポジトリ

pptx-profile について

pptx-profile は、PowerPoint テンプレートのレイアウトを整理し、スライド作成やレンダリングの工程で使えるようにします。人が読めるレイアウトカタログと、後続工程でレイアウトを指定するための設定ファイルを出力します。

主な機能

  1. 01指定可能なレイアウトと全レイアウトの一覧化
  2. 02プレースホルダーと用途の表示
  3. 03JSON レイアウト設定の生成
  4. 04カタログのみの出力
  5. 05複数のプレゼンテーションでプロファイルを再利用

活用シーン

  1. 01スライド作成前のテンプレート確認
  2. 02各スライドのレイアウトヒント選定
  3. 03デッキのレンダリング設定の準備

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/tristan-mcinnis/pptx-from-layouts-skill --skill pptx-profile

インストール後、Claude Code で/pptx-profileを入力して読み込まれたか確認します。

同梱ファイルscripts/catalog.py

詳細

ステップ 1 — プロファイル（pptx-profile）

任意の .pptx を、実際のレイアウトを把握するためのマップに変換します。これにより、次のステップでレイアウトを正確に指定できます。これは、「テンプレートには実際にどんなレイアウトがあり、それぞれ何に使うのか？」という問いへの答えです。

  STEP 1 — PROFILE          STEP 2 — AUTHOR           STEP 3 — RENDER
  pptx-profile              pptx-author               pptx-from-layouts
  ───────────────           ───────────────           ─────────────────
  your-template.pptx        slides.md (+ [HINT:])     slides.md + config
        │                         │                         │
        ▼                         ▼                         ▼
   catalog.py  ──catalog.md──▶  write & lint  ──slides──▶  generate.py ─▶ deck.pptx
        └────────────────── config.json ───────────────────▲   (validated)
  "what layouts do I        "write slides that        "fill the template's
   have?"                    name real layouts"        actual placeholders"

現在のステップ：ステップ 1。 出力はステップ 2 と 3 で使用します。

依存関係

Python 3.10+ と python-pptx（pip install python-pptx）が必要です。設定ステップでは、同じリポジトリにある pptx-from-layouts スキルをシェルから実行します。

実行方法

python scripts/catalog.py /path/to/your-template.pptx \
    --name your-template --output-dir ./build

次の 2 つのファイルが ./build に出力されます。

ファイル対象用途
your-template-layout-catalog.mdあなた／ステップ 2 の作成者ヒントとして指定できるすべてのレイアウトを一覧にした、人が読みやすいカタログです。各レイアウトの [HINT:] 名、プレースホルダー、用途を記載します。
your-template-config.jsonステップ 3 のレンダリングエンジン機能と実際のレイアウトインデックス／名前の対応を示す機械可読のマップです。generate.py --config に渡します。

オプション：--catalog-only を指定すると設定ファイルを省略し、カタログのみを出力します。--name は出力ファイルのベース名を指定します（既定値はファイル名です）。

カタログの内容

カタログのヒント指定可能なレイアウトテーブルには、エンジンが入力できるレイアウトのみが記載されます。各レイアウト名は、安全に [HINT:] の値として使用できます。折りたたみ式のセクションには、参考用としてファイル内の生のレイアウトがすべて一覧表示されます。各行には、レイアウトインデックス、コピーして使う正確なヒント名、プレースホルダー（例：picture、body、center-title）、および「使用する場面」の簡単な説明が表示されます。

次の手順

  1. ステップ 2 — 作成： カタログを開き、各スライドに [HINT: layout_name] を指定して slides.md を作成し、pptx-author/scripts/lint_hints.py slides.md --config your-template-config.json で lint を実行します。
  2. ステップ 3 — レンダリング： pptx-from-layouts/scripts/generate.py slides.md -o deck.pptx --template your-template.pptx --config your-template-config.json --validate を実行します。

注意事項

  • テンプレートのプロファイリングは一度だけ行います。 同じテンプレートを使う今後のすべてのデッキで、カタログと設定ファイルを再利用できます。
  • バンドルされている Inner Chapter テンプレートはプロファイリング済みです（templates/inner-chapter-config.json を参照）。ステップ 1 を省略すると、これが既定で使用されます。
  • ブランドカラー、フォント、スモークテストを含む、完全に自動化されたブランド準拠のオンボーディングには、pptx-template-onboarder サブエージェントがこのステップを実行します。

コメント

Markdown 対応