Communitygithub.com

youquan-he/ppt-template-animator

会話と提供された素材から、編集可能でアニメーションを施したPowerPointプレゼンテーションを作成します。ユーザーの内容をカバーし、ブリーフとテーマを推測し、ローカルテンプレートを調査・分解して、そのアセットとモーションパターンを独自のスライドに再構成します。

ppt-template-animator とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)向けに設計された、PowerPointプレゼンテーション作成・編集のための強力なツールです。ユーザーとの対話や提供された素材(画像、データ、文章など)を基に、視覚的に魅力的でアニメーション効果のあるスライドを生成します。主な特徴は、ローカルに存在するPowerPointテンプレートを解析・分解し、そのデザイン要素(図形、配色、フォント、アニメーション構造)を新しいプレゼンテーションに再利用・再構成する点にあります。単なるテンプレートの適用ではなく、ユーザーの目的やコンテンツに合わせてテーマを設定し、編集可能な状態でアニメーションを含む完成度の高いPPTXファイルを提供します。対応プラットフォームはPowerPoint(デスクトップ版)を想定しており、スクリプトを使ったテンプレート解析やコンポーネント抽出機能も備えています。また、高度なアニメーション制作フローや、動画からのエフェクト抽出ワークフローなど、プロフェッショナルなプレゼンテーション制作に必要な一連のプロセスをサポートします。標準的なビジネスプレゼンから、「精美國PPT」「アニメーションPPT」などの高度なビジュアルデザイン要求まで幅広く対応します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/youquan-he/ppt-template-animator/tree/HEAD

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

素材と対話からPPTを作成する

目標は、ユーザーの目的に合致し、内容が完全で、編集可能かつアニメーションが適切なプレゼンテーションを作成することです。テンプレートは、ページ全体、部分コンポーネント、またはアニメーション手法を提供できますが、最終的な内容やページ構成を決定するものではありません。以下の5つのプロセスを実行し、その後、内容、ビジュアル、および動きの受け入れ確認を行います。インストールと自己完結型の例についてはREADME.mdを、スクリプトパラメータについてはproduction-tools.mdを参照してください。デザイン仕様、日本語組版、ストーリーボード、レビュー方法についてはdesign-and-review.mdを参照してください。これらの方法はこのパッケージ内に整理されており、スキル外部の追加インストールに依存しません。

最初にタスクが、新しい原稿の作成、参照テンプレートの再構成、テンプレートの厳密な遵守、または単なるレイアウトの調整のいずれであるかを判断します。このタスクの範囲を守ってください。ユーザーが分解を許可している場合は独自の再構成が可能ですが、忠実性の保持やレイアウトのみが明示的に要求されている場合は、内容、ページ順序、マスターを変更してはいけません。他のスキルの固定テンプレート、強制ツール、またはページ全体の画像生成プロセスを、すべてのタスクのデフォルトルールと見なしてはいけません。

このディレクトリに preferences.local.json が存在する場合は、まずそれを読み込み、ローカルテンプレートディレクトリ、ビジュアル設定、および調査済みのアニメーションレコードを取得します。これらはユーザーのデフォルト設定ですが、最新のタスクでの明確な指示が優先されます。ファイルがない場合は、今回のリクエストに基づいてスタイルを選択し、作成者のプライベートテンプレートライブラリを前提としません。設定例は preferences.example.json を参照してください。

ユーザーが「精美國アニメーション」「なめらか」「高度な動き」「クール」などを要求した場合は、最初に高度なアニメーション制作の手順に従います。指定された動的ライブラリのソース連続シーケンスを調査 → 移行可能なメカニズムとビジュアルの方向性を決定 → ネイティブに保持または再構築 → コンテンツを置換/結合 → 再生確認。ストーリーボードでは、まずアニメーションメカニズムと必要なオブジェクト/状態を決定し、その後でコンテンツを収容するレイアウトをデザインします。最初に普通の静的スライドを作成し、最後に一括でフェードインやフライインを追加して完了とするのは避けてください。基本的なエフェクトは補助的な説明として使用できますが、ユーザーが要求するコアな高度な効果の代わりにはなりません。

「スクロールテキスト」「スロットマシン風オープニング」「選挙候補者発表」が必要な場合は、スクロールテキストオープニング手法に従って、編集可能なテキスト列、ウィンドウマスク、レバー、サウンドを構成し、ターゲットスライドで実際に再生して確認します。これはオプションのシーン固有のメカニズムであり、すべての表紙のデフォルトスタイルではありません。

ユーザーが参考動画を提供したり、特定のテンプレートページを指定したり、後で「エフェクトX」で調整済みのアニメーションを再現するよう要求した場合は、動画から再利用可能なエフェクトへのワークフローに従い、観察可能なオブジェクト、状態、時間順序を記録し、ソースPPTXと照合してパラメータを確認し、編集可能なターゲットスライドを作成して検証します。動画は画面で見える効果のみを証明できます。ソースファイルがない場合は推測を正確なパラメータとして記述してはいけません。また、サードパーティ作成者のプラグイン、プライベートパス、またはプロンプト全体をこのスキルの依存関係にしてはいけません。

既存のテンプレートを優先的に呼び出すことはできますが、呼び出したテンプレートにアニメーションを追加する必要があります。 アニメーション制作タスクでは、まずテーマに適したページ全体またはコンポーネントを選択し、新しいコンテンツと組み合わせて意味のあるネイティブオブジェクトアニメーションまたは連続シーンを追加します。テンプレートに元々アニメーションがあっても、文字と画像を置き換えるだけでは引き渡しできません。引き続き適用可能な元のタイムラインは保持し、追加した位置、オブジェクト、機能、再生結果を記録します。静的、レイアウトのみ、または新しいアニメーションの追加を厳格に禁止するタスクでは、その要求に従います。

1. 提供された素材が実際に使用されることを保証する

  • 今回のリクエストと関連する会話履歴を確認し、ユーザーが提供したファイル、画像、データ、テキスト、必須の主張ポイント、および以前に指摘された問題をリストアップします。コンテンツ素材、デザイン/アニメーション参考資料、背景情報を区別します。ユーザーによる用途の明確な説明が優先されます。数百の代替テンプレートを含むライブラリを、すべてプレゼンテーションに詰め込む必要があるコンテンツと誤解しないでください。
  • 作業ディレクトリに素材台帳を作成し、個別画像、表、データセット、章、または必須の知識ポイントごとに登録します。長いドキュメントは、欠落を発見できるのに十分な深さ(ページ/セクション/チャートレベル)まで展開します。material-ledger.mdのフィールドを使用します。
  • ユーザーが提供したコンテンツ素材は、デフォルトで本文または付録にすべて配置し、最終的なページ番号と特定のオブジェクト/段落にマッピングします。読んだ、ダウンロードした、計画に書いた、またはソースリンクを置いただけでは、適用したことになりません。表示が要求されている画像とデータは、ノートに隠すだけではいけません。
  • 統合して表現することは可能ですが、台帳には各素材の貢献と位置を保持する必要があります。トリミング、再描画、要約は、重要な証拠と元の意図を保持する必要があります。一般化された挿絵や生成画像で、ユーザーが表示を要求した元の画像を置き換えてはいけません。
  • 重複、不明瞭、開けない、関連性がない、または矛盾する素材を黙って除外してはいけません。問題と処理方法を記録します。すべての使用が要求されている場合は、自己判断で除外してはいけません。時間/ページ数と完全な提示が矛盾する場合は、まず本文と付録の案を作成し、互換性のない制約についてユーザーに質問します。

2. 対話からニーズとテーマを判断する

  • テンプレートを選択する前に、簡単なブリーフを作成します。目的、観客、シナリオ、コアテーマ、一言で言う主張、カバーすべき素材、ボリューム/時間、言語、納品形式、ビジュアルの雰囲気。主にライブプレゼンテーション用か、スタンドアロンリーディング用か、その両方かを説明します。最新の明確な指示と確認済みの好みが、テンプレートの例よりも優先されます。
  • 「明確な要求」「合理的な推測」「まだ不確定」を区別します。内容とシナリオに基づいてテーマを決定し、ファイル名、テンプレート名、または最初の画像だけで判断してはいけません。情報が行動に十分な場合は、合理的なデフォルト値を採用し、ユーザーが既に述べたことを繰り返し質問しないでください。
  • まずナラティブアウトラインを作成し、次にページタイプを選択します。各ページに以下を記述します。どの質問に答えるか、観客に何を覚えておいてほしいか、どの素材が証拠となるか、どのような構成を採用するか、アニメーションが何の理解を助けるか。コンテンツページでは、結論または質問形式のタイトルを優先的に使用し、証拠は観客にとっての意味を説明します。最後に冒頭の質問に戻ります。
  • ライブプレゼンテーション用原稿のストーリーボードでは、予想される発表時間、初期状態、各クリック、読むための停止時間、トランジションを記録し、全体の時間を確認します。機械的に1ページ1分としないでください。発表のヒント、制作上の注意、内部的な時間配分はノートまたは作業ファイルに残し、ページ上のテキストは最終的な観客に向けます。
  • 現在のタスクにおけるユーザーのフィードバックを再利用し、特にテンプレートの単調さ、アニメーションの機械的さ、テキストと画像の混雑などの問題に注意します。既存のスライドを変更する場合は、まず問題と影響を受けるページを特定し、部分的な調整か全面的な再デザインかを決定します。

3. テンプレートのデザインとアニメーション手法を学ぶ

  • 既存のテンプレートインデックスを再利用し、必要に応じて template_catalog.py scan を実行します。アニメーション数、画像面積などの統計はフィルタリングにのみ使用し、これに基づいてテンプレートが優れていると宣言してはいけません。
  • ユーザーが動的参照ライブラリを指定した場合は、まずその中からナラティブに適した連続シーンを探します。study_motion.py を使用して、パス、回転、スケール、同期/オフセット、マスク、Morph状態を調査します。既存の学習記録は検索を短縮するだけであり、実際のソースファイルと適用性は依然として確認する必要があります。
  • 大規模なライブラリでは、テーマに適した少なくとも3つのデザインシリーズを比較します。表紙だけでなく、最も難しい証拠画像、比較ページ、フローページもテストします。フルサイズPNG、全体のサムネイル、実際の再生結果で判断します。
  • 「色彩豊かでテーマが明確」は明確なビジュアル要件です。表現力のあるメイン/サブカラー、テーマ画像/グラフィック、大規模な構成を使用し、実際のコンテンツの表紙と代表的なコンテンツページを最初に表示します。理由なく白黒グレーに小さなアクセントカラーに後退したり、テーマ表現の代わりにカラフルな装飾を積み重ねたりしないでください。ブランド、シリアスなシナリオ、または今回のユーザーの明確な要求は、この方向を変更できます。
  • 方向性を選択したら、全スライドのデザイン仕様を確立します。テーマの雰囲気、背景、日本語/欧文フォント、フォントサイズ階層、セマンティックカラー、間隔、画像処理、密度。分解ツールのテーマ/直接スタイルレポートを使用し、レンダリング画像と照合します。固定のビジュアルルールを設定し、コンテンツに応じて構成を変更します。まず代表的な困難なページを検証し、次に全体に拡張します。
  • 移行可能な「アニメーションスキーム」を記録します。ソーステンプレートとページ番号、オブジェクト、初期状態、トリガー順序、継続時間/遅延、移動方向、オブジェクト関係、最終状態、適用シナリオ。タイムラインと再生を通じて学習し、エフェクト名をコピーするだけではいけません。
  • セマンティックにアニメーションを移行します。段階的な表示はプロセス用、同期出現は公平な比較用、連続スケール/移動は概要から詳細へ、強調はポイントの指摘用。新しい素材のサイズ、位置、読み取り時間に基づいてパラメータを再設定し、すべてのオブジェクトに同じフライインを適用しないでください。
  • Morph、モーションパス、トリガー、グループオブジェクトは隣接するページや他の形状に依存する場合があります。必要な関係を保持し、移行後に再バインドして再生を確認します。静的スクリーンショットやトランジションは、ページ内オブジェクトアニメーションと同等ではありません。
  • 高度なアニメーション要求には、作業ファイルに「ソースファイル/連続ページ、メカニズム、ターゲットシーン、保持/移行/再構築戦略、オブジェクトとトリガー、実際の実装と再生証拠」を記録します。ページ内の複雑な構成と完全なクロスページMorphシーンを区別します。どちらも高度なアニメーションを構成できますが、単一のページ切り替えや effect_count > 0 は要件を満たしていることを証明しません。

4. テンプレートを分解し、テーマに従って再構成する

  • ページ全体が適切な場合はそのまま適応できます。新しい構成が必要な場合は、すべてのテンプレートが失敗するのを待たずに、部分的要素を直接抽出できます。再利用するオブジェクトには、図形、アイコン、画像フレーム、グループ、フローコンポーネント、編集可能なチャート、配色、フォント階層、アニメーション構造が含まれます。
  • decompose_template.py inspect を使用して、すべての形状、グループ内オブジェクト、関連するテーマのフォント/配色、オブジェクトの直接スタイルを表示します。extract を使用して、トップレベル形状IDで編集可能なコンポーネントPPTX、参照画像、ソースページ/コンポーネントプレビュー、デザインおよびアニメーションレポートをエクスポートします。コマンドと制限についてはproduction-tools.mdを参照してください。
  • 元の画像、SVGなどは独立して使用できます。形状、グループ、チャートはコンポーネントPPTXに保存され、引き続き編集可能です。ページ全体のスクリーンショットを「分解済みテンプレート」と見なしたり、生のXMLをファイル間で直接コピー可能なコンポーネントと見なしたりしないでください。
  • コンポーネントのソース、ページ番号、形状ID、用途、アニメーション依存関係を保持します。テンプレートサンプル内のデータ、テキスト、ブランド、意見は単なるプレースホルダーコンテンツであり、新しいスライドの事実になってはいけません。
  • 新しいテーマに合わせて階層、サイズ、位置、配色、余白を再構成します。テンプレート間で再利用する場合、ビジュアルシステムを統一します。コンポーネントを変更した後、コネクタライン、ラベル、トリミング、モーションパスをチェックします。ターゲットスライドで編集機能とアニメーションを再検証し、コンポーネントファイルのみを検証しないでください。
  • コンポーネントがマスター、フォント、インタラクティブトリガー、または前のページに依存する場合は、記録して処理します。確実に保持できない部分はネイティブオブジェクトで再構築し、実際の実装を説明し、完全に保持されたと主張しないでください。

5. 実際のギャップに応じて他の方法を補完する

  • ユーザーのテンプレートと補助スクリプトは能力の上限ではありません。最初に不足しているものが、事実、画像、構造図、ビジュアルリファレンス、アニメーション実装のいずれであるかを特定し、対応する方法を選択します。目的のない収集を避けます。
  • 公開デザイン事例、公式技術資料、利用可能な素材を検索できます。ネイティブ形状/チャート、SVG、プログラム描画、利用可能な画像生成ツール、またはその他の適切な方法を使用することもできます。実際のコンテンツに基づいて構造図を再描画する場合は、元の意図を保持します。生成された模式図は実際の証拠と区別する必要があります。
  • ユーザーが追加のスキルやアーカイブディレクトリを設定している場合は、そのルールに従って関連する説明を必要に応じて読み取ります。このパッケージには固定の個人用ディレクトリや他のスキルの実行依存関係はなく、無関係なスキルを自動的にインストールまたは一括アクティブ化しません。
  • 外部の事実については、テーマに適した信頼できるソースを使用し、検証します。技術実装は公式ドキュメントを優先します。外部素材の出典、使用条件、用途を保持します。補完コンテンツはユーザーの必須素材を押しのけてはいけません。また、許可なくプライベート素材を外部サービスにアップロードしてはいけません。
  • 新しい方法は、まず1ページの代表的なサンプルで編集機能、表示、再生パフォーマンスを検証し、その後全体に拡張します。ツールが静的のみをサポートしているか、特定の効果と互換性がない場合は、正確に説明し、検証可能な実装を採用します。

制作と受け入れ確認

  1. コンテンツ:最終ファイルに基づいて素材台帳を再確認し、必須の各コンテンツが実際に出現し、重要な部分がトリミングされていないことを確認します。データ、引用、テーマ、プレゼンテーションのメインスレッドを確認します。未解決の欠落がある場合、「すべて適用済み」と宣言してはいけません。
  2. デザインとナラティブ:参考資料のビジュアル、ナラティブ/理解、テキスト/事実の3つのラインでそれぞれレビューし、問題のあるページとオブジェクト、重大度、修正とレビュー結果を記録します。各ページでフォント、改行、鮮明度、トリミング、重なり、余白をフルサイズで確認します。サムネイルで全体のリズムを確認します。日本語の文字欠け、句読点、数値単位、チャート、グループ内テキストは個別に確認します。混雑したページは概念のバランスで分割し、フォントサイズを縮小したり、埋めるために内容を捏造したりしないでください。
  3. 動き:実際に再生するか、利用可能な再生記録を確認し、初期状態、各クリック、画像とラベルの同期、停止時間、トランジション、Morphの連続性を確認します。高度な要求の場合は、計画されたコアメカニズムが実際に最終製品に組み込まれ、コンテンツに貢献しているかを項目ごとに再確認します。表紙だけを動かし、コンテンツページはすべて基本効果に戻っている状態を許してはいけません。静的プレビュー、XML数、スクリプトの成功は再生品質を証明しません。未完了の動きのチェックは正直に報告します。
  4. ファイル:PowerPoint ネイティブで最終PPTXを開き、編集可能なテキスト、素材、ノート、ネイティブアニメーションを確認します。ビルダーレポートが native_validated: false の場合でも、ネイティブで開いて受け入れ確認を行う必要があります。素材の欠落、事実/データエラー、重要なコンテンツの読み取り不能や切り捨て、ファイル破損、必須アニメーションの欠落などのブロッキング問題は修正する必要があります。平均スコアで相殺してはいけません。
  5. 納品:最終PPTXを提供し、素材カバレッジ、デザインとアニメーションの選択、実際の検証範囲を簡単に説明します。ディレクトリインデックス、台帳、分解コンポーネント、スクリプト、中間プレビューは、ユーザーが追加で要求しない限り、作業ディレクトリに残します。

関連スキル