使い方ガイドへスキップ
pptx-reference-deck-analysis作者 Seth Hobson

PPTX Reference Deck Analysis スキル。

Claude Code と Codex 用の PPT とスライドデッキ向けスキルです。参照 PPTX のテーマ、タイポグラフィ、レイアウトリズム、診断情報を分析します。

  • Presentations
  • レビューレポート
wshobson/agents · plugins/pptx-deck-creation/skills/pptx-reference-deck-analysis/SKILL.mdSKILL.md
--- name: pptx-reference-deck-analysis description: Use when analyzing a reference PPTX for read-only structure, theme, typography, layout rhythm, diagnostics, derived template catalogs, or safe OOXML package inspection. --- ## Contract ## Rules ## OOXML package inspection
上流ファイルから読み取ったフロントマターとセクション見出し(2026-09-14 時点)· 全 2,755 文字

01 できること

Claude Code と Codex における pptx-reference-deck-analysis スキルの機能

概要、ワークフロー、出力。いずれもスキルの SKILL.md から読み取った内容です。

SKILL.md より2026年9月14日読取 · 実行記録ではありません

スキル自身の言葉で

参照用の PPTX をデザインの証拠として検査し、意図的にコピー、クローン、変更は一切行いません。タスクローカルな小さな python-pptx スクリプトが必要な抽出をオンデマンドで実行し、コンパクトなプロンプトコンテキスト(スライド数とサイズ、シェイプ数、ブランドシグナル、レイアウトのリズム)、読み取り専用の layout_tree による完全抽出、フォルダ診断、スタイルマスター解析、ゼロベースのソースインデックスを持つ派生テンプレートカタログをカバーします。

バンドルされた OOXML ユーティリティが、生のテーマ、リレーションシップ、ノート、コメント、アニメーション、メディア、マスター、レイアウトを処理し、inspect.py、validate_package.py、unpack.py の各スクリプトが JSON レポート、パッケージ検証、任意の生パッケージ抽出を提供します。検査されたすべてのパートとパースの例外は解析マニフェストに記録され、抽出されたアセットはライセンスの証拠がない限り新しいデッキには含まれません。

生成されるもの

  • コンパクトなプロンプトコンテキスト:スライド数とサイズ、テキストの要約、シェイプ数、スタイル、ブランドシグナル、テンプレートの使用状況、レイアウトのリズム。
  • summary、slides、読み取り専用の layout_tree による証拠の完全抽出。
  • 色、フォント、サイズ分布、マスター/レイアウトの使用状況、フローパターンを含むスタイルマスター解析。
  • ゼロベースのソースインデックス、レイアウトの役割、使用可能な領域、プレースホルダー、視覚的構造、制約を持つ派生テンプレートカタログ。
プロンプト例を見る ↗

仕組み

  1. 01
    タスクローカルな Extractor を作成する

    必要な抽出は、固定されたパイプラインではなく、小さな python-pptx スクリプトによってオンデマンドで実装されるため、新しいデッキが必要とする情報だけが取得されます。

  2. 02
    コンパクト検査を実行する

    scripts/inspect.py はデッキのパスを受け取り、スライドの順序、テキスト、テーマトークン、リレーションシップ、ノート、コメント、アニメーション、メディアをカバーする1つの JSON レポートを返します。

  3. 03
    OOXML ユーティリティへのエスカレーション

    バンドルされたユーティリティは、高レベルの抽出では見えない生のテーマ、リレーションシップ、ノート、コメント、アニメーション、メディア、マスター、レイアウトのためのフォールバックパスです。

  4. 04
    リレーションシップを .rels の所有者に紐づける

    リレーションシップのターゲットは .rels ファイルを所有するパートに対して相対的に解決され、スライドの順序はファイル名から推測されることはありません。

02 適合性を確認

pptx-reference-deck-analysis スキルを使用するタイミング

Claude Code または Codex で、この種の PPT とスライドデッキのジョブに pptx-reference-deck-analysis スキルを使用します。適合性と制限は、スキル自体のファイルから取得されています。

適している場合

  • 新しいデッキに複製するのではなく、参照デッキをデザインの証拠として読み取りたい場合。
  • デッキのフォルダ全体で診断を実行し、デッキごとに1つの結果とマニフェストを得たい場合。
  • 出力の形状とドキュメント専用パターンに関するバンドルされた参照ドキュメントが必要な場合。

境界を知る

  • ソースデッキを読み取るだけでなく、クローンや変更を行うもの。

提供すべきもの

  • 参照デッキのパスバンドルされたスクリプトは .pptx を最初の引数として受け取り、それが唯一の必須入力です。
  • 生パッケージの証拠のための出力ディレクトリunpack.py は指定したディレクトリに抽出されたパートを書き込み、生パッケージの証拠が必要な場合にのみ実行されます。
  • requirements.txt の defusedxmlバンドルされた OOXML ユーティリティを使用する前にインストールされます。

03 スキルの内部

pptx-reference-deck-analysis スキルが Claude Code と Codex に与えるルール

SKILL.md がエージェントに設定する6つの具体的な指示、デフォルト、制限 — ファイルの中でも結果を変える部分です。

  1. ソースを読み取り専用に保つ

    参照デッキは決して編集されず、新しいターゲットスライドの各座標はすべて継承せずに独立して作成されます。

  2. 検査内容をログに記録する

    検査されたすべてのパーツと解析時の例外は、解析マニフェストに記録する必要があります。

  3. ライセンスの証拠なしに再利用しない

    抽出されたコンテンツ、フォント、画像、および専有アセットは、明示的な許可とライセンスの証拠がない限り、生成されたデッキに含めることはできません。

  4. 信頼できるワークスペースから実行する

    スクリプトはパストラバーサル、シンボリックリンク、過大なメンバー、アーカイブボムを拒否するため、信頼できる作業ディレクトリを前提としています。

  5. Defusedxmlでxmlを解析する

    信頼できないXMLは、エンティティ展開、DTDの読み込み、ネットワークアクセスをすべて無効にした状態でdefusedxmlを通す必要があります。

  6. テーマカラーをトークンとして扱う

    テーマカラーは、カラースキームに対して完全に解決されるまでトークンのままです。

04 実際に使う

Claude Code または Codex に pptx-reference-deck-analysis をインストール

npx skills add コマンドを実行し、エージェントで最初のタスクを実行して、結果をチェックリストで確認します。

Claude Code、Codex または独自のエージェントに pptx-reference-deck-analysis を追加

プロジェクトで実行してください。インストーラーが、どのエージェントに追加するかを尋ねます。

Terminal
npx skills add https://github.com/wshobson/agents --skill pptx-reference-deck-analysis

plugins/pptx-deck-creation/skills/pptx-reference-deck-analysis/SKILL.md用の汎用skills CLI形式です。リポジトリは独自のパスを文書化している場合があります。

スキルに初めての PPT・スライドデッキタスクを与える

スキル自身の用語で記述されています。角括弧の部分はご自身の内容に置き換えてください。

Starter prompt
I have a reference deck at [path/to/reference.pptx]. Inspect it as design evidence and give me the compact prompt context, a style-master analysis of colors, fonts and flow patterns, and a derived template catalog with layout roles, usable regions and placeholders. Validate the package and record inspected parts and parsing exceptions in the manifest, keeping the source read-only.

出典:SKILL.md をスキル自身の用語に沿って記述。

最初の結果を確認

SKILL.md 自体が正しい結果として示しているもの:

  • validate_package.pyを--outputオプション付きで実行し、レポートを読んで、不正なXML、破損した内部関係、コンテンツタイプの欠落、重複したレイアウトリンク、孤立したパーツを確認してください。

OpenDesignではSKILL.mdリンクからpptx-reference-deck-analysisをインポートします:Plugins → Add → Skill → Import from link、その後トップバーで選択します。

05 オープンソースで追跡可能

ソース、ライセンス、検証

このページの情報の出所と、最終確認日時です。

Repository
github.com/wshobson/agents ブランチ main
スキルファイル
plugins/pptx-deck-creation/skills/pptx-reference-deck-analysis/SKILL.md 検証時に記録されたコンテンツチェックサム;コミット 4236bb9
License
MIT LICENSE より
リポジトリスター数
39,635 wshobson/agents リポジトリ全体の GitHub スナップショットは 2026-09-14 に取得されました。このカタログには 18 個のスキルが含まれています。pptx-reference-deck-analysis の評価や使用数ではありません。
OpenDesign により検証済み
2026-09-14 ソースファイル、パス、ライセンステキスト、スター数を確認済み。OpenDesign 本体にはバンドルされていません(2026-08-28 確認)。このページには実行記録がありません。

SKILL.md の中身

  1. コントラクト5つの抽出出力:プロンプトコンテキスト、完全な抽出、フォルダ診断、スタイルマスター解析、テンプレートカタログ。
  2. ルール読み取り専用のソース、独立して作成された座標、マニフェストへのログ記録、再利用前のライセンスの証拠。
  3. OOXMLパッケージ検査defusedxmlをインストールし、inspect.py、validate_package.py、unpack.pyを実行します。.relsのターゲットを解決します。
  4. 安全性信頼できるワークスペース、トラバーサルとアーカイブボムの拒否、defusedxmlによる解析、トークンとしてのテーマカラー。
スキル自身による説明
読み取り専用の構造、テーマ、タイポグラフィ、レイアウトリズム、診断、派生テンプレートカタログ、または安全な OOXML パッケージ検査のために参照 PPTX を分析する際に使用します。

SKILL.md からの前付け説明。完全なファイルは約 2,755 文字です。GitHub で完全なファイルを読む。

06 インストールする前に

pptx-reference-deck-analysisスキルに関する質問

回答は 2026-09-14 時点で読んだ SKILL.md に基づくもので、記録された実行結果によるものではありません。

参照デッキを解析すると、ファイルが変更されますか?

いいえ。このスキルは提供されたデッキを変更することは決してなく、パッケージパーツを新しいデッキに無条件でコピーすることもありません。ソースは読み取り専用のままで、新しいスライドは独立して作成されます。

PPTX Reference Deck Analysis

実際の PPT and Slide Decks タスクで pptx-reference-deck-analysis を実行します。

OpenDesign をダウンロードし、SKILL.md リンクから pptx-reference-deck-analysis をインポートし、上記のプロンプトを貼り付けて、結果を確認する前にプランを読んでください。

ターミナル
npx skills add https://github.com/wshobson/agents --skill pptx-reference-deck-analysis

OpenDesign デスクトップ版

ひとつのデザインシステムで、すべての制作物をブランドらしく

完全な Vibe Design Workspace で、同じブランドルールを Web サイト、スライド、操作できるプロトタイプ、ダッシュボード、画像、HTML 動画に展開できます。ローカルの Codex、Claude Code、Cursor などを接続して無料で制作しましょう。

  • Web、スライド、プロトタイプ、ダッシュボード、画像、動画
  • 140+ のデザインシステムと完全なテンプレート/スキルライブラリ
  • ローカル Codex と 21+ のコーディングエージェントを接続 · 無料
無料ダウンロード

macOS と Windows に対応