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(image-layout): require action-bearing image compositions

hugohe35bf789f1641a
diff --git a/skills/ppt-master/references/executor-image.md b/skills/ppt-master/references/executor-image.md
index ebb568e6..27eae26e 100644
--- a/skills/ppt-master/references/executor-image.md
+++ b/skills/ppt-master/references/executor-image.md
@@ -27,7 +27,9 @@ Handle images by status; enum and lifecycle: [`svg-image-embedding.md`](svg-imag
**Template-bundled images**: [`apply-template-workspace.md`](../workflows/stages/apply-template-workspace.md) copies them into project `images/`. Outside `mirror`, reference `../images/<name>` and never copy a template SVG's bare sibling href: the rendered page lives in `svg_output/`. `mirror` ([`executor-structured.md`](./executor-structured.md) §1.1) keeps hrefs verbatim; export resolves them against `images/`.
-**Reference — layout catalog is optional recall**: Load [`image-layout-patterns.md`](./image-layout-patterns.md) only when an active suggestion cites `#<id>` or inspiration is useful; resolve only cited ids. Free-form suggestions need no catalog lookup. Adapt or decline the suggestion when the page communicates better, while preserving resource role/source, must-use, crop/content, and explicit user/template constraints. Expression-only changes need no upstream rewrite.
+**Reference — layout catalog is optional recall**: Load [`image-layout-patterns.md`](./image-layout-patterns.md) for a cited `#<id>` or useful recall; free-form suggestions need no lookup.
+
+**Default — action-bearing image composition (may override only for an upstream-documented restraint or explicit user/template/content boundary)**: On a `page_role: hero_page` or otherwise image-led page, realize the suggestion or replace it with another concrete image/content or image/shape relationship. Position, size, routine crop, and a legibility-only scrim alone do not constitute that relationship. A direct split or full-bleed treatment remains valid only when matching §IX `Layout` / `Images` records deliberate restraint or an explicit boundary requires it. Preserve role/source, must-use, crop/content, and explicit user/template constraints; expression-only changes need no upstream rewrite.
**Reference — motion-ready image layering, not a constraint**: For adopted §IX or an explicit focus, comparison, evidence, reveal-order, or cross-page requirement, decide during SVG authoring whether the final composition needs separate visible units. Keep ordinary stable framing/background static and wrap each independently revealed or continuing Slide-local unit in a descriptive direct-root `<g id>`; structured atoms/slots retain their boundaries. Existing units or a page transition may suffice. The motion stage owns effects, pairing, order, and timing.
diff --git a/skills/ppt-master/references/strategist-image.md b/skills/ppt-master/references/strategist-image.md
index 8a7de821..bedf2815 100644
--- a/skills/ppt-master/references/strategist-image.md
+++ b/skills/ppt-master/references/strategist-image.md
@@ -53,7 +53,9 @@ Add §VIII rows for the image resources actually planned from the confirmed sour
**Prepared-user fast path**: For initial imported or user-supplied assets confirmed as `provided`, copy the exact `Filename` basename and derive `Dimensions` / `Ratio` from that row's EXIF-corrected `Width` / `Height` / native `AspectRatio` in the latest `analysis/image_analysis.csv`; `SourceDisplayRatio` is source-context metadata, not the bitmap crop ratio. Drop source-side directories, set `Acquire Via: user` and `Status: Existing`, and decide the remaining §VIII fields normally. Existing §VIII / lock / provenance-manifest records override this inference. Assets declared as `ai`, `web`, `slice`, `formula`, or manual fulfillment retain that provenance and advance through their own status lifecycle after entering `images/`; location never reclassifies them as `user / Existing`.
-**Mandatory**: write one concise, non-empty, executable `Layout pattern` value per non-formula row in ordinary language. It may cite stable ids from [`image-layout-patterns.md`](./image-layout-patterns.md), but reading the library or using ids is not required. Preserve any cited id accurately; otherwise describe the composition without inventing one.
+**Mandatory**: write one concise, non-empty, executable `Layout pattern` per non-formula row in ordinary language; optional ids from [`image-layout-patterns.md`](./image-layout-patterns.md) must be exact.
+
+**Default — action-bearing image composition (may override when deliberate restraint is documented for the page)**: For a `page_role: hero_page` or otherwise image-led row, name a concrete image/content or image/shape relationship. Position, size, routine crop, and a legibility-only scrim alone do not constitute that relationship. A plain split or full-bleed treatment remains valid only when page-specific restraint is deliberate; state why in the matching §IX `Layout` / `Images`.
**Reference — not a constraint**: open [`image-layout-patterns.md`](./image-layout-patterns.md) only when its vocabulary would expand the current options. Techniques needing a cutout, blurred crop, or desaturated copy require that prepared asset. Executor may adapt, replace, or decline the suggestion while preserving resource role, file/source, must-use status, crop boundary, content, and explicit user/template constraints; layout-only changes need no upstream rewrite.
diff --git a/skills/ppt-master/scripts/prompt_audit_manifest.json b/skills/ppt-master/scripts/prompt_audit_manifest.json
index 1f2ae61b..1e987741 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": 399925
+ "max_tokens": 400200
},
"file_budgets": {
"AGENTS.md": 2400,
@@ -20,7 +20,7 @@
"skills/ppt-master/references/executor-base.md": 8250,
"skills/ppt-master/references/executor-structured.md": 5300,
"skills/ppt-master/references/executor-chart.md": 3100,
- "skills/ppt-master/references/executor-image.md": 1500,
+ "skills/ppt-master/references/executor-image.md": 1600,
"skills/ppt-master/references/executor-web-image.md": 500,
"skills/ppt-master/references/executor-notes.md": 900,
"skills/ppt-master/references/shared-standards.md": 250,
@@ -29,7 +29,7 @@
"skills/ppt-master/references/native-data-interface.md": 6200,
"skills/ppt-master/references/pptx-structure-interface.md": 4300,
"skills/ppt-master/references/strategist.md": 14225,
- "skills/ppt-master/references/strategist-image.md": 2500,
+ "skills/ppt-master/references/strategist-image.md": 2525,
"skills/ppt-master/references/strategist-template.md": 2100,
"skills/ppt-master/templates/design_spec_reference.md": 3275,
"skills/ppt-master/templates/spec_lock_reference.md": 2375,
@@ -184,7 +184,7 @@
"skills/ppt-master/references/artifact-ownership.md",
"skills/ppt-master/references/shared-standards-core.md"
],
- "max_tokens": 36525
+ "max_tokens": 36650
},
"route.generate.quick-generate.topic-research": {
"description": "Quick Generate with gap-targeted factual research before direct resource preparation and SVG authoring.",
@@ -194,7 +194,7 @@
"stage.generate.topic-research"
],
"files": [],
- "max_tokens": 38025
+ "max_tokens": 38150
},
"route.generate.quick-generate.icon": {
"description": "Quick Generate with project-local bundled icon selection and synchronization.",
@@ -205,7 +205,7 @@
"files": [
"skills/ppt-master/templates/icons/README.md"
],
- "max_tokens": 38425
+ "max_tokens": 38550
},
"route.generate.quick-generate.in-hand-image": {
"description": "Quick Generate with supplied, extracted, or placeholder image resources prepared before SVG authoring.",
@@ -215,7 +215,7 @@
"stage.generate.executor.image"
],
"files": [],
- "max_tokens": 43450
+ "max_tokens": 43675
},
"route.generate.quick-generate.formula": {
"description": "Quick Generate with manifest-driven formula rendering and formula-image realization.",
@@ -227,7 +227,7 @@
"files": [
"skills/ppt-master/scripts/docs/image.md"
],
- "max_tokens": 46650
+ "max_tokens": 46850
},
"route.generate.quick-generate.ai-two-types": {
"description": "Quick Generate with AI resource preparation, representative rendering inputs, and two local image types.",
@@ -238,7 +238,7 @@
"stage.generate.executor.image"
],
"files": [],
- "max_tokens": 66500
+ "max_tokens": 66700
},
"route.generate.quick-generate.web-image": {
"description": "Quick Generate with web resource preparation, provenance, attribution, and image execution.",
@@ -249,7 +249,7 @@
"stage.generate.executor.web-image"
],
"files": [],
- "max_tokens": 51200
+ "max_tokens": 51425
},
"route.generate.planning-image": {
"description": "Generate-PPTX planning context after a non-none image source is proposed or confirmed; layout-catalog recall remains optional.",
@@ -269,7 +269,7 @@
"stage.generate.strategist.image"
],
"files": [],
- "max_tokens": 64650
+ "max_tokens": 64750
},
"route.generate.planning-ai": {
"description": "Generate-PPTX planning when AI image direction is available, including representative multi-source custom rendering synthesis.",
@@ -790,7 +790,7 @@
"files": [
"skills/ppt-master/references/strategist-image.md"
],
- "max_tokens": 2500
+ "max_tokens": 2525
},
"stage.generate.strategist.image-layout": {
"description": "Optional image-layout catalog recall layered on image planning when the Strategist wants additional composition vocabulary.",
diff --git a/skills/ppt-master/workflows/profiles/quick-generate.md b/skills/ppt-master/workflows/profiles/quick-generate.md
index a5524fa8..2b3a3175 100644
--- a/skills/ppt-master/workflows/profiles/quick-generate.md
+++ b/skills/ppt-master/workflows/profiles/quick-generate.md
@@ -59,11 +59,14 @@ Before writing P01, resolve in active context:
- the slide roster, canvas, visual direction, palette, typography, and wording;
- a transient resource roster with page, filename, purpose, visual intent,
- acquisition path, crop behavior, and status;
+ acquisition path, crop behavior, and status; for a hero page or other
+ image-led use, the visual intent includes an action-bearing composition;
- the implementation path for each resource. An explicit user path wins;
otherwise choose the registered automatic/default path without another
interaction.
+**Default — action-bearing image composition (may override only for an explicit user/material boundary or a page-specific restraint decision)**: For a hero page or otherwise image-led resource, resolve one concrete image/content or image/shape relationship before SVG authoring. Position, size, routine crop, and a legibility-only scrim alone do not constitute that relationship. A plain split or full-bleed treatment remains valid only when the explicit boundary requires it or the agent records a page-specific restraint reason in active context; decide and continue without another interaction.
+
Prepare only the resource paths that the roster triggers:
| Resource | Required preparation |