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(image-generation): trigger decorative lettering proactively
hugohe389a9a43f89f8
diff --git a/skills/ppt-master/references/image-generator.md b/skills/ppt-master/references/image-generator.mdindex ea25b8a0..7da75256 100644--- a/skills/ppt-master/references/image-generator.md+++ b/skills/ppt-master/references/image-generator.md@@ -595,6 +595,13 @@ C (AI-generated) supports three implementation modes sharing one `image_prompts.| `IMAGE_BACKEND` not configured (or Path A fails) AND host has a native image tool | **Path B**: Host-native tool | Agent invokes the host's image capability; outputs land at `project/images/<filename>` || **Both Path A and Path B fail/unavailable** | **Offline Manual Mode** | Manifest stays on disk; user generates externally from `items[].prompt` and places files at `project/images/<filename>` |+**Callable-generator test for proactive planning**: Path A counts when+`IMAGE_BACKEND` is configured; Path B counts when the current host exposes a+native image-generation tool. Offline Manual alone, web search, and a+vision-only tool do not count. This predicate allows Strategist/Quick to add+decorative-lettering resources proactively; it never overrides an explicit or+confirmed image-source/path choice.+**Quick Generate selection**: an explicit user instruction for `api`, `host-native`, or `manual` retained in active context wins. When the user did not specify a path, select `auto` and run the A → B → C chain without asking or creating a planning artifact.**Default Generate selection — declared-procedure fallback when no path is confirmed**: the confirmed user choice wins. When neither channel confirmed a specific path, Generate Step 4 records the effective choice as `auto`; that explicit durable value uses the automatic A → B → C chain. A missing/blank/unknown project value is not an implicit API authorization:diff --git a/skills/ppt-master/references/strategist-image.md b/skills/ppt-master/references/strategist-image.mdindex b5ceb515..9ecb46e1 100644--- a/skills/ppt-master/references/strategist-image.md+++ b/skills/ppt-master/references/strategist-image.md@@ -18,6 +18,17 @@ For illustration, apply this precedence: confirmed `none` → explicit user inte**Default — one coherent sheet for compatible same-family spots or lettering elements (may override when aspect, detail, quality, or semantic needs differ)**: prefer one Illustration Sheet when several AI-generated spots or stable decorative-lettering elements can share a useful cell shape and production treatment; generate them independently when forcing one sheet would weaken a planned element. When a sheet is chosen, plan one unplaced `ai` Illustration Sheet row plus one placed `slice` row per used element; only slice rows enter `spec_lock.md images`. State the intended placement shape family in the sheet reference. For lettering, also record every exact string, set the sheet to `text_policy: embedded`, and keep authoritative title/chrome wording outside the sheet. Use separate sheets for incompatible shapes or treatments. [`image-generator.md`](./image-generator.md) §4.3 owns grid, ratio, slicing, and execution details. Final Stage 2 chooses the AI execution path under `image-generator.md` §7; do not pre-empt or re-pick it here.+**Mandatory — materialize proactive lettering**: When confirmed image usage+retains `ai`, the effective acquisition path has a callable Path A/B, and the+complete page roster contains a suitable stable cover/divider hook, collect the+small compatible set once before writing §VIII. Use one ordinary `ai` row for a+single hook, or the sheet/element rows under §4.3 for several compatible hooks,+and record every exact character sequence; do not leave the choice as an+`image_notes` or §IX suggestion only. A confirmed `none`, explicit no-AI+instruction, editable-only hook, or Offline Manual path does not activate this+proactive rule; an explicit user-required lettering asset still follows the+ordinary resource contract.+**Mandatory — image-treatment path scan, not a quota**: Per selected image choose `none` (unchanged), `native` (SVG crop/clip, transform, opacity, frame/depth, overlap), or `prepared derivative` (separate pixel blur/tone or cutout/registered layers); `none` is valid.When a subject crosses a native title, panel, frame, or shape, the prepared path is mandatory: plan a clean full-canvas base plus minimum registered RGBA layers; set full-canvas members `no-crop`; name their shared source/registration in `Reference`; suggest `#A2-03`. A shared plate requires padded-bbox-disjoint objects and independent final crops. Use `user` only when every final asset is supplied, otherwise `ai`; [`image-generator.md`](./image-generator.md) §4.4 owns preparation. An independent floating cutout may use `#A2-01`.diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.mdindex 15198854..b1b95ee1 100644--- a/skills/ppt-master/references/strategist.md+++ b/skills/ppt-master/references/strategist.md@@ -287,6 +287,15 @@ owns SVG authoring under [`native-hyperlinks.md`](./native-hyperlinks.md).**Default — evidence before synthesis (may override when explicit source constraints or the communication intent require another permitted source)**: Prefer `provided` when supplied assets already carry authority. Propose `web` when the actual appearance of an externally verifiable subject is material; propose `ai` when custom expression matters more than documentary identity. Mixed sources may serve different page roles. This is a source-fit decision, not an image quota.+**Mandatory — proactive decorative-lettering scan**: Before each Stage-2+`recommend.image_usage`, treat a configured `IMAGE_BACKEND` or host-native image+generator as callable; Offline Manual, web, and vision-only access do not+qualify. If callable and planned cover/divider wording contains an exact stable+hook suited to illustrative lettering, include `ai` plus its role in+`image_notes.value` without waiting for a request. Never invent or rewrite copy+to trigger it. Explicit no-AI or editable-only requirements win. Execution+follows [`image-generator.md`](./image-generator.md) §7.+**Recommendation output**: Write `recommend.image_usage` as one source id or an array for mixed sources. Put page roles, authoritative assets, preferred/avoided imagery, and placeholder tolerance in `image_notes.value`. `none` is exclusive. Generic human-scale topics such as family life, education, wellness, or children lean `ai` when no supplied asset carries the story; regulated investor decks, B2B finance reports, and data-only dashboards remain eligible for `none` by judgment.**Confirmed value wins**: Accept the confirmed legacy string or multi-select array. Map `ai→ai`, `web→web`, `provided→user`, and `placeholder→placeholder` into §VIII `Acquire Via`. Every direction already carries a rendering candidate whether or not AI is proposed; generated images inherit the deck colors and never introduce a second image-palette choice.diff --git a/skills/ppt-master/workflows/profiles/quick-generate.md b/skills/ppt-master/workflows/profiles/quick-generate.mdindex a066bb5a..ed6a33be 100644--- a/skills/ppt-master/workflows/profiles/quick-generate.md+++ b/skills/ppt-master/workflows/profiles/quick-generate.md@@ -320,6 +320,20 @@ the complete carrier menu once and choose only the forms that communicate itscontent best. A decision to use none of a carrier is valid; skipping the scanbecause Quick is expected to be faster is not.+**Mandatory — proactive AI decorative lettering**: Apply+[`image-generator.md`](../../references/image-generator.md) §7's+callable-generator test before SVG authoring: a configured `IMAGE_BACKEND` is+Path A and a host-native image-generation tool is Path B; Offline Manual, web+search, or vision-only access does not qualify. When Path A/B is callable and+the user has not forbidden AI, scan the frozen roster's cover/divider wording+for stable keywords or short hooks. If a suitable set exists, prepare it without+a separate request: preserve the exact approved strings, use one ordinary AI+item for a single hook or batch several compatible marks through one+Illustration Sheet and transparent slices, and keep ordinary title/chrome copy+native. A hook that must remain editable uses ordinary text. Offline Manual+alone does not trigger this proactive path; explicit user-required lettering+still follows the normal resource contract.+| Communication job | Available carrier ||---|---|| Real subject, place, product, evidence, atmosphere, or scene benefits from visual grounding | Supplied/extracted, web, AI, or sliced image |@@ -329,7 +343,7 @@ because Quick is expected to be faster is not.| Sequence, hierarchy, role, region, or relationship determines page-local topology | Qualitative structure || Rows, columns, cells, headers, merges, and alignment form the information model | Cell-grid table || Mathematical notation is clearer as typeset math than ordinary text | PowerPoint-native inline or block math |-| A small set of stable cover/divider keywords needs a material, dimensional, hand-rendered, or otherwise illustrative treatment beyond ordinary text | Prepare one AI Illustration Sheet plus transparent slices when the elements are compatible; place the slices as images and keep ordinary editable title/chrome in separate text frames. Choose ordinary text before acquisition when editability or available tooling makes it the better carrier |+| A small set of stable cover/divider keywords needs a material, dimensional, hand-rendered, or otherwise illustrative treatment beyond ordinary text | Apply the proactive rule above; place prepared lettering assets as images and keep ordinary editable title/chrome in separate text frames || Typography, spacing, and simple geometry already carry the message | Use no additional visual carrier |This carrier menu does not satisfy or replace the per-page Structure decision in §3.