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(native-shapes): require page-scale geometry decisions

hugohe3d05d3c18d3ba
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.md
index e610fcdd..c00809dc 100644
--- a/skills/ppt-master/references/executor-base.md
+++ b/skills/ppt-master/references/executor-base.md
@@ -191,14 +191,18 @@ unfiltered full-registry discovery. Decide every page-fit contour and its
simplest exact authoring form directly from the page content and visual system;
no Design Spec capability suggestion or material inventory gates this choice.
-**Mandatory — independent per-page compound-shape decision**: after the
-Structure result and any applicable topology resolve, decide whether two or more
-native shapes would organize the background, zones, hierarchy, or reading path
-better than a simpler composition. This applies to both `Structure=no` and
-`Structure=yes`, stays in active context, and never changes that result. If yes,
-use [`native-shape-authoring.md`](./native-shape-authoring.md) §2.1; otherwise
-keep the simpler composition. There is no coverage target or required
-explanation for declining it.
+**Mandatory — independent per-page geometry move**: after the Structure result
+and any applicable topology resolve, but before writing coordinates, choose one
+page-scale geometry move from the actual content, visual system, and complete
+native vocabulary. Compare a deliberate plain / neutral construction with
+[`native-shape-authoring.md`](./native-shape-authoring.md) §2.1's page-field,
+outline, nesting, continuity, depth / contrast, and contour-change lenses.
+Readability alone does not select the simple branch; a plain grid or no compound
+construction remains valid when it is the deliberate best fit for the page job.
+This applies to both `Structure=no` and `Structure=yes`, stays in active context
+until the page is complete, and never changes that result. Use §2.1 whenever the
+move adopts two or more native shapes. There is no coverage target or required
+explanation for a simple result.
**Default — do not use rectangles as the universal carrier (may use when a
neutral field is the best fit)**: before drawing another `<rect>` / rounded
diff --git a/skills/ppt-master/references/native-shape-authoring.md b/skills/ppt-master/references/native-shape-authoring.md
index c648f848..142f01c0 100644
--- a/skills/ppt-master/references/native-shape-authoring.md
+++ b/skills/ppt-master/references/native-shape-authoring.md
@@ -106,15 +106,19 @@ owned by the preserve/mirror round-trip contract.
**Trigger**: after the page or prototype's communication / slot job, composition
anchors, and any applicable topology under
-[`executor-structure.md`](./executor-structure.md) are resolved, use this method
-when two or more native shapes can strengthen its background field, content
-zoning, focal hierarchy, or reading path. This method applies whether the
-per-page Structure result is `no` or `yes`; it never creates a decoration
-requirement.
+[`executor-structure.md`](./executor-structure.md) are resolved, but before
+writing coordinates, resolve the page-scale geometry move that best carries its
+background field, content zoning, focal hierarchy, or reading path. Compare a
+deliberate plain / neutral composition with the useful lenses below. Readability
+of the first workable arrangement does not close this gate; a plain grid or no
+compound construction remains valid when it is the deliberate best fit for the
+page job.
+This applies whether the per-page Structure result is `no` or `yes`; it never
+creates a decoration requirement.
| Pass | Action | Result |
|---|---|---|
-| Page job | Name the geometric jobs already implied by the resolved page: surface, boundary, direction, reveal, focal mark, shared region, or counterweight. | A small set of functional zones; no shape names yet. |
+| Page job | Name the page-scale geometry move, then the geometric jobs already implied by the resolved page: surface, boundary, direction, reveal, focal mark, shared region, or counterweight. | One composition direction and a small set of functional zones; no shape names yet. |
| Decompose | Separate visible content from geometric atoms. Identify which atoms need independent movement, paint, or reuse and which contour must become one object. | Editable siblings plus any explicit Boolean operand set. |
| Select | Choose each atom's contour from its job and the full native vocabulary, then apply §1's simplest exact materialization. | Page-fit native atoms without syntax bias. |
| Compose | Establish page frame, scale, z-order, and negative space with independent atoms. Keep text, images, icons, data marks, and non-merged accents outside Boolean operands. | One page-level geometry system, not a collection of unrelated decorations. |
diff --git a/skills/ppt-master/references/visual-styles/data-journalism.md b/skills/ppt-master/references/visual-styles/data-journalism.md
index fc2332c8..8b25d894 100644
--- a/skills/ppt-master/references/visual-styles/data-journalism.md
+++ b/skills/ppt-master/references/visual-styles/data-journalism.md
@@ -26,7 +26,7 @@ Bloomberg / Economist news-infographic — publication-grade information density
## 4. Texture / elevation
-- Flat, publication-grade — hairline rules over heavy cards; optional scrim on any image; no glow, no decorative shadow.
+- Flat, publication-grade — when either carries the relationship, favor hairline rules over heavy cards. Flatness governs visual weight, not contour vocabulary; outlined or compound page fields remain compatible. Optional scrim on any image; no glow, no decorative shadow.
## 5. Paired image-rendering
diff --git a/skills/ppt-master/workflows/profiles/quick-generate.md b/skills/ppt-master/workflows/profiles/quick-generate.md
index 97a63b52..045a005a 100644
--- a/skills/ppt-master/workflows/profiles/quick-generate.md
+++ b/skills/ppt-master/workflows/profiles/quick-generate.md
@@ -276,7 +276,7 @@ the roster after the whole-roster check:
- the canvas, visual direction, wording, intended viewing distance, and effective reading mode: choose `presentation` for distance-first projected or recorded viewing, `balanced` for mixed viewing, or `text` for close content-heavy reading. Take the initial body anchor and sanity band from [`canvas-formats.md`](../../references/canvas-formats.md) § "Typography Scale Start" for the resolved canvas—PPT remains reading-mode-driven, while registered/custom non-PPT canvases use their canvas-derived start—then resolve one concrete typography plan for the delivery target defined by [`shared-standards-core.md`](../../references/shared-standards-core.md) §4.1, never from the authoring host's font inventory, with stable size anchors for title, body, annotation, and every other recurring role the roster uses. When content does not fit, preserve its core message and apply only fitting actions the source/profile invariants permit—restructure, shorten, or split; if none is permitted, surface the unresolved fit instead of shrinking a recurring role. Explicit user, template, fidelity-profile, or resolved-style requirements may call for a deliberate exception;
- the semantic color roles actually needed by the roster, each with a concrete active-context color anchor, including background/surface, primary/secondary text, dominant/accent, and status roles as applicable. Honor explicit user, installed template/brand, fidelity-profile source-identity, and resolved-style color semantics before deriving only the missing roles that the active profile permits; decide which roles dominate, support, or remain rare, and preserve sufficient contrast for meaning-bearing text. Pair newly authored color-coded states, categories, or relationships with a label, symbol, line, or geometry cue; when fidelity forbids adding one, preserve the source encoding;
- an ordinary body-content frame and a density judgment for every page, adapted to the canvas and any user / template / style geometry; use `anchor`, `dense`, `breathing`, or an equivalent active-context distinction instead of one uniform fill level;
-- for each page not bound to literal supplied geometry, a primary visual zone and page-scale composition direction tied to its core message; use cards or equal grids when the content relationship calls for them, not as the automatic page grammar;
+- for each page not bound to literal supplied geometry, a primary visual zone and one compact page-scale geometry job tied to its core message—what geometry must organize, without naming a preset or encoding form; keep it only in the transient roster for §3's authoring-time move. Use cards or equal grids when the content relationship calls for them, not as the automatic page grammar;
- for each page, preserve its semantic units, source-stated qualitative relationships, intended entry, and outcome so §3 can make the sole Structure decision before geometry;
- when useful, a transient deck-level visual motif system with an identity or
communication job, a recognizable invariant, and a reuse mode: fixed chrome,
@@ -507,7 +507,8 @@ Reread only after a known file change or context invalidation.
`Structure=yes` result can apply its qualitative topology grammar.
`native-shape-authoring.md` independently owns contour selection and compound
page geometry for both Structure results. Reuse both throughout the valid
-execution context; reread only after a known file change or context invalidation.
+execution context; before P01, complete its unfiltered full-registry discovery,
+then reread only after a known file change or context invalidation.
**Mandatory — per-image-page composition decision**: For every page with one
or more images, after its content and communication move are
@@ -530,7 +531,7 @@ whole-object carrier, and author canonical SVG `<a href>` under
[`native-hyperlinks.md`](../../references/native-hyperlinks.md). Never guess an
unknown destination.
-Image to PPTX replaces the open image-composition and compound-shape decisions
+Image to PPTX replaces the open image-composition and page-geometry decisions
for its canonical page frame: preserve the source geometry, restore text
natively, preserve source-graphic identity through the prepared exact or
reconstructed asset, and use the active-context registered layer/plate stack
@@ -550,14 +551,18 @@ artifact, spec, lock, manifest, or extra pass.
This decision is mandatory on every page and cannot be satisfied by the
capability menu, visualization recall, template geometry, or a later check.
-**Mandatory — independent per-page compound-shape decision**: after the
-Structure result and any applicable topology resolve, decide whether two or more
-native shapes would organize the background, zones, hierarchy, or reading path
-better than a simpler composition. This applies to both `no` and `yes`, stays in
-active context, and never changes the Structure result. If yes, use
-[`native-shape-authoring.md`](../../references/native-shape-authoring.md) §2.1;
-otherwise keep the simpler composition. There is no coverage target or required
-explanation for declining it.
+**Mandatory — independent per-page geometry move**: after the Structure result
+and any applicable topology resolve, but before writing coordinates, resolve one
+page-scale geometry move from the transient geometry job, actual content,
+resolved style, and complete native vocabulary. Compare a deliberate plain /
+neutral construction with
+[`native-shape-authoring.md`](../../references/native-shape-authoring.md) §2.1's
+composition lenses. Readability alone does not select the simple branch; a plain
+grid or no compound construction remains valid when it is the deliberate best
+fit for the page job. This applies to both `no` and `yes`, stays in active context
+until the page is complete, and never changes the Structure result. Use §2.1
+whenever the move adopts two or more native shapes. There is no coverage target
+or required explanation for a simple result.
| Deterministic trigger | Additional authority |
|---|---|
@@ -714,7 +719,9 @@ or lock.
- [x] All required source/resource preparation is complete
- [x] One mode and visual style were resolved, and every catalog source actually used was read
+- [x] The complete native preset registry was read unfiltered before P01
- [x] Every page considered suitable carrier combinations without a coverage quota or single-carrier assumption
+- [x] Every page not bound to literal supplied geometry carried its transient geometry job into an authoring-time page-scale move, and the whole-roster rhythm check confirmed that any extended same-carrier or same-topology run serves an intentional semantic arc
- [x] Image need was decided independently of credentials; any zero-image deck is backed by an explicit no-image requirement or a roster whose visual burden is fully carried by charts / native SVG
- [x] Every `slice_names` output exists after an exit-0 strict-alpha run, and no page whose chosen composition depends on a slice was authored or exported without it
- [x] Every image-bearing page made its one pre-geometry composition decision