pptx-formatter — fix only what was pointed out, proof the rest

First-run setup (once)

1. WSL + PowerPoint: powershell.exe -NoProfile -Command '$env:TEMP' must print a path, and desktop PowerPoint must be installed on Windows. Otherwise stop and say so.
2. Python: needs lxml and Pillow (pip install lxml Pillow). Ask which Python to use and remember it.
3. Author name: ask the user for the name to put in the file's "creator / last modified by", then write config.local.json next to this SKILL.md: {"author": "Their Name"}. It is git-ignored and stays on this machine.
4. House font rule: ask once. The default this skill was built with is "Latin letters and digits = Arial, always. Korean = one font per deck, chosen with the user for each deck". Remember the answer.

Ground rules

• Fix only what the user points out (slide number + what to change). Report every other problem and fix it only when the user says to ("고칠만한 건 고쳐", "fix what's worth fixing").
• Never touch animations. Run ppt_diff.py after every change. It must print OK.
• Keep the original and save <name>_fmt.pptx (a later round on the same original becomes _fmt2). If the deck came from a cloud drive, put the result back in the same folder.
• One folder per requested deck: <YYMMDD>_<name>/ with orig/ (as received), work/ (dumps, renders, the job's own step scripts), out/ (deliverable) and preproof.md (report).
• Judge layout only from PowerPoint-rendered PNGs (ppt_render.sh), never LibreOffice.
• Edit the zip's XML directly (scripts below). Do not open the deck in PowerPoint and re-save it: that rewrites every part.

Workflow

S=~/.claude/skills/pptx-formatter/scripts; PY=python   # the Python chosen at setup
# 0. fetch: copy the deck into <job>/orig/ (cloud drive: use the user's sync/pull tool)
$S/ppt_dump.sh orig/x.pptx work/orig.json                       # effective formatting, read-only
$PY $S/ppt_audit.py work/orig.json --ea "<Korean font>" -o work/audit_orig.md
$S/ppt_render.sh orig/x.pptx work/render_orig                    # look before touching anything
# 1. fix what was pointed out (tools below, or a small step script in work/ for deck-specific edits)
$PY $S/ppt_meta.py work/fmt.pptx                                 # creator = configured author
# 2. verify — all three, every time
$PY $S/ppt_diff.py orig/x.pptx work/fmt.pptx --allow <slides you meant to change>
$S/ppt_dump.sh work/fmt.pptx work/fmt.json && $PY $S/ppt_audit.py work/fmt.json --before work/orig.json --ea "<font>" -o work/audit.md
$S/ppt_render.sh work/fmt.pptx work/render_fmt                   # compare changed slides side by side
# 3. deliver out/<name>_fmt.pptx + preproof.md: what was fixed, what is reported only, evidence

Slide numbers in every tool are the 1-based order in the file (cover included), not the printed page number.

Scripts

Common requests:

• Page numbers counted from the cover → add firstSlideNum="0" on <p:presentation>.
• The page-number box usually lives in a slide layout, not on the slides.
• A hard-coded total ("‹#›/30") is a plain run next to the field.

Problems already solved — read before fixing

references/troubleshooting.md holds every problem met so far, with its cause and fix. Highlights: the "restricted font" warning, Korean words broken mid-word because a run has no lang, line breaks that move after a font change, bold leaking across a run, and shapes that look overlapped only because of animations. Whenever a new problem appears while fixing a deck, add a dated row there (and in the user's own notes if they keep any).