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

fix(video): require custom animations for Quick delivery

hugohe3b95793046e69
diff --git a/skills/ppt-master/references/video-design.md b/skills/ppt-master/references/video-design.md
index 308f96b6..1838a701 100644
--- a/skills/ppt-master/references/video-design.md
+++ b/skills/ppt-master/references/video-design.md
@@ -120,14 +120,22 @@ A pre-SVG `notes/total.md` is an enabled production artifact, not a forbidden
planning checkpoint; Quick still creates no root Design Spec, lock,
confirmation payload, or storyboard.
+**Hard rule — Quick video Custom Animations**: when Quick generates a PPTX for
+recorded, self-running, or video delivery, enable Custom Animations before SVG
+authoring and complete the custom-animation stage before base export. Use
+semantic groups and page-specific choreography; deck-wide `-a auto` and page
+transitions do not satisfy this requirement. Individual pages or groups may
+remain static, so this is not an animation-coverage quota. A validated
+`animations.json` is required unless the user explicitly requests static or
+page-transition-only playback.
+
**Mandatory — Quick direct video input**: when Quick must deliver a narrated
video or MP4 rather than only a deck for later recording, enable Speaker Notes,
Narration Audio, and video export; write the complete per-scene narration to
`notes/total.md` before P01 and use it as page-design input. After the SVG
roster, only agent-authored wording may be finalized; final/literal input remains
-verbatim. Before audio, choose static/page-transition-only,
-narration-independent deck-wide exporter motion, or page/object-specific Custom
-Animations; for the last, decide whether narration governs any group timing.
+verbatim. Before audio, complete the required Custom Animations configuration
+and decide whether narration governs any group timing.
**Production outcomes**:
@@ -136,13 +144,16 @@ Animations; for the last, decide whether narration governs any group timing.
| Spoken delivery or a supplied final script | Enable Speaker Notes |
| User asks the workflow to synthesize narration | Enable Narration Audio; Speaker Notes is its dependency |
| Progressive reveal, continuing geometry, or timed emphasis materially aids explanation | Enable/load the appropriate animation capability |
-| Quick directly delivers a narrated video or MP4 | Enable Speaker Notes, Narration Audio, and video export; resolve motion before audio, requiring timestamped page-local SRT only for narration-cue sync or subtitle delivery |
-| Video is manually narrated or static playback is sufficient | Keep Narration Audio and/or object animation off as applicable |
+| Quick generates a PPTX for recorded, self-running, or video delivery | Enable Custom Animations before SVG authoring and validate `animations.json` before base export |
+| Quick directly delivers a narrated video or MP4 | Also enable Speaker Notes, Narration Audio, and video export; resolve narration-governed timing before audio, requiring timestamped page-local SRT for cue sync or subtitle delivery |
+| The user explicitly requests static playback or disables object motion | Keep object animation off; retain the remaining notes/audio/video outcomes as requested |
-**Capability boundary**: a deck intended for later video use does not force
-object animation or generated audio. Direct Quick narrated-video delivery uses
-the mandatory row above but may intentionally remain static or
-page-transition-only. Explicit user instructions remain authoritative.
+**Capability boundary**: Default generation does not force object animation or
+generated audio merely because a deck may later be recorded. Quick with an
+effective recorded/self-running/video delivery purpose does require Custom
+Animations, while explicit user instructions for static or
+page-transition-only playback remain authoritative. This requirement selects
+the capability, not motion coverage or one effect for every page.
---
@@ -178,9 +189,10 @@ validate canonical `animations.json`. After the base PPTX/report and timestamped
page audio/SRT, map timed groups in `narration_timing.json`, derive
`narration_animations.json`, and export the narrated PPTX/MP4. Only derived
triggers/delays wait for SRT; object identity, effect, and order do not. `-a
-auto` or inherited fixed stagger is not semantic synchronization. For
-static/page-transition-only or narration-independent deck-wide motion, omit
-these sidecars and the object-sync claim.
+auto` or inherited fixed stagger is not semantic synchronization. For an
+explicit user-selected static/page-transition-only Quick exception, or for
+ordinary Default narration-independent deck-wide motion, omit these sidecars
+and the object-sync claim.
**Sound effects**: exclude them from this pass and planning artifacts. After
final SVG/motion, animation post-processing owns on-demand sync; otherwise
diff --git a/skills/ppt-master/workflows/profiles/quick-generate.md b/skills/ppt-master/workflows/profiles/quick-generate.md
index cdd435a6..8a914e34 100644
--- a/skills/ppt-master/workflows/profiles/quick-generate.md
+++ b/skills/ppt-master/workflows/profiles/quick-generate.md
@@ -47,10 +47,12 @@ After entry, continue through selected work, the final checker, and export.
Pause only for user interruption or an unresolved hard prerequisite.
**Default — optional production behavior (may override when useful)**: Speaker
-notes, custom object animations, and narration start off. The current agent may
-enable any ordinary capability when the request or deck benefits; use its
-normal inputs, flags, and prerequisites without asking for approval. Quick
-never creates or reads a root project Design Spec or lock to enable it.
+notes, Custom Animations, and narration start off for ordinary Quick work. The
+current agent may enable any ordinary capability when the request or deck
+benefits; use its normal inputs, flags, and prerequisites without asking for
+approval. Quick video delivery follows the mandatory Custom Animations rule
+below. Quick never creates or reads a root project Design Spec or lock to enable
+an optional or mandatory capability.
**Mandatory — discover motion before deciding whether to load it**: apply this
gate once during §2's pre-P01 planning. Do not load the full reference when
@@ -69,13 +71,18 @@ defaults when no row supplies a concrete communication job. When several
signals apply, perform every required action and use the earliest required load
point; a before-authoring signal always overrides a before-export-only timing.
-**Direct-video application**: when [`video-design.md`](../../references/video-design.md)
-is active for Quick direct delivery, use this gate as the required pre-audio
-motion choice, not an animation quota. Morph and page/object-specific rows
-activate Custom Animations; narration-governed reveals also activate cue
-synchronization. The deck-wide row remains independent of narration and must
-not be reported as synchronized; static or
-page-transition-only motion remains valid.
+**Hard rule — Quick video Custom Animations**: when
+[`video-design.md`](../../references/video-design.md) is active because the
+effective Quick delivery purpose is recorded, self-running, or video-directed,
+enable Custom Animations, load [`animations.md`](../../references/animations.md)
+before SVG authoring, preserve the required semantic motion units, and run
+[`customize-animations`](../stages/customize-animations.md) after the final
+checker. Use the discovery table above to choose the choreography, not whether
+Custom Animations exists. Individual pages or groups may remain static, so this
+is not an animation-coverage quota. A Quick video run without a validated
+`animations.json` fails this requirement unless the user explicitly requests
+static or page-transition-only playback. Narration-governed motion also
+activates cue synchronization.
---
@@ -256,7 +263,7 @@ Before P01, apply the §1 gate while co-resolving these choices; freeze
the roster after the whole-roster check:
- the narrative beats, mental-map arcs, candidate visible states, their semantic deltas, and enabled notes segments. Adopt continuity only when it clarifies the message. Profile-fixed count/order/content, including 1:1/fidelity, permits only existing-neighbor evaluation; never alter those invariants to manufacture endpoints;
-- the effective Speaker Notes, Custom Animations, and Narration Audio outcomes; narration requires notes, later recording forces neither audio nor object animation, and Quick direct video follows [`video-design.md`](../../references/video-design.md): enable notes/narration/video, decide motion before audio, and enable Custom Animations only for narration-cued or other page/object-specific motion;
+- the effective Speaker Notes, Custom Animations, and Narration Audio outcomes; narration requires notes, later recording alone forces neither audio nor object animation, while a Quick recorded/self-running/video delivery purpose follows [`video-design.md`](../../references/video-design.md) and enables Custom Animations before SVG authoring; direct narrated video additionally enables notes/narration/video and decides before audio whether narration governs group timing;
- the resulting exact slide roster and one compact core message for every page, used to choose its composition and hierarchy;
- the canvas, visual direction, wording, intended viewing distance, and effective reading mode: choose `presentation` for distance-first projected or recorded viewing, `balanced` for mixed viewing, or `text` for close content-heavy reading. Take the initial body anchor and sanity band from [`canvas-formats.md`](../../references/canvas-formats.md) § "Typography Scale Start" for the resolved canvas—PPT remains reading-mode-driven, while registered/custom non-PPT canvases use their canvas-derived start—then resolve one concrete typography plan using installed font families, with stable size anchors for title, body, annotation, and every other recurring role the roster uses. When content does not fit, preserve its core message and apply only fitting actions the source/profile invariants permit—restructure, shorten, or split; if none is permitted, surface the unresolved fit instead of shrinking a recurring role. Explicit user, template, fidelity-profile, or resolved-style requirements may call for a deliberate exception;
- the semantic color roles actually needed by the roster, each with a concrete active-context color anchor, including background/surface, primary/secondary text, dominant/accent, and status roles as applicable. Honor explicit user, installed template/brand, fidelity-profile source-identity, and resolved-style color semantics before deriving only the missing roles that the active profile permits; decide which roles dominate, support, or remain rare, and preserve sufficient contrast for meaning-bearing text. Pair newly authored color-coded states, categories, or relationships with a label, symbol, line, or geometry cue; when fidelity forbids adding one, preserve the source encoding;
@@ -558,13 +565,12 @@ After visual motion is final, sync a selected cue per
[`animations.md`](../../references/animations.md) §2.2; otherwise create no
`sounds/`. Sidecars never use `templates/sounds/`.
-For Quick direct video, preserve the motion choice made under
-[`video-design.md`](../../references/video-design.md). A static,
-page-transition-only, or narration-independent deck-wide choice may export
-without `animations.json` and does not claim object-level audio sync. Any
-page/object-specific choice completes the custom stage before base export;
-`generate-audio` derives cue timing only for narration-governed groups and
-otherwise exports canonical timing without an object-sync claim.
+For Quick recorded/self-running/video delivery, complete the mandatory Custom
+Animations stage and validate `animations.json` before the base export unless
+the user explicitly requested static or page-transition-only playback. Direct
+narrated video derives cue timing only when narration governs groups; otherwise
+it exports the canonical custom timing without an object-sync claim. Do not
+replace this requirement with deck-wide `-a auto` or page transitions.
Choose exactly one notes mode for the base export:
@@ -581,10 +587,11 @@ python3 ${SKILL_DIR}/scripts/svg_to_pptx.py <project_path> \
`--quick-generate` reads `svg_output/` as the page source and resolves the
project-local assets referenced by those SVGs. It infers one consistent canvas,
uses a lockless flat PowerPoint package, and does not force-disable ordinary
-export options. Notes, custom object animation, and narration remain off unless
-selected by the agent. Do not run `finalize_svg.py`. After the validated base
-export, run [`generate-audio`](../stages/generate-audio.md) when Narration Audio
-is enabled; it owns page audio/SRT, narrated PPTX, and optional native MP4.
+export options. Notes, Custom Animations, and narration remain off unless
+selected by the agent or required by the Quick video rule above. Do not run
+`finalize_svg.py`. After the validated base export, run
+[`generate-audio`](../stages/generate-audio.md) when Narration Audio is enabled;
+it owns page audio/SRT, narrated PPTX, and optional native MP4.
The exporter requires a passing `final` report whose SVG fingerprint matches
the current `svg_output/`; missing, blocking, non-final, or stale reports stop