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.mdindex 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.mdindex 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.jsonindex 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.mdindex 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 coreRead 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 constructionRead references/semantic-svg.md # REQUIRED: semantic metadata boundaryRead references/modes/<resolved-id>.md # one preset id, or each `mode_references` idRead 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 motioninstruction, the effective Custom Animations outcome in `design_spec.md §I` isdiff --git a/skills/ppt-master/workflows/profiles/quick-generate.md b/skills/ppt-master/workflows/profiles/quick-generate.mdindex 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 AuthoringAlways 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 sourcedweb 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.mdindex 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 comefrom `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