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(svg-effects): select techniques by visual job
hugohe3ff28bcbb9bf6
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.mdindex d8916942..c7a7c9ef 100644--- a/skills/ppt-master/references/executor-base.md+++ b/skills/ppt-master/references/executor-base.md@@ -27,18 +27,16 @@ Always-loaded Executor authority for flat SVG page authoring and behavior shared## 1. Effect Capability Discovery-**Reference — not a constraint**: Scan this menu for treatments that support the locked style and hierarchy. Use the already-loaded [`svg-effects.md`](./svg-effects.md) before authoring a selection, except the cross-page motion row, which loads [`animations.md`](./animations.md) §3.1.--| Visual need | Available construction |-|---|---|-| Color / material | alpha paint, gradients, translucent overlays |-| Elevation | shadow, glow, explicit highlights |-| Image integration | scrim, vignette, brand wash, clipping, faux glass |-| Line / type | dash/cap/join, markers, gradient stroke; tracking, outline, alpha/gradient text |-| Space / constructed style | transform/reuse, hand-drawn, ink/Riso, halftone, isometric, paper cut; custom curves/arcs only when meaning or the locked style requires them |-| Continuous action across pages | Paired pages that differ in one property, exported with morph |--**Hard rule — discovery does not expand compatibility**: Follow `svg-effects.md` syntax and fallbacks; unsupported blur, blend, mask, dense texture, or skew remains baked/alternative-only.+**Mandatory — select by visual job**: before authoring each page, run the+already-loaded [`svg-effects.md`](./svg-effects.md) §6.1 procedure and use its+§6.13 scenario routing. The catalog expands construction vocabulary; it does+not create an effect quota. Active cross-page continuous action additionally+loads [`animations.md`](./animations.md) §3.1 before authoring both endpoints.++**Hard rule — discovery does not expand compatibility**: Follow+`svg-effects.md` syntax and fallbacks; unsupported source/backdrop blur, blend+mode, SVG `<mask>` / per-pixel masking, dense texture, or skew remains+baked/alternative-only.**Default — resolve active cross-page geometry here, while pages are still being authored (may override when the deck has no continuous action to express)**: object effects, page transitions, and Morph pair keys are post-processing decisions, but the two visible endpoint states are not. Apply this preparation only when an explicit user motion instruction, an enabled effective Custom Animations outcome, or an existing `animations.json` activates motion; a §IX Motion suggestion alone remains non-operative advice. An active sequence that should read as one continuous action (slide-in, flip, camera push-in, progressive reveal, camera pan) must be authored as consecutive pages in `svg_output/` now. Give each continuing endpoint a compatible direct-root group; source and destination ids or geometry may differ because the later motion stage can bind them explicitly through `animations.json`. A deck that reaches export without both states cannot gain the motion by adding a flag. Adding pages is a §IX roster change and returns to Strategist for Design Spec repair first.diff --git a/skills/ppt-master/references/svg-effects.md b/skills/ppt-master/references/svg-effects.mdindex b7c6aebb..641e2520 100644--- a/skills/ppt-master/references/svg-effects.md+++ b/skills/ppt-master/references/svg-effects.md@@ -10,6 +10,8 @@ Authority for advanced paint, effects, transforms, freeform/radial geometry, and**Mandatory**: Default and Quick Generate read this file completely before SVGauthoring and keep its compatible techniques in active construction vocabulary.+Before constructing each page, run the §6.1 selection procedure and use §6.13+to route each diagnosed visual job.**Default — situational use (may override when plain construction is stronger)**:“Advanced” means capability depth, not an effect quota. During page authoring,@@ -21,14 +23,26 @@ rhythm, and style; apply those that materially help.| Decision layer | Authority ||---|---|| Technical validity | Required / Forbidden / Conditional contracts in this file |-| Project values | `<project_path>/spec_lock.md` stable anchors plus the retained Design Spec and current page context |-| Aesthetic fit | Locked `visual_style` / `visual_style_behavior` |+| Project values | Default: `<project_path>/spec_lock.md` anchors plus retained Design Spec/page context; Quick: anchors resolved in the current context |+| Aesthetic fit | Locked or Quick-resolved `visual_style` / `visual_style_behavior` || Per-page choice | Content purpose, hierarchy, legibility, semantics, and rhythm |+**Mandatory — job-first effect selection**: start from a readable, editable+plain construction, not from the effect catalog.++| Pass | Decision |+|---|---|+| Baseline | Name the concrete job an effect would perform: separate planes, direct attention, integrate image and text, encode state/direction, or express the locked or Quick-resolved material/style. If plain hierarchy already performs it, keep the plain construction. |+| Surface | Identify the exact target—text, image, line, geometry, or a supported `<g>` / `<use>` subtree—and verify that the owning subsection allows that operation on the surface and states usable fidelity. |+| Select | Route the job through §6.13 and choose the smallest compatible technique that performs it. When alternatives communicate equally well, prefer `Native-stable` / `Native-normalized` over `Approximate` or `Bake-required`. |+| Integrate | Align paint, contour, light direction, hierarchy, and z-order with the page. Combine techniques only when each owns a different job; never stack shadow, glow, gradient, border, and tint merely to look advanced. |+| Gate / Stop | Check legibility, editability, object density, native fidelity, and style fit. Simplify for legibility/style failures; use a legal explicit layer or alternative for unsupported syntax; bake the smallest visual layer/asset only when the intent truly depends on pixels. Keep authoritative text/data native and review any material `Approximate` result in the exported PPTX. |+**Reference — illustrative colors**: colors below demonstrate syntax only;-generated pages choose paint from the locked identity anchors, visual style,-content semantics, and current composition. A contextual tint, gradient stop,-shadow/glow paint, or one-off display color need not already be a lock row;+generated pages choose paint from the Default locked or Quick-resolved identity+anchors, visual style, content semantics, and current composition. A contextual+tint, gradient stop, shadow/glow paint, or one-off display color need not+already be a persistent identity role;promote it only when it becomes a recurring named role. Fidelity labels are definedin [`shared-standards-core.md`](./shared-standards-core.md). Review an `Approximate` result in native PPTXwhen the effect carries material meaning.@@ -129,7 +143,7 @@ PPTX import normalizes gradients and reports degradation;Checker/exporter preflight share this validation.Gradient-stop colors are contextual paint values. Keep them coherent with thedeck anchors and page intent; they are not required to duplicate existing-`spec_lock.colors` literals.+Default `spec_lock.colors` literals or Quick-resolved anchors.**Hard rule — non-degenerate gradient geometry**: an `objectBoundingBox`gradient stroke requires non-zero intrinsic width and height. SVG stroke width@@ -561,8 +575,8 @@ freeform, apply [`native-shape-authoring.md`](./native-shape-authoring.md):prefer an editable basic primitive, one exact Office preset, or a Booleanmaterialization. Use a closed cubic path only for an organic silhouette thosecannot express, polygon/closed path for unmatched ribbons/facets, and an open-path only for a required data curve, custom route, or locked hand-drawn /-organic style. Straight relationships use `<line>`; exact stock bends/curves+path only for a required data curve, custom route, or locked or Quick-resolved+hand-drawn / organic style. Straight relationships use `<line>`; exact stock bends/curvesuse an authored native Connector preset. Multi-`M` paths remain available forexact linework, and a [`shared-standards-core.md`](./shared-standards-core.md)§1.2 path clip for unmatched organic pictures. Filled silhouettes end with@@ -655,9 +669,10 @@ filled `Native-normalized` arrowhead. Example:**Hard rule — explicit construction**: these are supported-layer recipes, notbrowser-filter permissions.-**Reference — not a constraint**: use them only when they match the locked style.-Their curve recipes are explicit exceptions to the Shape-first default above;-they do not authorize decorative freeforms in another style.+**Reference — not a constraint**: use them only when they match the locked or+Quick-resolved style. Their curve recipes are explicit exceptions to the+Shape-first default above; they do not authorize decorative freeforms in+another style.| Intent | Construction | Boundary / fidelity ||---|---|---|@@ -730,24 +745,26 @@ import diagnostics. Resolve those diagnostics before release export; see----### 6.13 Scenario Quick Reference+### 6.13 Scenario Routing-**Reference — not a constraint**: fidelity remains authoritative in the owning-subsection; this table only routes scenarios.+**Reference — not a constraint**: this table routes a job diagnosed in §6.1;+it is not a catalog checklist. Fidelity and the locked or Quick-resolved style+remain authoritative in the owning subsection.| Decision family | Scenario routing | Authority / boundary ||---|---|---|-| Elevation | Floating card → resting shadow; one CTA → colored shadow; equal peers/background → flat; maximum predictability → layered shapes; title/metric → glow | §6.4; never body-copy glow |-| Image/material | Text over image → directional scrim; bottom title → bottom fade; centered hero → vignette; brand wash → brand overlay; glass card → faux glass | §6.5; no backdrop blur |-| Lines | Draft/optional → dash; process direction → marker; flow/series → gradient stroke; exact grid → multi-subpath path | §6.6 / §6.3 |-| Text | Removed/former value → line-through; eyebrow → tracking; watermark/outline heading → text outline; list → native bullet | §6.7 |-| Composition | Move/rotate/mirror → §6.8 transform; repeated static mark → local `<use>` | §6.8; preserve z-order |+| Paint | Directional or continuous value change → linear gradient; center-weighted focus → radial gradient; subordinate layer or overlap depth → channel alpha; short display emphasis → gradient text; hierarchy already clear → solid paint | §6.2 / §6.3; do not use color variation without a semantic or material job |+| Elevation | Object visibly above another surface → resting/raised shadow; one focal CTA → restrained colored shadow; equal peers/background → flat; luminous short title/metric → glow | §6.4; one light direction; never body-copy glow |+| Image/material | Text over image → directional scrim; bottom title → bottom fade; centered hero → vignette; brand unification → brand wash; foreground panel over image → faux glass | §6.5; validate actual contrast; no backdrop blur |+| Lines | Draft/optional/future → dash; process direction → marker; undirected relationship → solid connector; continuous flow/series → gradient stroke; exact grid → multi-subpath path | §6.6 / §6.3 |+| Text | Removed/former value → line-through; short eyebrow → tracking; display heading needing a distinct silhouette → outline/gradient; luminous focal metric → glow; list → native bullet | §6.7 / §6.4; body copy may keep semantic decoration, but not decorative gradient/outline/glow/tracking |+| Composition | Physical tilt or directional energy → rotate; reversible non-text asset facing the wrong way → mirror; repeated exact static mark → local `<use>` | §6.8; preserve z-order; never mirror text, logos, or directional evidence || Hand/print | Annotation → highlighter/curve; ink wash → layered alpha paths; Riso → offset duplicate | §6.11; no turbulence, true bleed, or blend mode || Pixel/halftone | Pixel accent → integer rect grid; sparse screen → circles | §6.11; dense screen → §6.12 || Faceted/layered | Pseudo-3D → 2D facets; paper cut → direct shadow per layer | §6.11; no 3D transform/group composite shadow || Data/freeform | Series depth → area first + line above; unmatched organic silhouette → closed cubic; shaped image → [`shared-standards-core.md`](./shared-standards-core.md) §1.2 path clip | §6.11 / §6.9 || Radial | Donut/gauge → explicit arcs; sunburst → sector per node; position-insensitive ring → shorthand | §6.10; shorthand has 90° preview/native offset || Arrow | Straight relationship → `<line>` + marker; stock bend/curve → native Connector; unmatched custom route → separate calculated arrowhead if needed | §6.10 / §1.1 / native-shape authoring |-| Unsupported | Dense grain, complex composite, or skew → explicit alternative or baked asset | §6.12; foreground text/data stay editable SVG |+| Unsupported | Dense grain, complex per-pixel composite, or skew → explicit alternative or baked asset | §6.12; foreground text/data stay editable SVG |---diff --git a/skills/ppt-master/scripts/prompt_audit_manifest.json b/skills/ppt-master/scripts/prompt_audit_manifest.jsonindex 03dc42e6..96ff9fdf 100644--- a/skills/ppt-master/scripts/prompt_audit_manifest.json+++ b/skills/ppt-master/scripts/prompt_audit_manifest.json@@ -12,7 +12,7 @@"skills/ppt-master/templates/schemas/*.json"],"exclude": [],- "max_tokens": 394495+ "max_tokens": 394933},"file_budgets": {"AGENTS.md": 2400,@@ -25,7 +25,7 @@"skills/ppt-master/references/executor-notes.md": 900,"skills/ppt-master/references/shared-standards.md": 250,"skills/ppt-master/references/shared-standards-core.md": 11100,- "skills/ppt-master/references/svg-effects.md": 11725,+ "skills/ppt-master/references/svg-effects.md": 12236,"skills/ppt-master/references/native-data-interface.md": 6200,"skills/ppt-master/references/pptx-structure-interface.md": 4300,"skills/ppt-master/references/strategist.md": 14350,@@ -186,7 +186,7 @@"skills/ppt-master/references/svg-effects.md","skills/ppt-master/references/native-shape-authoring.md"],- "max_tokens": 53348+ "max_tokens": 53797},"route.generate.quick-generate.topic-research": {"description": "Quick Generate with gap-targeted factual research before direct resource preparation and SVG authoring.",@@ -196,7 +196,7 @@"stage.generate.topic-research"],"files": [],- "max_tokens": 54848+ "max_tokens": 55297},"route.generate.quick-generate.icon": {"description": "Quick Generate with project-local bundled icon selection and synchronization.",@@ -207,7 +207,7 @@"files": ["skills/ppt-master/templates/icons/README.md"],- "max_tokens": 55248+ "max_tokens": 55697},"route.generate.quick-generate.in-hand-image": {"description": "Quick Generate with supplied, extracted, or placeholder image resources prepared before SVG authoring.",@@ -217,7 +217,7 @@"stage.generate.executor.image"],"files": [],- "max_tokens": 63233+ "max_tokens": 63744},"route.generate.quick-generate.formula": {"description": "Quick Generate with manifest-driven formula rendering and formula-image realization.",@@ -229,7 +229,7 @@"files": ["skills/ppt-master/scripts/docs/image.md"],- "max_tokens": 66408+ "max_tokens": 66946},"route.generate.quick-generate.ai-two-types": {"description": "Quick Generate with AI resource preparation, representative rendering inputs, and two local image types.",@@ -240,7 +240,7 @@"stage.generate.executor.image"],"files": [],- "max_tokens": 86333+ "max_tokens": 86871},"route.generate.quick-generate.web-image": {"description": "Quick Generate with web resource preparation, provenance, attribution, and image execution.",@@ -251,7 +251,7 @@"stage.generate.executor.web-image"],"files": [],- "max_tokens": 70983+ "max_tokens": 71521},"route.generate.planning-image": {"description": "Generate-PPTX planning context after a non-none image source is proposed or confirmed, including the compact layout math and vocabulary.",@@ -403,7 +403,7 @@"stage.generate.executor.notes"],"files": [],- "max_tokens": 104265+ "max_tokens": 104598},"route.generate.flat-ai-two-types": {"description": "Generate-PPTX context with AI images, representative multi-source custom rendering, and two local types.",@@ -461,7 +461,7 @@"profile.generate.beautify-pptx"],"files": [],- "max_tokens": 111190+ "max_tokens": 111523},"route.generate.flat-no-image-chart": {"description": "Default flat Generate-PPTX path with chart authoring, native-data replacement, and verification.",@@ -474,7 +474,7 @@"stage.generate.verify-charts"],"files": [],- "max_tokens": 128590+ "max_tokens": 128923},"route.generate.brand-flat-no-image": {"description": "Brand-preset flat Generate-PPTX path without image acquisition.",@@ -486,7 +486,7 @@"stage.generate.template.brand"],"files": [],- "max_tokens": 111290+ "max_tokens": 111623},"route.generate.deck-structured-no-image": {"description": "Deck-preset structured Generate-PPTX path without image acquisition.",@@ -498,7 +498,7 @@"stage.generate.template.deck"],"files": [],- "max_tokens": 121240+ "max_tokens": 121573},"route.generate.layout-structured-no-image": {"description": "Layout-preset structured Generate-PPTX path without image acquisition.",@@ -510,7 +510,7 @@"stage.generate.template.layout"],"files": [],- "max_tokens": 121690+ "max_tokens": 122023},"route.generate.topic-only-flat-no-image": {"description": "Topic research followed by the default flat no-image Generate-PPTX path.",@@ -520,7 +520,7 @@"route.generate.flat-no-image"],"files": [],- "max_tokens": 105765+ "max_tokens": 106098},"stage.generate.executor.flat": {"description": "Incremental flat Executor core with complete visual-construction authorities and representative multi-source custom mode/style execution.",@@ -622,7 +622,7 @@"skills/ppt-master/workflows/stages/resume-execute.md","skills/ppt-master/references/artifact-ownership.md"],- "max_tokens": 67115+ "max_tokens": 67448},"stage.generate.resume-execute-image": {"description": "Fresh-session resume when the locked resource plan contains image rows.",@@ -858,7 +858,7 @@"files": ["skills/ppt-master/references/svg-effects.md"],- "max_tokens": 11725+ "max_tokens": 12236}},"duplicates": {