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

docs: Morph pairs Slide-local groups at planning time; opaque photo sheets slice by grid; delegation keeps the three intents; visual review may deepen an existing fade, defers deck-wide soft hits, and names the parallel-subagent host form

hugohe3b431e1b9deee
diff --git a/skills/ppt-master/references/confirm-surface.md b/skills/ppt-master/references/confirm-surface.md
index f90097e4..687efdb7 100644
--- a/skills/ppt-master/references/confirm-surface.md
+++ b/skills/ppt-master/references/confirm-surface.md
@@ -8,7 +8,7 @@ What the Strategist needs to run the two-stage confirmation: the surface decisio
| Most recent explicit surface instruction | Branch |
|---|---|
-| The user explicitly delegates confirmation | Make the combined Stage-1 communication/template decision, install it, then present one complete final summary. Do not launch the page or fabricate UI receipts. |
+| The user explicitly delegates confirmation | Make the combined Stage-1 communication/template decision, install it, then present one complete final summary. Do not launch the page or fabricate UI receipts; delegation skips the page, not the craft — the three solution intents are still authored and the chosen one recorded with its reason. |
| The user asks for or agrees to personally confirm in chat, or declines the page | Use chat for both stages; Stage 1 includes the template/free-design choice. Do not launch the page, run `--wait-only`, or require UI-authored results. |
| No explicit instruction | Use the page. |
diff --git a/skills/ppt-master/references/image-generator.md b/skills/ppt-master/references/image-generator.md
index 62fc0649..d253bc84 100644
--- a/skills/ppt-master/references/image-generator.md
+++ b/skills/ppt-master/references/image-generator.md
@@ -117,7 +117,7 @@ A/B describe a hero or a local single-subject region; C/D are hero-page composit
A sheet generates compatible transparent **illustration**, **illustrated-icon**, or **decorative lettering** elements sharing rendering, deck-color treatment, and finish; subjects, silhouettes, weights, and jobs may differ, and SVG composes after slicing. Lettering is stable Layer 1 artwork, never page copy turned into an image.
-**Default — batch compatible elements; split when separate generation improves the result**: group illustrated-icon cues normally; group lettering by compatible letterform character and treatment (not font name); split for style, geometry, detail, quality, or semantic precision. A single element may use a keyed `1x1` sheet. Full-canvas or opaque images take the normal §4.1 path.
+**Default — batch compatible elements; split when separate generation improves the result**: group illustrated-icon cues normally; group lettering by compatible letterform character and treatment (not font name); split for style, geometry, detail, quality, or semantic precision. A single element may use a keyed `1x1` sheet. Full-canvas or opaque images take the normal §4.1 path; several opaque photos for a multi-cell layout may share one sheet under the same contract, sliced by `--grid` with `--inset` and no key color, `--trim`, or `--alpha`.
**Hard rule — a sheet is a generation source, not a slide asset**: never referenced from SVG; out of `spec_lock.md images` in Default, generation-only in Quick's context and manifest; only sliced element rows are placed.
diff --git a/skills/ppt-master/references/strategist-template.md b/skills/ppt-master/references/strategist-template.md
index 0e16d7ce..146da853 100644
--- a/skills/ppt-master/references/strategist-template.md
+++ b/skills/ppt-master/references/strategist-template.md
@@ -67,7 +67,7 @@ When the communication contract conflicts with the workspace, state the best-fit
| Style-only or Style + Brand | `pptx_structure.mode: flat`, `template_reuse_scope: style`; omit `template_adherence` and every structured mapping section |
| `mirror` / `layout` | `pptx_structure.mode: structured`, `template_adherence: strict\|adaptive` (mirror always `strict`); no legacy `baseline`, `template`, `preserve`, `layout_strategy`, or Layout-kind rows |
-A Style installed alongside Layout/Deck changes only Direction / method and never forces flat/structured routing; a literal `mirror` plan is compatible only when the Style segment requires no visual or topology change.
+A Style installed alongside Layout/Deck changes only Direction / method, never flat/structured routing; a literal `mirror` plan is compatible only when the Style segment requires no visual or topology change. Morph pairs Slide-local groups, never slots.
- **Master roster**: one `pptx_masters` row per Master as `<master_key>: <picker name>`, copied from the workspace roster. Keys are 1–64 ASCII letters/digits/dots/underscores/hyphens starting with a letter or digit; spaces belong only in the picker name. Master visuals are root-level atoms, never `<g>`.
- **Registered Layouts**: list used keys and only deliberately retained unused keys once as `<layout_key>: <master_key> | <PowerPoint layout name> | <prototype source>`. An unused Layout uses `template:<basename>`; a new adaptive Layout uses its first generated `P<NN>`. Reuse keys only for identical fixed atoms and slot ids/types/indices/bounds/bindings. Name authored keys after composition, never topic. Zero-slot Layouts are valid; never invent an empty `utility` kind or full-page fake slot.
diff --git a/skills/ppt-master/references/visual-review.md b/skills/ppt-master/references/visual-review.md
index ddd6c7cf..3ef6c305 100644
--- a/skills/ppt-master/references/visual-review.md
+++ b/skills/ppt-master/references/visual-review.md
@@ -19,7 +19,7 @@ Read inputs 2–5 once at the start, then iterate the batch sequentially: apply
| H1 | Out-of-bounds | element bbox outside `canvas.view_box` | shrink or reposition into canvas |
| H2 | Text overflow | text bbox extends past its visual container | reduce font-size or line-break |
| H3 | Text overlap | two `<text>` bboxes intersect (tspans within one text excluded) | reposition or resize |
-| H4 | Readability | contrast < 4.5 (small text) / < 3.0 (font-size ≥ 24px), or text directly atop a complex image with no scrim | when neither color is a brand token: position-only escape — add a `<rect>` scrim under the text, or raise the text to ≥ 24px so the 3.0 threshold applies; when either color is a brand token: do not edit → §1.1 |
+| H4 | Readability | contrast < 4.5 (small text) / < 3.0 (font-size ≥ 24px), or text directly atop a complex image with no scrim | when neither color is a brand token: position-only escape — add a `<rect>` scrim under the text, raise the text to ≥ 24px so the 3.0 threshold applies, or deepen the stops of a `decoration` gradient already under the text (same geometry and technique, sibling pages of that Layout alike); when either color is a brand token: do not edit → §1.1 |
| ~~H5~~ | Font-ramp drift | covered by `svg_quality_checker.py` (§0) | n/a |
| H6 | Element collision | rect/circle/path bboxes overlap with z-order violating semantics | open spacing |
| H7 | Declared page chrome displaced | page number / header / footer explicitly declared by `design_spec §IX`, `spec_lock.md`, or the installed template with a concrete anchor is covered, missing, or outside `canvas.view_box` | restore only that declared chrome; never invent undeclared chrome |
@@ -34,7 +34,7 @@ If H4 fires and the foreground or background is a brand token from `spec_lock.md
## §2 Soft rules (act only when clearly bad)
-When in doubt, leave it — under-fixing beats oscillation.
+When in doubt, leave it — under-fixing beats oscillation. A soft hit whose same condition plainly recurs on pages outside the batch is a deck-wide choice: leave it, record it under `untouched_concerns` with reason `deck_wide`, and the aggregating agent applies or drops it once for every page.
| # | Category | Trigger | Fix direction |
|---|----------|---------|---------------|
@@ -90,7 +90,7 @@ One file per page at `<project>/.review/<page>.json`; every `needs_human_items`
"verified_in_iter": 2,
"backup_path": ".review/backup/02_three_steps.iter1.svg"
}],
- "untouched_concerns": [{"rule": "S1", "evidence": "...", "reason": "soft-cap reached" | "ambiguous_design_intent"}],
+ "untouched_concerns": [{"rule": "S1", "evidence": "...", "reason": "soft-cap reached" | "ambiguous_design_intent" | "deck_wide"}],
"needs_human_items": [{"rule": "H9", "suggested_fix_summary": "Hero subtitle declared in spec §IX.4 missing; add a <text> at (80,496) per design language"}],
"design_intent_check": {"spec_says": "TL;DR — emphasize 意图 as the core abstraction", "render_delivers": true, "note": "..."}
}
diff --git a/skills/ppt-master/workflows/stages/visual-review.md b/skills/ppt-master/workflows/stages/visual-review.md
index 8b4f96bb..34456529 100644
--- a/skills/ppt-master/workflows/stages/visual-review.md
+++ b/skills/ppt-master/workflows/stages/visual-review.md
@@ -48,7 +48,7 @@ Agent(team_name="visual-review-<project>", subagent_type="general-purpose", name
The orchestrator partitions N pages into batches of ≤ K (default 5) and spawns one subagent per batch in parallel; each subagent reads the fixed inputs once, then iterates its pages. The orchestrator prompt is self-contained and the single place stating dispatch shape, batch size, and forbid lists; it carries (absolute paths): `<project_path>`; the full page list with `page_role` and each successful renderer record's `canvas` (parse `design_spec.md` §IX — **fixed compatibility default**: a `design_spec.md` without §IX uses `content` for every page and flags it in the report; a missing `design_spec.md` is restored through [`failure-recovery.md`](../governance/failure-recovery.md) §3 first); batch size K (10 for token-sensitive large decks, 3 for high-fidelity short decks — rubric §6.1); iteration budget (default 1; 2 only for final-cut runs — see the appendix); the rubric path; the Style Review Focus excerpt with its wording and source path when found; the dispatch contract reference (rubric §6); and the subagent forbid list (no edits to other pages, `design_spec.md`, `spec_lock.md`, `templates/`, `animations.json`, `image_prompts.json`, `images/`).
-**Host compatibility**: `TeamCreate` and `SendMessage` are Claude-Code primitives; on other hosts the main agent processes the same batches sequentially with the same prompts — token savings persist, wall-clock grows roughly N/K-fold.
+**Host compatibility**: `TeamCreate` and `SendMessage` are Claude-Code primitives; a host with parallel anonymous subagents runs the batches in parallel with the main agent aggregating their returned reports; elsewhere the main agent processes the same batches sequentially with the same prompts — token savings persist, wall-clock grows roughly N/K-fold.
---