powerpoint-automation

SKILL.md

PowerPoint Automation

AI-powered PPTX generation using Orchestrator-Workers pattern.

When to Use

Web 記事やブログをスライド化したいとき

既存 PPTX を翻訳・再構成したいとき

開いている PPTX を COM Automation で直接編集したいとき

テンプレートベースで PPTX を生成したいとき

content.json を SSOT にして、抽出・翻訳・生成・レビューを分離したいとき

Quick Start

From Web Article

Create a 15-slide presentation from: https://zenn.dev/example/article

From Existing PPTX

Translate this presentation to Japanese: input/presentation.pptx

Edit Open PPTX with COM

Edit the currently open PowerPoint deck with COM Automation and verify RefURL, notes, overflow, and hyperlinks.

Workflow

TRIAGE → PLAN → PREPARE_TEMPLATE → EXTRACT → TRANSLATE → BUILD → REVIEW → DONE

Phase
Main Actor
Purpose

EXTRACT
extract_images.py
Source -> content.json

BUILD
create_from_template.py
content.json -> PPTX

REVIEW
PPTX Reviewer
Overflow / consistency / quality

Core Assets

Scripts

Script
Purpose

create_from_template.py
content.json から PPTX を生成するメインスクリプト

reconstruct_analyzer.py
既存 PPTX を content.json に戻す

extract_images.py
PPTX / Web から画像を抽出する

validate_content.py
content.json のスキーマ検証

validate_pptx.py
overflow などの検証

詳細は references/SCRIPTS.md を参照。

content.json

content.json はこの skill の SSOT。抽出、翻訳、生成、レビューの間は常にこれを基準にする。

{
  "slides": [
    { "type": "title", "title": "Title", "subtitle": "Sub" },
    { "type": "content", "title": "Topic", "items": ["Point 1"] }
  ]
}

スキーマ詳細は references/schemas/content.schema.json を参照。

Template

標準テンプレートは assets/template.pptx。レイアウトや用途の詳細は template 側で管理し、main SKILL には最小限だけ残す。

python scripts/create_from_template.py assets/template.pptx content.json output.pptx --config assets/template_layouts.json

Agents

Agent
Purpose

Orchestrator
Pipeline coordination

Localizer
Translation (EN <-> JA)

PPTX Reviewer
Final quality check

定義詳細は references/agents/ を参照。

Operating Rules

SSOT: content.json を正とする

One phase, one purpose: 抽出・翻訳・生成・レビューを混ぜない

Fail fast: 問題が出たら次フェーズへ無理に進めない

Human in loop: PLAN でユーザー確認を入れる

Technical content is verified content: Azure / Microsoft の内容は MCP で一次情報確認してから入れる

PowerPoint lock first: 開いている PPTX に対して python-pptx で上書きしない

COM for open decks: 開いている PPTX や既存 deck の直接編集は references/instructions/com-automation.instructions.md を参照する

Operational text stays in notes: 運営メモはスライド面に出さない

Customer-facing surface only: 顧客向け deck のスライド面には内部向け話法、避ける表現、作業メモ、検証メモ、ファイル用途ラベルを混ぜない。話者向け情報は speaker notes へ分離する

Template means template: ユーザー指定テンプレートがある場合、特に表紙はテンプレートの既存プレースホルダー/レイアウトを使い、上から別図形を重ねて隠さない

Rendered QA before handoff: COM で開いている deck を直接 touch-up した後も、対象 deck から実レンダー画像を書き出し、重なり・フォントばらつき・表の可読性を個別 slide で確認する

Review like a critic, not a generator: ユーザーに見せる前に、レンダー画像で「スカスカ・文字が小さい・アイコンが雑・テンプレ踏襲不足・旧文言残り」を自分で探して直す。詳しくは references/instructions/deck-iteration-review.instructions.md

Media restore gate: slide insertion/deletion/recovery after a user review must re-check expected slide count and embedded video/media positions before continuing

Architecture diagrams use shapes: ASCII art ではなく図形で組む

Appendix URLs use Title - URL: 参考 URL の表示形式は統一する

Review content and visuals separately: 生成後は見た目レビューだけでなく、公式情報との正確性レビュー、URL hyperlink 数、notes 数、placeholder/internal wording を確認する

Reference Map

Frequently Needed

references/SCRIPTS.md

references/USE_CASES.md

references/content-guidelines.md

references/IMPLEMENTATION_PATTERNS.md

references/instructions/com-automation.instructions.md

references/instructions/template.instructions.md

references/instructions/customer-facing-deck.instructions.md

references/instructions/deck-iteration-review.instructions.md

Go to Implementation Patterns For

technical content verification workflow

shape-based architecture diagrams

template-based slide XML editing order

COM SlideMaster / CustomLayouts edits for reusable templates

rendered-slide visual QA loop

PptxGenJS hardening pitfalls

hyperlink batch processing

customer-facing deck surface / notes separation

font theme token resolution

section / layout XML manipulation

hidden slide cleanup

COM Automation editing rules

RefURL placement and hyperlink auditing

file-lock workaround and post-processing

16:9 centering issues

template corruption recovery

video embedding via ZIP direct manipulation

Done Criteria

source と goal が固定されている

content.json を正として各フェーズが分離されている

template / layout の前提が確認できている

technical content は一次情報確認が済んでいる

operational text がスライド面に出ていない

template 利用時は単調な同一レイアウト反復と余剰 placeholder を確認している

visual QA はレンダー画像で行い、修正後に該当スライドを再確認している

表は本文 16pt 以上を原則とし、header は中央揃え・中段揃えで視認性を確認している

build 後に overflow / consistency / hyperlink をレビューできている