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
docs(animations): keep custom motion restrained and coherent
hugohe3778857bbc167
diff --git a/skills/ppt-master/references/animations.md b/skills/ppt-master/references/animations.mdindex 701b6aed..6504dccc 100644--- a/skills/ppt-master/references/animations.md+++ b/skills/ppt-master/references/animations.md@@ -353,9 +353,13 @@ that attribute remains importer metadata for mirror/preserve packagesOff 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 object 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.+- **`on-click`** — each click reveals the next group. Use only for a controlled semantic reveal; live delivery alone is insufficient. Forbidden with `--recorded-narration`.+- **`with-previous`** — groups start together as one coordinated beat. Stagger ignored.+- **`after-previous`** (default) — click-free cascade on slide entry with `--animation-stagger` spacing. Use when controlled reveals are unnecessary.++**Default — coherent Start rhythm (may override when a semantic beat needs+different control)**: Keep one dominant deck rhythm and normally one mode per+slide. Mix only for a distinct simultaneous or presenter-controlled beat.Enable with `-a auto`, select a canonical effect with`--animation entrance_fade`, and choose Start behavior with@@ -378,9 +382,10 @@ matching lifecycle instead.| `move` | state/position A → progress → state/position B | The trajectory carries spatial or causal meaning, or §4.1 adopts subordinate ambient motion; use Morph for cross-page continuity | Explicit `path_*`, or endpoint pages + Morph || `exit` | present → retire → absent | The same slide must remove, replace, or make room for content; an ordinary page change needs no object exit | Explicit `exit_*` |-Entrance is the common opt-in family for staged information, not a deck or-category quota. A unit may use several ordered `effects[]` rows only when it-has several real lifecycle duties.+**Default — restrained entrance-led choreography (may override for content,+tone, or the request)**: Use entrances for ordinary builds. Add emphasis or+exit sparingly, only for a real duty and fitting effect. Multiple `effects[]`+rows require multiple duties.The registry exposes two layers:diff --git a/skills/ppt-master/workflows/stages/customize-animations.md b/skills/ppt-master/workflows/stages/customize-animations.mdindex d3ef68e2..6aedf8c9 100644--- a/skills/ppt-master/workflows/stages/customize-animations.md+++ b/skills/ppt-master/workflows/stages/customize-animations.md@@ -190,12 +190,12 @@ deck-wide transition review.| Page animation defaults | `defaults.animation` or `slides.<slide>.animation` | Control the default object-animation behavior for animated groups on a slide || Object lifecycle | `slides.<slide>.groups.<group_id>` | Assign one legacy effect row or an ordered `effects[]` sequence to a real SVG motion unit |-**Per-affected-page motion brief**: decide what communication job the requested-motion should perform—or that it should perform none. Classify the relevant-motion units by lifecycle before choosing effects, then select only the-relevant transition, object effects, order, and timing. Use-`design_spec.md` for slide role, `spec_lock.md` for rhythm and visual style,-speaker notes for narration order, and SVG group ids for target validity.+**Per-affected-page motion brief**: classify the communication job—including+none—and each unit's lifecycle. Choose only the required transition, effect,+order, timing, and one dominant Start rhythm; mix modes or add emphasis and+exit only for a distinct job with a restrained, fitting effect. Read+`design_spec.md`, `spec_lock.md`, speaker notes, and SVG group ids for role,+rhythm, order, and target validity.**Mandatory — select from meaning, not catalog coverage**: run thepage-relationship and lifecycle selection playbooks in@@ -296,9 +296,9 @@ entrance treatment is sufficient.| Trigger | Behavior ||---|---|-| `after-previous` | Cascade automatically on slide entry |-| `with-previous` | Start together on slide entry |-| `on-click` | One presenter click per animated group |+| `after-previous` | Default click-free cascade |+| `with-previous` | One coordinated beat together |+| `on-click` | Controlled semantic reveal |---