AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He
feat(export): default per-element entrance animation off, keep page transitions
hugohe31df3d2e65612
diff --git a/AGENTS.md b/AGENTS.mdindex 8c674e55..c75e5632 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -24,7 +24,7 @@ PPT Master is an AI-driven presentation generation system. Multi-role collaborat>> Recorded narration / video export: run the standalone [`generate-audio`](skills/ppt-master/workflows/generate-audio.md) workflow after post-processing.>-> Object-level animation tuning: when the user asks to change animation order, effect, timing, or a specific object's reveal behavior, run the standalone [`customize-animations`](skills/ppt-master/workflows/customize-animations.md) workflow. Default export already has global animations; do not create `animations.json` unless customization was requested.+> Object-level animation tuning: when the user asks to change animation order, effect, timing, or a specific object's reveal behavior, run the standalone [`customize-animations`](skills/ppt-master/workflows/customize-animations.md) workflow. Default export applies page transitions but no per-element entrance animation (element builds are opt-in); create `animations.json` or pass `-a auto` only when the user asks for element animation or object-level customization.>> Live preview: any time the user mentions "live preview", "preview", "看效果", or wants to click/select a slide element, run [`live-preview`](skills/ppt-master/workflows/live-preview.md). Step 6 auto-starts it during generation; the workflow covers post-export re-entry and applying submitted annotations.>diff --git a/CLAUDE.md b/CLAUDE.mdindex 87f25d0b..79eec182 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -24,7 +24,7 @@ PPT Master is an AI-driven presentation generation system. Multi-role collaborat>> Recorded narration / video export: run the standalone [`generate-audio`](skills/ppt-master/workflows/generate-audio.md) workflow after post-processing.>-> Object-level animation tuning: when the user asks to change animation order, effect, timing, or a specific object's reveal behavior, run the standalone [`customize-animations`](skills/ppt-master/workflows/customize-animations.md) workflow. Default export already has global animations; do not create `animations.json` unless customization was requested.+> Object-level animation tuning: when the user asks to change animation order, effect, timing, or a specific object's reveal behavior, run the standalone [`customize-animations`](skills/ppt-master/workflows/customize-animations.md) workflow. Default export applies page transitions but no per-element entrance animation (element builds are opt-in); create `animations.json` or pass `-a auto` only when the user asks for element animation or object-level customization.>> Live preview: any time the user mentions "live preview", "preview", "看效果", or wants to click/select a slide element, run [`live-preview`](skills/ppt-master/workflows/live-preview.md). Step 6 auto-starts it during generation; the workflow covers post-export re-entry and applying submitted annotations.>diff --git a/docs/faq.md b/docs/faq.mdindex 0036e2ad..d1cd3b7a 100644--- a/docs/faq.md+++ b/docs/faq.md@@ -87,14 +87,14 @@ If your workflow specifically requires Excel-driven data editing, manually creat## Q: Can I change page transitions and element animations?-Yes. Page transitions (`fade` 0.4s by default) and per-element entrance animations (`auto` effect with `after-previous` cascade by default — effect mapped from each group's SVG id, with image-like ids cycling a visual pool for variation) are both controlled by `svg_to_pptx.py` flags — `-t/--transition` for page-level and `-a/--animation` for element-level. Common one-liners:+Yes. Page transitions are on by default (`fade` 0.4s); per-element entrance animation is **off by default** — a page appears as a whole instead of having elements auto-cascade in one by one (that unsolicited cascade is the strongest "AI deck" tell). Both are controlled by `svg_to_pptx.py` flags — `-t/--transition` for page-level and `-a/--animation` for element-level. Turn element animation on explicitly when you want it:```bashpython3 skills/ppt-master/scripts/svg_to_pptx.py <project> -t push # different transitionpython3 skills/ppt-master/scripts/svg_to_pptx.py <project> -t none # disable transitions-python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -a none # disable per-element animation-python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade # use a single effect instead of mixed-python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation-trigger on-click # presenter-paced reveals+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -a auto # enable per-element entrance (effect mapped from group id)+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade # enable with a single effect+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -a auto --animation-trigger on-click # presenter-paced reveals````on-click` is for live presentations. Narrated/video export via `--recorded-narration` rejects it because PPT Master writes page timings, not object-level click timings; use `after-previous` or `with-previous` for narrated decks.diff --git a/docs/zh/animations.md b/docs/zh/animations.mdindex d791f471..6f3433c8 100644--- a/docs/zh/animations.md+++ b/docs/zh/animations.md@@ -7,13 +7,13 @@ PPT Master 导出的 PPTX 同时支持**页间转场**(page transition)与**| 层级 | 默认 | 原因 ||---|---|---|| 页间转场 | `fade`,0.4 秒 | 适合大多数 deck 的中性基线 |-| 页内元素动画 | `auto` 效果 + `after-previous` 触发,0.4 秒时长 + 0.5 秒间隔 | 根据每个 group 的 SVG id 映射效果:信息密集元素稳定映射(chart→wipe、card-/step-/pillar-→fly、title/takeaway→fade),图片类 id(`hero` / `figure-` / `image` / `img-` / `kpi`)在更丰富的视觉池(zoom / dissolve / circle / box / diamond / wheel)中循环以产生 deck 内变化,未命中的 id 在 fade/wipe/fly/zoom 间循环。进入页面后元素自动级联入场,零交互即可看到完整动画过程 |+| 页内元素动画 | **`none`(关闭)** | 翻到一页时整页一次性呈现。元素一个个自动级联出来是「AI 味」最重的信号,且没人主动要,所以页内动画改为按需开启。用 `-a auto`(或其它效果)开启:根据每个 group 的 SVG id 映射效果(chart→wipe、card-/step-/pillar-→fly、title/takeaway→fade),图片类 id(`hero` / `figure-` / `image` / `img-` / `kpi`)在更丰富的视觉池(zoom / dissolve / circle / box / diamond / wheel)中循环以产生 deck 内变化,未命中的 id 在 fade/wipe/fly/zoom 间循环 |-修改设置只需对同一份 `svg_output/`(或 `svg_final/`)重跑 `svg_to_pptx.py`,无需重新跑 LLM。如要彻底关闭页内动画,加 `-a none`。+修改设置只需对同一份 `svg_output/`(或 `svg_final/`)重跑 `svg_to_pptx.py`,无需重新跑 LLM。如要为整份 deck 开启页内动画,加 `-a auto`。## 对象级自定义动画-默认动画是全局策略。若需要更具体的演示节奏,例如标题先淡入、图表第二个出现、关键注释最后飞入,可以使用可选的 `animations.json` sidecar。SVG 仍然只保存静态视觉结构;sidecar 只控制 PPTX 导出动画。+页内元素动画默认关闭。为整份 deck 开启只需导出时加 `-a auto`(无需配置文件)。若需要更具体的演示节奏,例如标题先淡入、图表第二个出现、关键注释最后飞入,可以使用可选的 `animations.json` sidecar。SVG 仍然只保存静态视觉结构;sidecar 只控制 PPTX 导出动画。当用户要求调整动画顺序、效果、时长或具体对象出现方式时,运行独立 [`customize-animations`](../../skills/ppt-master/workflows/customize-animations.md) 工作流。@@ -79,24 +79,24 @@ python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --auto-advance 5## 页内元素动画-默认开启(`auto` 效果 + `after-previous` 触发)。共有三种 Start 模式,**与 PowerPoint 动画窗格的 Start 下拉菜单一一对应**:+默认关闭——用 `-a auto`(或其它效果)为整份 deck 开启。开启后共有三种 Start 模式,**与 PowerPoint 动画窗格的 Start 下拉菜单一一对应**:- **`on-click`**(单击时)—— 进入页面 → 第一次点击显示第一个语义组,后续每次点击按 z-order 显示下一个组。适合现场演讲,演讲者控制节奏。与 `--recorded-narration` 互斥,因为带旁白的视频导出需要无点击播放。- **`with-previous`**(与上一动画同时)—— 所有组在进入页面时一起入场,并行播放各自的入场动画。`--animation-stagger` 不生效。- **`after-previous`**(默认,在上一动画之后)—— 第一组进入页面时入场,后续组在前一个结束后接着出现,并按 `--animation-stagger` 增加额外间隔。适合展厅循环、录屏走查,或者只是想看流动效果不想点击。```bash-# 默认即开启:auto 效果 + after-previous 触发,无需任何参数+# 默认行为(无参数):只有页间转场,没有页内元素动画python3 skills/ppt-master/scripts/svg_to_pptx.py <project>-# 关闭页内动画-python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -a none+# 为整份 deck 开启页内动画(auto 效果 + after-previous 自动级联)+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -a auto-# 改用单一效果(仍走默认的 after-previous 自动级联)+# 开启并改用单一效果(走 after-previous 自动级联)python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade-# 改为单击触发(演讲者控制节奏)-python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation-trigger on-click+# 开启并改为单击触发(演讲者控制节奏)+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -a auto --animation-trigger on-click# 自定义节奏python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation mixed \@@ -108,7 +108,7 @@ python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation-trigger w22 种单一效果:`appear`、`fade`、`fly`、`cut`、`zoom`、`wipe`、`split`、`blinds`、`checkerboard`、`dissolve`、`random_bars`、`peek`、`wheel`、`box`、`circle`、`diamond`、`plus`、`strips`、`wedge`、`stretch`、`expand`、`swivel`。再加三种自动模式:-- `auto`(默认)—— 按 group 的 SVG id 映射效果。信息密集元素稳定映射:`chart` / `table` / `legend` / `timeline` / `track` → `wipe`;`card-*` / `pillar-*` / `item-*` / `step-*` / `stage-*` / `tier-*` / `principle-*` → `fly`;`title` / `chapter-*` / `section-*` / `cover-*` / `tagline` / `subtitle` → `fade`;`takeaway` / `callout` / `quote` / `source` / `conclusion` / `note` → `fade`。图片类 id `hero` / `figure-*` / `image` / `img-*` / `kpi` 则在更丰富的视觉池(`zoom` / `dissolve` / `circle` / `box` / `diamond` / `wheel`)中循环,使多张图片在 deck 内呈现不同入场。未命中的 id 在 `fade` / `wipe` / `fly` / `zoom` 之间循环。+- `auto`(开启时推荐)—— 按 group 的 SVG id 映射效果。信息密集元素稳定映射:`chart` / `table` / `legend` / `timeline` / `track` → `wipe`;`card-*` / `pillar-*` / `item-*` / `step-*` / `stage-*` / `tier-*` / `principle-*` → `fly`;`title` / `chapter-*` / `section-*` / `cover-*` / `tagline` / `subtitle` → `fade`;`takeaway` / `callout` / `quote` / `source` / `conclusion` / `note` → `fade`。图片类 id `hero` / `figure-*` / `image` / `img-*` / `kpi` 则在更丰富的视觉池(`zoom` / `dissolve` / `circle` / `box` / `diamond` / `wheel`)中循环,使多张图片在 deck 内呈现不同入场。未命中的 id 在 `fade` / `wipe` / `fly` / `zoom` 之间循环。- `mixed`(旧逻辑)—— 确定性轮换。每页第一个动画组使用 `fade`,后续组在整份 deck 范围内按 16 效果池(`blinds` / `checkerboard` / `dissolve` / `fly` / `cut` / `random_bars` / `box` / `split` / `strips` / `wedge` / `wheel` / `wipe` / `expand` / `fade` / `swivel` / `zoom`)连续轮换。保留以兼容旧配置。- `random` —— 在旧的 16 效果池中随机抽取。@@ -116,7 +116,7 @@ python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation-trigger w参数:-- `-a/--animation` — 效果名、`auto`、`mixed`、`random` 或 `none`。默认 `auto`。+- `-a/--animation` — 效果名、`auto`、`mixed`、`random` 或 `none`。默认 `none`(页内动画关闭;用 `auto` 开启)。- `--animation-trigger` — Start 模式(与 PowerPoint 一致):`on-click`、`with-previous`、`after-previous`(默认)。- `--animation-duration` — 单个元素入场秒数,默认 `0.4`。- `--animation-stagger` — `after-previous` 模式下两组之间的额外间隔(秒,默认 `0.5`)。其他模式忽略。diff --git a/docs/zh/faq.md b/docs/zh/faq.mdindex 492d584f..e34e7443 100644--- a/docs/zh/faq.md+++ b/docs/zh/faq.md@@ -87,14 +87,14 @@ PPT Master 本身免费开源,唯一的成本来自你自己的 AI 模型用## Q: 页面切换和元素动画可以调吗?-可以。页间转场(默认 `fade` 0.4s)和页内元素入场动画(默认 `auto` 效果 + `after-previous` 自动级联,根据每个 group 的 SVG id 自动映射效果——图片类 id 在视觉池中循环以产生 deck 内变化)都通过 `svg_to_pptx.py` 的参数控制——`-t/--transition` 控制页级,`-a/--animation` 控制元素级。常用一行命令:+可以。页间转场默认开(`fade` 0.4s),页内元素入场动画**默认关**——翻到一页时整页一次性呈现,不会有元素一个个自动级联出来(那种没人要的自动连播正是「AI 味」最重的地方)。两者都通过 `svg_to_pptx.py` 的参数控制——`-t/--transition` 控制页级,`-a/--animation` 控制元素级。想要页内动画时显式开启即可:```bashpython3 skills/ppt-master/scripts/svg_to_pptx.py <project> -t push # 换转场效果python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -t none # 关闭转场-python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -a none # 关闭页内动画-python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade # 改用单一效果(仍是默认级联)-python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation-trigger on-click # 改为单击触发,演讲者控制节奏+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -a auto # 开启页内元素入场(按 group id 自动映射效果)+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade # 开启并改用单一效果+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -a auto --animation-trigger on-click # 单击触发,演讲者控制节奏````on-click` 适合现场演示。通过 `--recorded-narration` 做旁白/视频导出时会拒绝它,因为 PPT Master 只写页面级计时,不生成对象级点击计时;带旁白的 deck 请使用 `after-previous` 或 `with-previous`。diff --git a/skills/ppt-master/SKILL.md b/skills/ppt-master/SKILL.mdindex 69a5bf68..1652fc9c 100644--- a/skills/ppt-master/SKILL.md+++ b/skills/ppt-master/SKILL.md@@ -546,16 +546,16 @@ python3 ${SKILL_DIR}/scripts/svg_to_pptx.py <project_path>> layout-tight page must keep every dy-stacked line as its own text frame. The> merge detector is conservative; mixed-layout text falls back to per-line frames.-**Optional animation flags** (the defaults already enable rich entrance animations — adjust only when the user asks for something different):+**Optional animation flags** (page transitions are on by default; per-element entrance is off by default — turn it on only when the user asks for it):- `-t <effect>` — page transition. Default `fade`. Options: `fade` / `push` / `wipe` / `split` / `strips` / `cover` / `random` / `none`.-- `-a <effect>` — per-element entrance animation. Default `auto` (map effect from group id: chart→wipe, card-/step-/pillar-→fly, title/takeaway→fade; image-like ids `hero` / `figure-` / `image` / `img-` / `kpi` cycle a richer pool — zoom / dissolve / circle / box / diamond / wheel — so multiple images vary across the deck). Pass `none` to disable, a specific effect like `fade`, or `mixed` for the legacy 16-effect cycle. Requires top-level `<g id="...">` groups (already required by Executor).+- `-a <effect>` — per-element entrance animation. **Default `none`** — pages appear as a whole, no auto-firing element builds (the unsolicited cascade reads as the "AI deck" tell). Opt in with `auto` (map effect from group id: chart→wipe, card-/step-/pillar-→fly, title/takeaway→fade; image-like ids `hero` / `figure-` / `image` / `img-` / `kpi` cycle a richer pool — zoom / dissolve / circle / box / diamond / wheel — so multiple images vary across the deck), a specific effect like `fade`, or `mixed` for the legacy 16-effect cycle. Requires top-level `<g id="...">` groups (already required by Executor).- `--animation-trigger {on-click,with-previous,after-previous}` — Start mode (matches PowerPoint's animation-pane Start dropdown). Default `after-previous` (click-free cascade; pace via `--animation-stagger`). Use `on-click` for presenter-paced reveals, or `with-previous` for all-at-once.- `--animation-config <path>` — optional object-level sidecar. Default: `<project_path>/animations.json` when present.- `--auto-advance <seconds>` — kiosk-style auto-play.**Optional custom animations** (only when the user asks to tune animation order/effects/timing for specific objects):-Run the standalone [`customize-animations`](workflows/customize-animations.md) workflow. Default export already has global entrance animation; do not create `animations.json` unless object-level customization was requested.+Run the standalone [`customize-animations`](workflows/customize-animations.md) workflow. Default export applies page transitions but no per-element entrance animation; create `animations.json` (or pass `-a auto`) only when the user asks for element animation or object-level customization.**Optional recorded narration** (only when the user asks for narrated/video export):diff --git a/skills/ppt-master/references/animations.md b/skills/ppt-master/references/animations.mdindex 936d2c65..091c17fc 100644--- a/skills/ppt-master/references/animations.md+++ b/skills/ppt-master/references/animations.md@@ -7,13 +7,13 @@ PPT Master's exported PPTX supports **page transitions** (slide-to-slide) and **| Layer | Default | Why ||---|---|---|| Page transition | `fade`, 0.4s | Calm baseline that suits most decks |-| Per-element animation | `auto` effect + `after-previous` trigger, 0.4s duration + 0.5s stagger | Effects are mapped from group id (chart→wipe, card-/step-/pillar-→fly, title/takeaway→fade); image-like ids (`hero` / `figure-` / `image` / `img-` / `kpi`) cycle a richer visual pool (zoom / dissolve / circle / box / diamond / wheel) so multiple images vary across the deck; unmatched ids cycle a small fade/wipe/fly/zoom pool. Cascades automatically on slide entry — zero interaction |+| Per-element animation | **`none` (off)** | A page appears as a whole. Auto-firing element builds are an unsolicited "AI deck" tell, so element entrance is opt-in. Turn it on with `-a auto` (or another effect): effects map from group id (chart→wipe, card-/step-/pillar-→fly, title/takeaway→fade); image-like ids (`hero` / `figure-` / `image` / `img-` / `kpi`) cycle a richer visual pool (zoom / dissolve / circle / box / diamond / wheel) so multiple images vary across the deck; unmatched ids cycle a small fade/wipe/fly/zoom pool |-To regenerate a deck with different settings, rerun `svg_to_pptx.py` against the same `svg_output/` (or `svg_final/`) — no need to rerun the LLM. To turn per-element animation off entirely, pass `-a none`.+To regenerate a deck with different settings, rerun `svg_to_pptx.py` against the same `svg_output/` (or `svg_final/`) — no need to rerun the LLM. To turn per-element animation on for the whole deck, pass `-a auto`.## Custom Object-Level Animation-Default animation is global. When a deck needs specific object timing — for example title first, chart second, annotation last — use the optional `animations.json` sidecar. The SVG remains static visual source; the sidecar only controls PPTX export behavior.+Per-element animation is off by default. To enable it deck-wide, pass `-a auto` at export (no config needed). When a deck instead needs specific object timing — for example title first, chart second, annotation last — use the optional `animations.json` sidecar. The SVG remains static visual source; the sidecar only controls PPTX export behavior.Run the standalone [`customize-animations`](../workflows/customize-animations.md) workflow when the user asks to tune animation order, effects, timing, or object-level reveals.@@ -79,24 +79,24 @@ Flags:## Per-Element Animations-Enabled by default (`auto` effect + `after-previous` trigger). Three Start modes are available — these mirror PowerPoint's animation-pane "Start" dropdown:+Off by default — enable deck-wide with `-a auto` (or another effect). Once enabled, three Start modes are available — these mirror PowerPoint's animation-pane "Start" dropdown:- **`on-click`** — entering a slide → first click reveals the first semantic group; each subsequent click reveals the next group in z-order. Suits live presentations where the speaker paces reveals. Forbidden with `--recorded-narration` because video-ready exports need click-free playback.- **`with-previous`** — all groups start together on slide entry, playing their entrance animation in parallel. Stagger ignored.- **`after-previous`** (default) — first group fires on slide entry, subsequent groups cascade after the previous one finishes, with `--animation-stagger` extra spacing. Suits kiosk playback, recorded walkthroughs, or anyone who wants visual flow without clicking.```bash-# Default behavior (no flags needed): auto effect + after-previous cascade+# Default behavior (no flags): page transitions only, no per-element buildspython3 skills/ppt-master/scripts/svg_to_pptx.py <project>-# Disable per-element animation entirely-python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -a none+# Enable per-element animation deck-wide (auto effect + after-previous cascade)+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -a auto-# Use a single effect (still cascades via the default after-previous trigger)+# Enable with a single effect (cascades via the after-previous trigger)python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade-# Switch to on-click for live presentations (presenter controls pacing)-python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation-trigger on-click+# Enable and switch to on-click for live presentations (presenter controls pacing)+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -a auto --animation-trigger on-click# Custom pacingpython3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation mixed \@@ -108,7 +108,7 @@ python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation-trigger w22 single effects: `appear`, `fade`, `fly`, `cut`, `zoom`, `wipe`, `split`, `blinds`, `checkerboard`, `dissolve`, `random_bars`, `peek`, `wheel`, `box`, `circle`, `diamond`, `plus`, `strips`, `wedge`, `stretch`, `expand`, `swivel`. Plus three auto-vary modes:-- `auto` (default) — map effect from the group's SVG id. Information-dense elements get a single stable effect: `chart` / `table` / `legend` / `timeline` / `track` → `wipe`; `card-*` / `pillar-*` / `item-*` / `step-*` / `stage-*` / `tier-*` / `principle-*` → `fly`; `title` / `chapter-*` / `section-*` / `cover-*` / `tagline` / `subtitle` → `fade`; `takeaway` / `callout` / `quote` / `source` / `conclusion` / `note` → `fade`. Image-like ids `hero` / `figure-*` / `image` / `img-*` / `kpi` instead cycle a richer visual pool (`zoom` / `dissolve` / `circle` / `box` / `diamond` / `wheel`) so multiple images vary across the deck. Unmatched ids cycle through `fade` / `wipe` / `fly` / `zoom`.+- `auto` (recommended when enabling) — map effect from the group's SVG id. Information-dense elements get a single stable effect: `chart` / `table` / `legend` / `timeline` / `track` → `wipe`; `card-*` / `pillar-*` / `item-*` / `step-*` / `stage-*` / `tier-*` / `principle-*` → `fly`; `title` / `chapter-*` / `section-*` / `cover-*` / `tagline` / `subtitle` → `fade`; `takeaway` / `callout` / `quote` / `source` / `conclusion` / `note` → `fade`. Image-like ids `hero` / `figure-*` / `image` / `img-*` / `kpi` instead cycle a richer visual pool (`zoom` / `dissolve` / `circle` / `box` / `diamond` / `wheel`) so multiple images vary across the deck. Unmatched ids cycle through `fade` / `wipe` / `fly` / `zoom`.- `mixed` (legacy) — deterministic. The first animated group on each slide uses `fade`; later groups cycle through a 16-effect pool (`blinds` / `checkerboard` / `dissolve` / `fly` / `cut` / `random_bars` / `box` / `split` / `strips` / `wedge` / `wheel` / `wipe` / `expand` / `fade` / `swivel` / `zoom`) across the deck. Kept for backward compatibility.- `random` — samples from the legacy 16-effect pool.@@ -116,7 +116,7 @@ python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation-trigger wFlags:-- `-a/--animation` — effect name, `auto`, `mixed`, `random`, or `none`. Default: `auto`.+- `-a/--animation` — effect name, `auto`, `mixed`, `random`, or `none`. Default: `none` (per-element animation off; pass `auto` to enable).- `--animation-trigger` — Start mode (matches PowerPoint): `on-click`, `with-previous`, or `after-previous` (default).- `--animation-duration` — per-element entrance seconds, default `0.4`.- `--animation-stagger` — gap between elements in `after-previous` mode (seconds, default `0.5`). Ignored otherwise.diff --git a/skills/ppt-master/references/shared-standards.md b/skills/ppt-master/references/shared-standards.mdindex a738ed91..96c94232 100644--- a/skills/ppt-master/references/shared-standards.md+++ b/skills/ppt-master/references/shared-standards.md@@ -314,7 +314,7 @@ python3 scripts/svg_to_pptx.py <project_path>**Optional animation flags** (only when the user asks):- `-t <effect>` — page transition (`fade` / `push` / `wipe` / `split` / `strips` / `cover` / `random` / `none`; default `fade`)-- `-a <effect>` — per-element entrance animation (`fade` / `auto` / `mixed` / `random` / one of 22 named effects / `none`; default `auto`, maps effect from group id — image-like ids cycle zoom/dissolve/circle/box/diamond/wheel, other matches map to a single effect, unmatched ids cycle fade/wipe/fly/zoom). Anchors on top-level `<g id="...">` groups.+- `-a <effect>` — per-element entrance animation (`fade` / `auto` / `mixed` / `random` / one of 22 named effects / `none`; **default `none`** — pages appear as a whole, no auto element builds; opt in with `auto`, which maps effect from group id — image-like ids cycle zoom/dissolve/circle/box/diamond/wheel, other matches map to a single effect, unmatched ids cycle fade/wipe/fly/zoom). Anchors on top-level `<g id="...">` groups.- `--animation-trigger {on-click,with-previous,after-previous}` — Start mode matching PowerPoint's animation-pane Start dropdown. Default `after-previous` (cascade on slide entry; pace via `--animation-stagger <seconds>`); `on-click` advances per click; `with-previous` plays all groups together.- `--animation-config <path>` — optional object-level animation sidecar. Default: `<project>/animations.json` when present.- `--auto-advance <seconds>` — kiosk-style auto-playdiff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_cli.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_cli.pyindex df35b812..240163ea 100644--- a/skills/ppt-master/scripts/svg_to_pptx/pptx_cli.py+++ b/skills/ppt-master/scripts/svg_to_pptx/pptx_cli.py@@ -201,11 +201,12 @@ Recorded narration:parser.add_argument('-a', '--animation', type=str, choices=animation_choices,default=None,help='Per-element entrance animation (native shapes mode '- 'only). Pick a single effect, "auto" (default; map '- 'effect from group id — image-like ids cycle a richer '- 'pool for visual variation, fallback cycles fade/wipe/'- 'fly/zoom), "mixed" (legacy 16-effect pool), "random", '- 'or "none" to disable.')+ 'only). Default "none" (no auto element builds; page '+ 'transitions still apply). Pick a single effect, "auto" '+ '(map effect from group id — image-like ids cycle a '+ 'richer pool for visual variation, fallback cycles fade/'+ 'wipe/fly/zoom), "mixed" (legacy 16-effect pool), or '+ '"random".')parser.add_argument('--animation-duration', type=non_negative_float, default=None,help='Per-element entrance duration in seconds (default: 0.4)')parser.add_argument('--animation-trigger', type=str,@@ -456,7 +457,10 @@ Recorded narration:animation_effect = (animation_argif animation_arg is not None- else animation_defaults.get('effect', 'auto')+ # Per-element entrance is opt-in by default: auto-firing element builds+ # read as the "AI deck" tell and were unsolicited. Page transitions stay+ # on (see transition default above). Re-enable with -a auto / animations.json.+ else animation_defaults.get('effect', 'none'))animation = None if animation_effect == 'none' else animation_effectanimation_duration = (diff --git a/skills/ppt-master/workflows/customize-animations.md b/skills/ppt-master/workflows/customize-animations.mdindex 9c7cebf0..9c4cd345 100644--- a/skills/ppt-master/workflows/customize-animations.md+++ b/skills/ppt-master/workflows/customize-animations.md@@ -4,14 +4,15 @@ description: Customize default PPTX animations with per-slide and per-object tim# Customize Animations Workflow-> Standalone post-generation step. Run when the user asks to tune animation order, effects, timing, or object-level reveals. Default PPTX export already has global animations; this workflow only creates `animations.json` overrides when the user wants finer control.+> Standalone post-generation step. Run when the user asks to tune animation order, effects, timing, or object-level reveals — including simply turning per-element entrance animation on (it is off by default; page transitions still apply). This workflow creates `animations.json` overrides when the user wants element animation or finer control.## When to Run| Condition | Action ||---|---|| User asks for object-level animation, reveal order, timing, or effect changes | Run this workflow |-| User only wants the default animated deck | Do not run; normal `svg_to_pptx.py` export is enough |+| User only wants the default deck (page transitions, no element builds) | Do not run; normal `svg_to_pptx.py` export is enough |+| User just wants per-element entrance animation back on, deck-wide | No config needed — export with `svg_to_pptx.py -a auto`; run this workflow only for per-slide/per-object control || `svg_output/*.svg` is missing | Complete the main Executor phase first || Existing `animations.json` is present | Validate and edit it; do not overwrite unless the user asks |