Gslides Parser

Documents

gslides-parser

Gslides Parser is an Agent Skill for documents published in the minicoohei/ai-agent-camp repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Google Slides の構造を GAS 経由でパースし、YAML マッピングを出力するスキル。「スライドをパースして」「スライドの構造を解析」「YAMLマッピング作成」等のリクエストで発動。 pptx-converter 互換のセマンティック解析 + プレースホルダー付与。

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/minicoohei/ai-agent-camp/blob/HEAD/.claude/skills/gslides-parser/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/gslides-parser, 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.

/gslides-parser - Google Slides パーサー

Google Slides プレゼンテーションの構造を GAS 経由でパースし、pptx-converter 互換のマッピング YAML を出力する。

前提条件

# clasp は npx 経由で実行（インストール不要）
# Google アカウントでログイン
npx -y @google/clasp login

# Google Apps Script API を有効化
# https://script.google.com/home/usersettings

クイックスタート

# 1. GAS プロジェクト初期設定（初回のみ）
python skills/gslides-parser/scripts/gslides_parser.py setup

# 2. GAS エディタで一度手動実行して権限を付与
npx @google/clasp open --cwd skills/gslides-parser/gas/

# 3. パース実行
python skills/gslides-parser/scripts/gslides_parser.py analyze \
  1ZVAI8Cjts1N44lYXgoCoZXfb0gz7BAx7A1A5-bhapvQ \
  -o output/slides/mapping.yaml

サブコマンド

コマンド	説明
`setup`	GAS プロジェクト初期設定（clasp create + push）
`analyze <id>`	プレゼンテーションをパース → YAML 出力
`json <id>`	GAS パース結果の JSON だけ出力

オプション

analyze

オプション	説明	デフォルト
`-o, --output`	出力 YAML パス	`output/slides/gslides_<id>_<timestamp>.yaml`
`--no-gemini`	Gemini セマンティック解析を無効化	false
`--skip-push`	clasp push をスキップ	false

json

オプション	説明	デフォルト
`-o, --output`	出力 JSON パス	stdout
`--skip-push`	clasp push をスキップ	false

出力 YAML スキーマ（pptx-converter 互換）

source: "Google Slides: プレゼン名"
presentation_id: "1ZVAI8..."
presentation_url: "https://docs.google.com/presentation/d/1ZVAI8.../edit"
generated_at: "2026-02-10T12:00:00"
slide_width_pt: 720
slide_height_pt: 405

slides:
  - slide_number: 1
    object_id: "p6"
    layout: "TITLE"
    elements:
      - id: "g1234abcd"
        type: text
        role: title
        hint: "メインタイトル。"
        position: { left: 36, top: 150, width: 648, height: 80 }
        style: { font: "Noto Sans JP", size: 36, bold: true, color: "333333" }
        value: "タイトルテキスト"
        placeholder: "{{slide_1_title}}"

placeholders:
  - key: "{{slide_1_title}}"
    type: text
    role: title
    current: "タイトルテキスト"

処理フロー

[ユーザー] → python gslides_parser.py analyze <id>
                    │
        ┌───────────┴───────────┐
        │  1. clasp push        │  GAS コードを反映
        │     (gas/ → GAS)      │
        └───────────┬───────────┘
                    │
        ┌───────────┴───────────┐
        │  2. clasp run         │  parsePresentation() 実行
        │     parsePresentation │  → JSON 構造を返す
        └───────────┬───────────┘
                    │
        ┌───────────┴───────────┐
        │  3. gas_to_yaml.py    │  セマンティック解析
        │     JSON → YAML 変換  │  + プレースホルダー付与
        └───────────┬───────────┘
                    │
        ┌───────────┴───────────┐
        │  4. YAML 出力         │  pptx-converter 互換
        └───────────┘

GAS パーサーがパースする要素

要素タイプ	抽出情報
Shape (テキスト)	テキスト、スタイル(font/size/bold/color)、プレースホルダー判定、塗りつぶし色
Image	ソースURL、コンテンツURL、リンク
Table	全セルテキスト、行列数、ヘッダー検出、セルスタイル
Group	子要素の再帰的パース
SheetsChart	スプレッドシートID、チャートID
Line	線種、太さ、色
WordArt	レンダリングテキスト
Video	ソース、URL、動画ID

セマンティック解析

ヒューリスティックで以下のロールを自動判定:

テキスト: title, subtitle, heading, body, caption, label, footnote, page_number, bullet_list
画像: hero_image, logo, icon, photo, decorative, background
テーブル: data_table, comparison_table, schedule_table
チャート: revenue_chart, trend_chart, comparison_chart
シェイプ: accent_decoration, callout, divider, background_shape
グループ: process_flow, feature_cards, step_diagram

トラブルシューティング

エラー	原因	対処法
`Not logged in`	clasp 未ログイン	`npx @google/clasp login`
`Script API disabled`	GAS API 無効	GAS API 設定で有効化
`PERMISSION_DENIED`	OAuth スコープ未承認	GAS エディタで一度手動実行して権限付与
`Function not found`	push 未完了	`npx @google/clasp push --force`
タイムアウト	大きなプレゼン	GAS エディタから直接実行