Pptx Analyzer

Documents

pptx-analyzer

Pptx Analyzer is an Agent Skill for documents published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

PowerPointファイル（.pptx）の構造を解析し、スライド・図形・プレースホルダー・テキスト情報をJSON/テキスト形式で出力するツール。テンプレート分析、スライド自動生成の前処理、PPTX構造の理解が必要な場合に使用。「PPTXを解析」「テンプレート構造を確認」「スライドの要素を調べて」等のリクエストで発動。

View on GitHub ↗

QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

Open your project in Codex.
Copy and paste the prompt below.
Review files and risks before approving any action.

Prompt to paste

Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/data/pptx-analyzer/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/pptx-analyzer, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

PPTX Analyzer

PowerPointファイルの構造を解析するスキル。

機能

構造抽出: スライド、図形、プレースホルダー、テキストを抽出
画像生成: スライドをPNG画像に変換（オプション）
意味解析: Geminiによるスライド役割・要素用途の判定（オプション）

使用方法

# 基本解析（JSON + TXT出力）
python scripts/analyze_pptx.py template.pptx

# 画像付き解析
python scripts/analyze_pptx.py template.pptx --with-images

# Gemini意味解析付き
python scripts/analyze_pptx.py template.pptx --with-gemini

# 出力先指定
python scripts/analyze_pptx.py template.pptx --output-dir ./output

出力形式

JSON（`{filename}_structure.json`）

{
  "source_file": "template",
  "total_slides": 5,
  "slides": [
    {
      "slide_index": 0,
      "layout_name": "タイトル スライド",
      "shapes": [
        {
          "shape_id": 2,
          "name": "Title 1",
          "shape_type": "Shape",
          "left": 838200,
          "top": 2130425,
          "width": 10515600,
          "height": 1325563,
          "text": "プレゼン資料のタイトル",
          "has_text_frame": true,
          "is_placeholder": true,
          "placeholder_type": "TITLE (1)"
        }
      ]
    }
  ]
}

テキスト（`{filename}_structure.txt`）

=== Slide 1 (Layout: タイトル スライド) ===
  [2] Title 1
      Type: Shape, Pos: (0.9", 2.3"), Size: 11.5" x 1.5"
      Placeholder: TITLE (1)
      Text: "プレゼン資料のタイトル"

依存関係

python-pptx: 必須
Pillow: 画像処理（--with-images使用時）
pdf2image + LibreOffice: PDF経由画像変換
google-generativeai: Gemini解析（--with-gemini使用時）

ユースケース

テンプレート分析: 自動スライド生成前にテンプレート構造を把握
プレースホルダー特定: 置換対象のテキストボックスやチャート位置を特定
レイアウト確認: 各スライドのレイアウト種類と配置を確認