Skip to content

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.md
index 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 packages
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 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.md
index 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 the
page-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 |
---