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(generate): always load advanced visual authorities

hugohe3d7d688435b3d
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.md
index 70cb994b..d8916942 100644
--- a/skills/ppt-master/references/executor-base.md
+++ b/skills/ppt-master/references/executor-base.md
@@ -27,7 +27,7 @@ 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. After selecting one, load [`svg-effects.md`](./svg-effects.md) before authoring it — except the cross-page motion row, which loads [`animations.md`](./animations.md) §3.1.
+**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 |
|---|---|
diff --git a/skills/ppt-master/references/svg-effects.md b/skills/ppt-master/references/svg-effects.md
index c9c095c3..1cd89fd3 100644
--- a/skills/ppt-master/references/svg-effects.md
+++ b/skills/ppt-master/references/svg-effects.md
@@ -2,7 +2,7 @@
# SVG Effects and Geometry Specification
-Conditional reference for advanced paint, effects, transforms, freeform/radial geometry, and constructed visual styles. Load only when the page uses one of these capabilities.
+Authority for advanced paint, effects, transforms, freeform/radial geometry, and constructed visual styles. Default and Quick Generate load it before SVG authoring; other SVG-authoring routes follow their workflow trigger.
**Cross-reference map**: unqualified §1, §2, and §4 references point to [`shared-standards-core.md`](./shared-standards-core.md); §6 references are local to this file.
diff --git a/skills/ppt-master/scripts/prompt_audit_manifest.json b/skills/ppt-master/scripts/prompt_audit_manifest.json
index 76cf1e0c..aff4583f 100644
--- a/skills/ppt-master/scripts/prompt_audit_manifest.json
+++ b/skills/ppt-master/scripts/prompt_audit_manifest.json
@@ -173,7 +173,7 @@
"max_tokens": 62475
},
"route.generate.quick-generate": {
- "description": "Explicit non-interactive Generate path with conditional source/resource preparation and the shared SVG authoring core.",
+ "description": "Explicit non-interactive Generate path with conditional source/resource preparation and the complete SVG visual-construction authorities.",
"scope": "cumulative",
"include": [
"bootstrap.routing"
@@ -182,9 +182,11 @@
"skills/ppt-master/workflows/generate-pptx.md",
"skills/ppt-master/workflows/profiles/quick-generate.md",
"skills/ppt-master/references/artifact-ownership.md",
- "skills/ppt-master/references/shared-standards-core.md"
+ "skills/ppt-master/references/shared-standards-core.md",
+ "skills/ppt-master/references/svg-effects.md",
+ "skills/ppt-master/references/native-shape-authoring.md"
],
- "max_tokens": 36950
+ "max_tokens": 53040
},
"route.generate.quick-generate.topic-research": {
"description": "Quick Generate with gap-targeted factual research before direct resource preparation and SVG authoring.",
@@ -194,7 +196,7 @@
"stage.generate.topic-research"
],
"files": [],
- "max_tokens": 38450
+ "max_tokens": 54540
},
"route.generate.quick-generate.icon": {
"description": "Quick Generate with project-local bundled icon selection and synchronization.",
@@ -205,7 +207,7 @@
"files": [
"skills/ppt-master/templates/icons/README.md"
],
- "max_tokens": 38850
+ "max_tokens": 54940
},
"route.generate.quick-generate.in-hand-image": {
"description": "Quick Generate with supplied, extracted, or placeholder image resources prepared before SVG authoring.",
@@ -215,7 +217,7 @@
"stage.generate.executor.image"
],
"files": [],
- "max_tokens": 46275
+ "max_tokens": 62365
},
"route.generate.quick-generate.formula": {
"description": "Quick Generate with manifest-driven formula rendering and formula-image realization.",
@@ -227,7 +229,7 @@
"files": [
"skills/ppt-master/scripts/docs/image.md"
],
- "max_tokens": 49475
+ "max_tokens": 65565
},
"route.generate.quick-generate.ai-two-types": {
"description": "Quick Generate with AI resource preparation, representative rendering inputs, and two local image types.",
@@ -238,7 +240,7 @@
"stage.generate.executor.image"
],
"files": [],
- "max_tokens": 69400
+ "max_tokens": 85490
},
"route.generate.quick-generate.web-image": {
"description": "Quick Generate with web resource preparation, provenance, attribution, and image execution.",
@@ -249,7 +251,7 @@
"stage.generate.executor.web-image"
],
"files": [],
- "max_tokens": 54025
+ "max_tokens": 70115
},
"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.",
@@ -401,7 +403,7 @@
"stage.generate.executor.notes"
],
"files": [],
- "max_tokens": 88175
+ "max_tokens": 104265
},
"route.generate.flat-ai-two-types": {
"description": "Generate-PPTX context with AI images, representative multi-source custom rendering, and two local types.",
@@ -414,7 +416,7 @@
"stage.generate.image.ai-two-types"
],
"files": [],
- "max_tokens": 133200
+ "max_tokens": 149290
},
"route.generate.flat-in-hand-image": {
"description": "Generate-PPTX context with provided, placeholder, or formula images and no acquisition role.",
@@ -426,7 +428,7 @@
"stage.generate.executor.notes"
],
"files": [],
- "max_tokens": 106525
+ "max_tokens": 122615
},
"route.generate.flat-web-image": {
"description": "Generate-PPTX context with web image acquisition.",
@@ -439,7 +441,7 @@
"stage.generate.image.web"
],
"files": [],
- "max_tokens": 113800
+ "max_tokens": 129890
},
"route.enhance-native-pptx.audio": {
"description": "Enhance Native PPTX with the shared narration-audio stage.",
@@ -459,7 +461,7 @@
"profile.generate.beautify-pptx"
],
"files": [],
- "max_tokens": 95100
+ "max_tokens": 111190
},
"route.generate.flat-no-image-chart": {
"description": "Default flat Generate-PPTX path with chart authoring, native-data replacement, and verification.",
@@ -472,7 +474,7 @@
"stage.generate.verify-charts"
],
"files": [],
- "max_tokens": 112500
+ "max_tokens": 128590
},
"route.generate.brand-flat-no-image": {
"description": "Brand-preset flat Generate-PPTX path without image acquisition.",
@@ -484,7 +486,7 @@
"stage.generate.template.brand"
],
"files": [],
- "max_tokens": 95200
+ "max_tokens": 111290
},
"route.generate.deck-structured-no-image": {
"description": "Deck-preset structured Generate-PPTX path without image acquisition.",
@@ -496,7 +498,7 @@
"stage.generate.template.deck"
],
"files": [],
- "max_tokens": 105150
+ "max_tokens": 121240
},
"route.generate.layout-structured-no-image": {
"description": "Layout-preset structured Generate-PPTX path without image acquisition.",
@@ -508,7 +510,7 @@
"stage.generate.template.layout"
],
"files": [],
- "max_tokens": 105600
+ "max_tokens": 121690
},
"route.generate.topic-only-flat-no-image": {
"description": "Topic research followed by the default flat no-image Generate-PPTX path.",
@@ -518,14 +520,16 @@
"route.generate.flat-no-image"
],
"files": [],
- "max_tokens": 89675
+ "max_tokens": 105765
},
"stage.generate.executor.flat": {
- "description": "Incremental flat Executor core with representative multi-source custom mode/style execution.",
+ "description": "Incremental flat Executor core with complete visual-construction authorities and representative multi-source custom mode/style execution.",
"scope": "incremental",
"files": [
"skills/ppt-master/references/executor-base.md",
"skills/ppt-master/references/shared-standards-core.md",
+ "skills/ppt-master/references/svg-effects.md",
+ "skills/ppt-master/references/native-shape-authoring.md",
"skills/ppt-master/references/semantic-svg.md",
{
"glob": "skills/ppt-master/references/modes/*.md",
@@ -548,7 +552,7 @@
"allow_repeat": true
}
],
- "max_tokens": 36500
+ "max_tokens": 52590
},
"stage.generate.executor.structured": {
"description": "Structured template execution layered on the flat/shared core.",
@@ -560,7 +564,7 @@
"skills/ppt-master/references/executor-structured.md",
"skills/ppt-master/references/pptx-structure-interface.md"
],
- "max_tokens": 37000
+ "max_tokens": 53090
},
"stage.generate.image.ai-two-types": {
"description": "Incremental AI-image role with representative multi-source custom rendering and two selected local types.",
@@ -618,7 +622,7 @@
"skills/ppt-master/workflows/stages/resume-execute.md",
"skills/ppt-master/references/artifact-ownership.md"
],
- "max_tokens": 51025
+ "max_tokens": 67115
},
"stage.generate.resume-execute-image": {
"description": "Fresh-session resume when the locked resource plan contains image rows.",
@@ -628,7 +632,7 @@
"stage.generate.executor.image"
],
"files": [],
- "max_tokens": 67800
+ "max_tokens": 83890
},
"stage.generate.topic-research": {
"description": "Gap-targeted factual intake stage.",
@@ -841,7 +845,7 @@
"max_tokens": 900
},
"stage.generate.executor.native-shape": {
- "description": "Conditional stock PowerPoint shape selection and Boolean materialization contract.",
+ "description": "Stock PowerPoint shape selection and Boolean materialization authority, always included in Generate Executor contexts.",
"scope": "incremental",
"files": [
"skills/ppt-master/references/native-shape-authoring.md"
@@ -849,7 +853,7 @@
"max_tokens": 4500
},
"stage.shared.svg-effects": {
- "description": "Conditional advanced SVG paint, effects, transforms, and geometry for Generate Executor or Create Template.",
+ "description": "Advanced SVG paint, effects, transforms, and geometry authority, always included in Generate Executor contexts and conditionally loaded by other SVG-authoring routes.",
"scope": "incremental",
"files": [
"skills/ppt-master/references/svg-effects.md"
diff --git a/skills/ppt-master/workflows/generate-pptx.md b/skills/ppt-master/workflows/generate-pptx.md
index bc71a7a2..f55bbc7d 100644
--- a/skills/ppt-master/workflows/generate-pptx.md
+++ b/skills/ppt-master/workflows/generate-pptx.md
@@ -372,12 +372,14 @@ Read the execution references for this deck's locked `mode` + `visual_style` (fr
```
Read references/executor-base.md # REQUIRED: flat/shared execution core
Read references/shared-standards-core.md # REQUIRED: SVG compatibility core
+Read references/svg-effects.md # REQUIRED: advanced visual effects and construction vocabulary
+Read references/native-shape-authoring.md # REQUIRED: native-shape selection and Boolean construction
Read references/semantic-svg.md # REQUIRED: semantic metadata boundary
Read references/modes/<resolved-id>.md # one preset id, or each `mode_references` id
Read references/visual-styles/<resolved-id>.md # one preset id, or each `visual_style_references` id
```
-> Read only the five always-on references above plus the conditionally triggered modules below. A preset reads its one locked file. For `mode: custom` or `visual_style: custom`, read every exact file named by the optional `mode_references` / `visual_style_references`, then synthesize those sources under the corresponding behavior. If the reference field is absent, the direction is genuinely novel: read no preset file and follow the behavior directly. Never infer adjacent references or glob `modes/` / `visual-styles/`.
+> Read only the always-on references above plus the conditionally triggered modules below. A preset reads its one locked file. For `mode: custom` or `visual_style: custom`, read every exact file named by the optional `mode_references` / `visual_style_references`, then synthesize those sources under the corresponding behavior. If the reference field is absent, the direction is genuinely novel: read no preset file and follow the behavior directly. Never infer adjacent references or glob `modes/` / `visual-styles/`.
| Deterministic trigger | Additional references |
|---|---|
@@ -386,8 +388,6 @@ Read references/visual-styles/<resolved-id>.md # one preset id, or each `visu
| Preset pattern or supported native chart/table | `native-data-interface.md` before drawing |
| `spec_lock.md images` / §VIII has an image/formula row, or the template has bundled images | `executor-image.md` + `image-layout-spec.md` + `image-layout-patterns.md` + `svg-image-embedding.md` |
| At least one placed image has `Status: Sourced` | `executor-web-image.md` after the image branch |
-| The locked style/current page calls for noncanonical or alpha paint, dash/cap/join, tracking/decoration/outline, gradient/filter/glow/shadow, path/transform/clipping, or another constructed effect | `svg-effects.md` before authoring that value or effect |
-| §IX contains `Native shape suggestion`, or current page construction calls for a literal PowerPoint stock shape, a stock Connector contour, an explicit Merge Shapes operation/result (including a text, letterform, or numeral knockout), or a shape-built dimensional form (cylinder/pedestal, layered diagram, reflection, ground plane), or Executor is about to hand-author a freeform not already required by data geometry or the locked organic / hand-drawn style | `native-shape-authoring.md` before selecting or materializing that geometry. This trigger is image-independent: a text-only, data-only, or icon-only page reaches it the same way |
| All SVG pages and SVG quality gates are complete, and the effective Speaker Notes outcome in `design_spec.md §I` is enabled | `executor-notes.md` before generating speaker notes |
No branch is loaded by analogy. Evaluate these triggers from `spec_lock.md`, §VII/§VIII, the selected style, and the current page plan.
@@ -416,7 +416,7 @@ python3 ${SKILL_DIR}/scripts/svg_editor/server.py <project_path> --live --daemon
**Visual Construction Phase**: generate SVG pages sequentially, one at a time, in one continuous pass → `<project_path>/svg_output/`
-Each completed SVG MUST be a standalone, complete representation of that slide's visible design. Template SVGs and locked planning artifacts may guide construction, but export must not reach back to them to add visible objects omitted from `svg_output/`. Speaker notes, animation, narration, transitions, and direct native-PPTX workflows remain separately owned artifacts/capabilities. Treat §IX `Native shape suggestion` as a candidate, not a command: inspect the actual page construction, then choose the highest-level faithful construction in this order — editable basic primitive, exact Office preset, Merge Shapes Boolean result, and only then a necessary freeform. Load and apply [`native-shape-authoring.md`](../references/native-shape-authoring.md) before materializing an adopted native treatment. Diagram relationships follow the same Shape-first order; do not infer a preset from contour similarity.
+Each completed SVG MUST be a standalone, complete representation of that slide's visible design. Template SVGs and locked planning artifacts may guide construction, but export must not reach back to them to add visible objects omitted from `svg_output/`. Speaker notes, animation, narration, transitions, and direct native-PPTX workflows remain separately owned artifacts/capabilities. Treat §IX `Native shape suggestion` as a candidate, not a command: inspect the actual page construction, then choose the highest-level faithful construction in this order — editable basic primitive, exact Office preset, Merge Shapes Boolean result, and only then a necessary freeform. Apply [`native-shape-authoring.md`](../references/native-shape-authoring.md) before materializing an adopted native treatment. Diagram relationships follow the same Shape-first order; do not infer a preset from contour similarity.
**Motion-ready image composition**: Only when an explicit user motion
instruction, the effective Custom Animations outcome in `design_spec.md §I` is
diff --git a/skills/ppt-master/workflows/profiles/quick-generate.md b/skills/ppt-master/workflows/profiles/quick-generate.md
index 6531fa5a..7e2b31a8 100644
--- a/skills/ppt-master/workflows/profiles/quick-generate.md
+++ b/skills/ppt-master/workflows/profiles/quick-generate.md
@@ -101,17 +101,18 @@ silently replace it with unrelated material.
## 3. Direct SVG Authoring
Always read
-[`shared-standards-core.md`](../../references/shared-standards-core.md). Do not
-load `executor-base.md`: its persisted-plan prerequisites do not apply to this
-profile. For any image/formula, always read
+[`shared-standards-core.md`](../../references/shared-standards-core.md),
+[`svg-effects.md`](../../references/svg-effects.md), and
+[`native-shape-authoring.md`](../../references/native-shape-authoring.md). Do
+not load `executor-base.md`: its persisted-plan prerequisites do not apply to
+this profile. For any image/formula, always read
[`executor-image.md`](../../references/executor-image.md),
[`image-layout-spec.md`](../../references/image-layout-spec.md),
[`image-layout-patterns.md`](../../references/image-layout-patterns.md), and
[`svg-image-embedding.md`](../../references/svg-image-embedding.md); add
[`executor-web-image.md`](../../references/executor-web-image.md) for a sourced
web image. Load [`canvas-formats.md`](../../references/canvas-formats.md) only
-for a non-default canvas, and load `native-shape-authoring.md` for selected
-preset/Boolean construction such as text knockouts.
+for a non-default canvas.
Use one zero-padded filename width sized for the resolved roster, such as
`01_cover.svg` through `12_end.svg` or `001_cover.svg` through `120_end.svg`.
diff --git a/skills/ppt-master/workflows/stages/resume-execute.md b/skills/ppt-master/workflows/stages/resume-execute.md
index bbf69bf4..f86da686 100644
--- a/skills/ppt-master/workflows/stages/resume-execute.md
+++ b/skills/ppt-master/workflows/stages/resume-execute.md
@@ -56,7 +56,7 @@ Then jump to `### Step 6: Executor Phase` and run the documented pipeline:
`enabled` / `disabled` / `disabled`; these production decisions never come
from `spec_lock.md`
- If resuming mid-deck, read the latest completed SVG and current image metadata when images are used
-- Read the Step 6 flat core (`executor-base`, `shared-standards-core`, and the locked preset mode / visual-style files); for custom directions, reload every optional `*_references` file from `spec_lock.md` before applying the behavior, then only the branches selected by the condition table
+- Read the complete Step 6 always-on core exactly as listed in [`generate-pptx.md`](../generate-pptx.md); for custom directions, reload every optional `*_references` file from `spec_lock.md` before applying the behavior, then only the branches selected by the condition table
- Design Parameter Confirmation
- When structured, read the template Design Spec and each selected prototype once; retain unchanged references in the fresh context. A later bounded repair follows [`executor-base.md`](../../references/executor-base.md) §2.1 only while that context remains valid and uncompacted
- Generate pages sequentially from the retained planning artifacts. Use `page-context` only for the on-demand diagnostic/telemetry triggers in Executor §2.1, never as a routine pre-page load