PowerPoint Default Active

.pptx create, edit, analyze — from single-slide fixes to full investor decks with morph transitions and data-driven generation.

Trigger Keywords

Quick Reference

"~해줘" Examples

Natural language requests that activate this skill. Works in Korean, English, or mixed.

Primary Tool: OfficeCLI

officecli handles approximately 80% of PPTX tasks: slide add/set/remove, validation, queries, and visual inspection. It is the primary interface — always try OfficeCLI first before escalating to other tools.

Discovery Rule

officecli --help
officecli help pptx
officecli help pptx add slide --json       # exact property list
officecli help pptx add shape --json
officecli help pptx set slide --json
officecli help pptx set shape --json
officecli view --help                      # all view modes
officecli help pptx query

Core Workflows

Reading & Analyzing

# Text extraction
officecli view slides.pptx text
officecli view slides.pptx text --start 1 --end 5

# Structural views
officecli view slides.pptx outline
officecli view slides.pptx annotated
officecli view slides.pptx stats

Element Inspection (PATH Syntax)

Paths are 1-based: /slide[1], /shape[1]. Always quote paths in zsh to prevent glob expansion.

officecli get slides.pptx '/slide[1]' --depth 1
officecli get slides.pptx '/slide[1]/shape[1]'
officecli get slides.pptx '/slide[1]/chart[1]'
officecli get slides.pptx '/slide[1]/table[1]' --depth 3

CSS-like Queries

officecli query slides.pptx 'shape:contains("Revenue")'
officecli query slides.pptx "picture:no-alt"
officecli query slides.pptx 'shape[fill=#4472C4]'
officecli query slides.pptx "shape[width>=10cm]"

Visual Inspection

officecli view slides.pptx html --browser    # recommended
officecli view slides.pptx svg --start 1 --end 1 --browser

Resident Mode

Resident mode keeps the file open as a background daemon for faster sequential edits. The open command returns immediately — do not run it as a background shell job.

officecli open slides.pptx      # returns IMMEDIATELY; daemon in bg
officecli add slides.pptx ...
officecli set slides.pptx ...
officecli close slides.pptx     # always close explicitly

Batch Mode

Execute multiple operations in a single call using JSON. Use a heredoc with single-quoted delimiter to prevent shell syntax leaking into JSON.

cat <<'EOF' | officecli batch slides.pptx
[
  {"command":"add","parent":"/slide[1]","type":"shape","props":{"text":"Title","x":"2cm","y":"2cm","width":"20cm","height":"3cm","size":"36","bold":"true"}},
  {"command":"add","parent":"/slide[1]","type":"shape","props":{"text":"Body","x":"2cm","y":"6cm","width":"20cm","height":"10cm","size":"16"}}
]
EOF

Batch supports: add, set, get, query, remove, move, swap, view, raw, raw-set, validate.

Reference-Based Editing

When the user provides a source file or says "format like X.pptx" — always start from the source. Never rebuild themes from scratch.

Why This Matters

Slide master and theme definitions (fonts, colors, placeholder geometry) are document-specific. Recreating them from scratch loses consistent branding across slides, breaks existing placeholder positions, and takes 5-10x longer than modifying a copy.

Workflow

1. Copy the source: cp source.pptx target.pptx — inherits theme, slide masters, layouts, fonts, colors
2. Open: officecli open target.pptx — daemon returns immediately
3. Remove slide content but keep /slideMaster, /slideLayout, /theme
4. Add new slides using existing layouts (--prop layout=Title+Content) — they auto-inherit theme

Template Sources (Priority Order)

Example — Inherit Existing Brand

# CORRECT: inherit theme and layouts
cp CompanyBrand.pptx Q4Report.pptx
officecli open Q4Report.pptx
officecli remove Q4Report.pptx "/slide[1]"
officecli add Q4Report.pptx / --type slide --prop layout=Title
officecli add Q4Report.pptx '/slide[1]' --type textbox \
  --prop text="Q4 Report" --prop placeholder=title
officecli close Q4Report.pptx

# WRONG: recreate theme (loses brand)
officecli create Q4Report.pptx
# ... add all fonts, colors, masters from scratch ...

Creation Workflow

# 1. Work in /tmp/ with ASCII filenames (Korean filenames cause resident corruption)
officecli create /tmp/deck_work.pptx --type pptx

# 2. Add slide, set background, add shapes/textboxes/charts
officecli add /tmp/deck_work.pptx /slide --type slide
officecli set /tmp/deck_work.pptx '/slide[1]' --prop background=1E2761
officecli add /tmp/deck_work.pptx '/slide[1]' --type textbox \
  --prop 'text=Title Here' --prop x=2cm --prop y=3cm --prop w=30cm --prop h=4cm \
  --prop fontsize=44 --prop bold=true --prop color=FFFFFF --prop fontFamily=Pretendard

# 3. Explicitly close resident after edits
officecli close /tmp/deck_work.pptx

# 4. Copy to final filename (Korean OK for final output)
python3 -c "import shutil; shutil.copy2('/tmp/deck_work.pptx', 'final.pptx')"

Escalation Ladder

When OfficeCLI cannot do the job, escalate in order. Most tasks stay at L1.

Escalation Signals

• officecli shows "silently ignored" or unsupported prop → L2
• Need morph/custom transitions beyond high-level → L4
• Bulk generation from data (50+ slides) → L5 (pptxgenjs)
• Unpacked workflow for cleanup/reorg → L3 (pptx_cli.py clean)
• Design pick (color, font, style) → Read references/design-system.md + morph-ppt/reference/styles/INDEX.md first

Element Types & Commands

OfficeCLI supports a rich set of element types. Use these actively — text-only slides are forgettable.

Shapes as Content Containers

officecli add deck.pptx '/slide[1]' --type shape --prop geometry=roundRect \
  --prop fill=1E2761 --prop x=1cm --prop y=4cm --prop w=15cm --prop h=12cm

Tables

officecli add deck.pptx '/slide[2]' --type table \
  --prop rows=4 --prop cols=3 --prop x=1cm --prop y=3cm \
  --prop width=24cm --prop height=6cm

Charts

officecli add deck.pptx '/slide[3]' --type chart \
  --prop chartType=column --prop title='Revenue' \
  --prop 'data=Q1:12,Q2:15,Q3:18,Q4:20'

Pictures

officecli add deck.pptx '/slide[1]' --type picture \
  --prop path=photo.png --prop x=14cm --prop y=3cm \
  --prop width=8cm --prop height=5cm --prop alt='Team photo'

Video / Audio

officecli add deck.pptx '/slide[4]' --type video --prop path=demo.mp4 \
  --prop x=2cm --prop y=3cm --prop width=20cm --prop height=12cm --prop autoplay=true

OLE Embed (Excel, Word, PDF)

officecli add deck.pptx '/slide[5]' --type ole --prop path=data.xlsx \
  --prop x=2cm --prop y=3cm --prop width=20cm --prop height=12cm

Connectors / Arrows

officecli add deck.pptx '/slide[2]' --type connector \
  --prop startShape=1 --prop endShape=2 --prop lineColor=4472C4 --prop tailEnd=arrow

Speaker Notes

officecli add deck.pptx '/slide[1]' --type notes --prop 'text=Key talking point here.'

Animations

officecli set deck.pptx '/slide[1]/shape[2]' --prop animation=fadeIn --prop delay=500

Theme Colors

# Use theme tokens instead of hex for theme-aware decks
officecli set deck.pptx '/slide[1]/shape[1]' --prop fill=accent1
# Available: accent1..accent6, dk1, dk2, lt1, lt2, tx1, tx2, bg1, bg2

Additional Operations

# Hyperlinks
officecli set deck.pptx '/slide[1]/shape[2]' --prop link='https://example.com'

# Flip / rotate
officecli set deck.pptx '/slide[1]/shape[2]' --prop flipH=true
officecli set deck.pptx '/slide[1]/shape[2]' --prop rotation=45

# Slide master / layout editing
officecli set deck.pptx '/slideMaster[1]/shape[2]' --prop text='Company Name'
officecli set deck.pptx '/slideLayout[2]/shape[1]' --prop fill=1E2761

# Template merge with data
officecli merge template.pptx output.pptx --data '{"title":"Q4 Report","revenue":"$5.1M"}'

# Watch mode (live preview)
officecli watch deck.pptx --port 3000

# Slideshow settings
officecli set deck.pptx / --prop show.loop=true --prop show.narration=false

Design System

Design Dials

Before creating, decide these three parameters. Present to user if ambiguous.

Presets by Deck Type

Recommended Palettes

Choose colors that match your topic — don't default to generic blue.

Use Text for body copy on light backgrounds, Muted for captions, labels, and axis text. On dark backgrounds (brightness < 30%), all body text must be white (FFFFFF) or near-white. Off-black: 0A0A0A not 000000.

Typography

Korean: Pretendard, Noto Sans KR, Wanted Sans. Avoid Malgun Gothic as sole font — acceptable only as CJK fallback in a:ea font stack.

Slide Rhythm

A 10-slide deck should have at minimum 4 distinct layout types:

1. Full-bleed hero — title or key metric
2. Split layout — text + visual
3. Grid or comparison — 2–3 items
4. Data visualization — chart, diagram, or infographic

Content-to-Layout Guide

Subskills

Load only the one subskill matching your task. Do not load all of them.

Reference Materials

Design References

Python Scripts (scripts/)

QA (Required)

Step 1 — Machine QA

officecli validate output.pptx
officecli view output.pptx issues
officecli view output.pptx text | grep -iE 'xxxx|lorem|ipsum|placeholder|TODO|click to'
officecli view output.pptx stats

Step 2 — Visual QA

officecli view output.pptx html --browser

# Thumbnail grid for quick scan
python3 scripts/thumbnail.py output.pptx grid.png

Use subagents for visual inspection — even for 2–3 slides. You will see what you expect, not what is actually there. Fresh eyes catch more bugs.

Visual QA Checklist

• Overlapping elements (text through shapes, stacked elements)
• Text overflow or cut off at box boundaries
• Elements too close (< 0.3" gaps) or nearly touching
• Uneven gaps (large empty area vs cramped)
• Insufficient margin from slide edges (< 0.5")
• Columns or similar elements not aligned
• Low-contrast text or icons
• Leftover placeholder content
• Text boxes too narrow causing excessive wrapping

Step 3 — Fix and Re-verify

Fix with officecli set, rerun QA. Do not declare success until you have completed at least one fix-and-verify cycle.

Pre-Delivery Checklist

• Speaker notes on all content slides
• At least one transition style applied
• Alt text on all pictures: officecli query deck.pptx 'picture:no-alt'
• Layout variety ≥ 3 types across slides
• No overflow: y + height ≤ 19.05cm, x + width ≤ 33.87cm
• No placeholder text remaining
• Body text ≥ 16pt everywhere
• Chart titles contain actual values (no TBD, empty parens)

Common Pitfalls

Anti-Patterns

• Never use example data from subskill files (FitPulse, LearnFlow, etc.)
• Never leave placeholder text: lorem, ipsum, XXXX, TODO
• Every slide must have a title (accessibility)
• Speaker notes on all content slides
• Max 2 font families per deck
• Malgun Gothic as sole font = rejected
• view issues "(untitled)" for blank-layout is expected, not a defect
• Accent lines under titles — hallmark of AI-generated slides; use whitespace instead
• Decorative web-UI elements (thin sidebar lines, ornamental circles) — PPT is a projector medium, not a web app
• Same layout on every slide — vary columns, cards, callouts
• Center-aligned body text — left-align paragraphs; center only titles
• Insufficient size contrast — titles 36pt+ vs body 16pt
• Text-only slides — add shapes, charts, color blocks, pictures

Accessibility (WCAG 2.1 AA)

• Every slide has a title: officecli view deck.pptx outline
• Alt text on images: officecli query deck.pptx 'picture:no-alt'
• Reading order = shape order (title first)
• Contrast ≥ 4.5:1 normal, ≥ 3:1 large
• Information not conveyed by color alone

CJK / Korean Support

The cli-jaw fork auto-detects Korean content and applies language tags + default fonts. Use ASCII filenames during resident mode editing to avoid UTF-8 corruption; copy to Korean filenames as a final step.

Prerequisites

# Check prerequisites
python3 -c "import pptx" || echo "MISSING: pip install python-pptx"
which officecli >/dev/null 2>&1 || echo "INFO: OfficeCLI not installed"
which soffice >/dev/null 2>&1 || echo "INFO: LibreOffice not installed (optional)"