mcpField
P
powerpoint-ppt

powerpoint-ppt

github.com/practicalswanドキュメント221.6k 回インストール1 週間前に更新
リポジトリ

powerpoint-ppt について

powerpoint-pptは、スライド構成を重視するPowerPoint資料の作成、編集、確認に使うスキルです。テンプレートを活用した手順とレンダリング後の確認を案内し、プレゼンテーションツールがない場合はpython-pptxを代替手段として使います。

主な機能

  1. 01PowerPoint資料の作成と更新
  2. 02テンプレートと一貫したレイアウトの利用
  3. 03レビューや翻訳向けのスライドテキスト抽出
  4. 04レンダリング後のスライドと配置の確認
  5. 05python-pptxによる自動化への切り替え

活用シーン

  1. 01構造化コンテンツから資料を作成
  2. 02既存資料にブランド要素を適用
  3. 03スライドのはみ出しや配置の問題を確認

MCP 対応

ホストがプレゼンテーションツールを提供する場合はPowerPoint MCPを優先します。利用できない場合はローカル自動化と手動検証を案内し、MCPツール名が一定だとは想定しません。

インストール

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

$npx skills add https://github.com/practicalswan/agent-skills --skill powerpoint-ppt

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

CHANGELOG.md
LICENSE.txt
examples/
presentation-examples.md
scripts/
ppt-automation.py

詳細

PowerPoint プレゼンテーションのワークフロー

対象技術スタック/バージョン:PowerPoint の現行デスクトップ版または Web 版、および python-pptx による自動化。

出力が .pptx デッキで、スライド構成が重要な場合にこのスキルを使用します。

  • 利用できる場合は、ネイティブの並列サブエージェントのディスパッチと 200k 以上のコンテキストウィンドウを活用します。

現在の MCP の実情

プレゼンテーション向け MCP ツールはホストによって異なります。一部のクライアントでは Office プレゼンテーションツールが直接公開されていますが、そうでないクライアントもあります。安定した公開ツール名があると想定しないでください。現在のクライアントにそのようなツールがない場合は、同梱のローカル自動化スクリプトを使うか、まずコンテンツ構成を作成してから PowerPoint にインポートしてください。

起動条件

症状からアクションにつなげるトリガーを使用し、一致するものがあればこのスキルを適用して、以下のプロトコルに沿って確認します。

  • 構造化されたコンテンツからデッキを作成する
  • テンプレート、ブランディング、スライドレイアウトを適用する
  • 既存のプレゼンテーション内のテキスト、画像、グラフを更新する
  • レビューまたは翻訳のためにスライドのテキストを抽出する

実践的なワークフロー

  1. クライアントがプレゼンテーションツールを公開しているか確認します。
  2. 個別に手作業でスライドを整えるより、テンプレートを利用したデッキを優先します。
  3. 1 枚のスライドにつき 1 つのアイデアに絞り、テキストの過密を問題として扱います。
  4. 完了とする前に、最終デッキを視覚的に検証します。

MCP の代替手段 – ネイティブ自動化

MCP を利用できない場合は、ネイティブの自動化を使います。.pptx には python-pptx を使用し、視覚的な検証には画像の書き出しまたはスクリーンショットによる確認を行い、アニメーションや発表者ノートは手動でレビューします。スライドの順序、レイアウト、テーマのフォント、メディア、ノート、アスペクト比を保持し、成功を宣言する前にデッキを再度開くかレンダリングします。

クライアント間の移植性

このスキルは、GitHub Copilot、Claude Code、Codex のいずれでも使えるように作成されています。

  • GitHub Copilot:フォルダーを Copilot から参照できるスキルパスに配置するか、フォルダーの検出が利用できない場合は、ワークフローをプロジェクトの指示に含めます。
  • Claude Code:フォルダーをローカルのスキルディレクトリまたは互換性のあるプラグインソースに配置します。
  • Codex:フォルダーを $CODEX_HOME/skills/powerpoint-ppt にインストールまたは同期し、大きな変更を加えた後に Codex を再起動します。

MCP の利用可否と代替手段

推奨 MCP サーバー:PowerPoint MCP

  • 代替プロンプト:「MCP を使わずに PowerPoint Presentation Workflows スキルを使用してください。文書化されたローカルまたは手動の代替手段に従い、選択したツールの範囲を示して、検証の根拠を報告してください。」
  • MCP の機能が利用できない場合は、python-pptx、PowerPoint デスクトップ版、またはスクリプトで操作可能なスライド生成ツールを使用します。
  • 最終デッキをレンダリングし、納品前にレイアウト、はみ出し、発表者向けノートを手動で確認します。
  • アクティブなホストで MCP が公開されていない場合、MCP の操作を使用したと主張しないでください。

アンチパターン

  • 読み手ではなく作成者向けに書くこと:明示されていない前提が埋め込まれ、実際の対象者が次に何をすべきか分からなくなります。
  • 具体例やコマンドを省くこと:抽象的なガイダンスは承認されやすい一方で、正しく適用するのは困難です。
  • リンク、スクリーンショット、バージョンの更新を怠ること:書式が整っていても、手順が古ければ役に立ちません。

検証プロトコル

「スキルが正常に適用された」と宣言する前に、以下を確認します。

  1. 合否:編集前に Powerpoint Ppt の成果物タイプ、対象フォーマット、必要な出力忠実度が示されている。
  2. 合否:MCP の利用可否が確認され、MCP がない場合はネイティブ自動化の代替手段が明示されている。
  3. 合否:生成されたファイルまたは数式が開かれ、解析、レンダリング、またはその他の方法でローカル検証されている。
  4. 負荷テストのシナリオ:書式、メタデータ、または変換に関するエッジケースを含むファイルにワークフローを適用し、重要な情報が失われていないことを確認する。
  5. 成功基準:検証されていない文書に関する主張がゼロであり、成果物そのものが証拠となっている。

デッキのチェックリスト

  • タイトルスライドがある
  • スライドのレイアウトに一貫性がある
  • フォントと色がテンプレートに合っている
  • 画像の解像度が高く、引き伸ばされていない
  • 最終スライドを、生の XML やテキストだけでなく、スライドショーのサイズでレビューした

参考資料とリソース

スクリプト
例

関連スキル

  • documentation-authoring:ワークフローで構造化された技術文書や製品ドキュメントの作成も必要な場合に使用します。
  • documentation-patterns:ワークフローで再利用可能なドキュメント構成やテンプレートも必要な場合に使用します。
  • documentation-quality:ワークフローでドキュメントのレビュー基準や品質ゲートも必要な場合に使用します。
  • documentation-verification:公開前に最終的なドキュメント検証も必要な場合に使用します。

コメント