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(composition): deepen structural and narrative orchestration
hugohe3fbe908992085
diff --git a/skills/ppt-master/references/executor-structure.md b/skills/ppt-master/references/executor-structure.mdindex 917c4fda..74f6545b 100644--- a/skills/ppt-master/references/executor-structure.md+++ b/skills/ppt-master/references/executor-structure.md@@ -32,17 +32,17 @@ Combine atoms as needed; never force a named business model. Numbers used only a| Role | Job ||---|---|| `field` | Page/local region where a relationship operates |-| `node` | Semantic unit, state, actor, item, or group |-| `spine` | Explicit/implied scaffold establishing reading direction |-| `edge` | Necessary connection, branch, dependency, or transition |-| `label` | Text attached to a node, edge, region, or relationship |+| `node` | Semantic unit, state, actor, item, or group; may punctuate a drawn carrier as a stop, turn, junction, or bridge |+| `spine` | Explicit/implied scaffold or continuous carrier establishing reading direction |+| `edge` | Necessary semantic connection, branch, dependency, or transition |+| `label` | Text/evidence attached directly or by a non-relational leader/tether to a node, edge, region, or relationship || `garnish` | Non-semantic accent added after the relationship works || Operation | Job ||---|---|-| `repeat` | Create peers from one role |+| `repeat` | Create peers from one visual family; clone the full contour only when their structural states match || `arrange` | Establish order, alignment, rhythm, rank, comparison |-| `transform` | Vary scale, rotation, crop, fill, or emphasis meaningfully |+| `transform` | Vary scale, rotation, crop, fill, emphasis, or entry/continuation/turn/terminal port state meaningfully || `connect` | Add an edge when layout/containment is insufficient || `region` | Partition, contain, intersect, band, or layer fields || `attach` | Bind labels, badges, annotations, or evidence to an owner |@@ -61,14 +61,14 @@ invent a relationship.Choose the field and map required atoms, then follow:-**Mandatory — spine → nodes → connectors → labels → garnish**:+**Mandatory — spine/topology → nodes → connectors → labels → garnish**:| Layer | Completion evidence ||---|---|-| `spine` | Entry, direction, and organizing path are clear |-| `nodes` | Every required unit has one home and intentional weight; each is direct content or a §2-approved carrier |-| `connectors` (`edge`) | Only unresolved links become edges; route/source/target is clear; every drawn edge passes §2 |-| `labels` | Copy and caveats visibly attach to what they explain |+| `spine` | Entry, direction, and organizing path are clear; reversal, cycle, split/merge, or stage change reshapes a continuous carrier before node placement |+| `nodes` | Every required unit has one home and intentional weight; each is direct content or a §2-approved carrier; carrier-crossing nodes intentionally continue, stop, turn, join, or bridge its visible path |+| `connectors` (`edge`) | Only unresolved semantic links become edges; route/source/target is clear; every drawn edge passes §2 |+| `labels` | Copy and caveats visibly attach directly or by leader/tether to what they explain; when a node has multiple text roles, cue → claim/value → support → note remains perceptibly descending and absent roles stay absent || `garnish` | Removing accents leaves all meaning intact |**Hard rule — relationship before styling**: establish atoms, field, spine, nodes, and necessary edges before palette, type, effects, or containers. Prefer containment, alignment, baselines, and proximity; add lines/Connectors only for real edges, never to make a page look process-like.diff --git a/skills/ppt-master/references/shared-standards-core.md b/skills/ppt-master/references/shared-standards-core.mdindex 5ad9eb04..004cf597 100644--- a/skills/ppt-master/references/shared-standards-core.md+++ b/skills/ppt-master/references/shared-standards-core.md@@ -15,7 +15,9 @@ Mandatory reference for every route that authors or regenerates slide visuals th| Concern | Shared default ||---|---|| Text-block rhythm | Use §4.2 leading. Make the baseline step into a new paragraph visibly larger than the intra-paragraph line step; keep the extra gap between list items smaller than paragraph separation but large enough to scan each item. Repeated peer blocks share one rhythm unless their hierarchy differs. |+| Typography roles | Use the fewest semantic text roles that preserve hierarchy, and make their differences legible at slide-thumbnail scale. Consolidate near-neighbor sizes that serve the same role; otherwise distinguish roles through a deliberate combination of size, weight, color, position, and surrounding space. || Natural wrapping | Break at semantic phrase or punctuation boundaries where possible. Reflow the text frame or adjust neighboring geometry before using any permitted local size reduction. Let the final line run naturally shorter; avoid mechanically equal lines or a stranded single-character / single-word line when an earlier natural break preserves meaning. |+| Content field | Establish the usable body frame before placing modules. Divide it into a small set of unequal-weight macro-regions from information weight and reading order, then give each region its own local axes / micro-grid while retaining only the cross-region anchors the composition needs. On a dense page, let the planned content system organize that frame; create breathing room through gutters, module spacing, and intentional voids between semantic clusters. Unorganized residual space that leaves content stranded in one part of the frame is leftover blank, not negative space. || Alignment and proximity | Establish shared axes from the current composition. Align related titles, copy, labels, images, and diagram nodes to those edges, centers, or baselines; group related elements more tightly than unrelated groups so spacing carries hierarchy. Break an axis only when the offset performs hierarchy, direction, or tension. || Visual weight | Judge weight from area, darkness, saturation, density, stroke, image detail, and elevation together. Distribute it to support the focal path; symmetry is optional, and deliberate imbalance may create direction. || Containers | Use a card or panel when it expresses grouping, hierarchy, boundary, capacity, or a distinct material plane. Otherwise prefer spacing, rules, or direct text / geometry; peer containers share treatment unless a semantic difference justifies contrast. |diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.mdindex d6058c2c..3a0088c7 100644--- a/skills/ppt-master/references/strategist.md+++ b/skills/ppt-master/references/strategist.md@@ -504,7 +504,7 @@ includes transitions.- **Custom behavior is concise and executable**: For confirmed `custom` mode or visual style, project one resolved `mode_behavior` / `visual_style_behavior` sentence or short paragraph. When the direction actually combines or borrows catalog entries, also project the exact, comma-separated `mode_references` / `visual_style_references`; omit the field for a genuinely novel direction and never fabricate a nearby reference. Preserve the confirmed direction, reference locked role names such as `colors.primary` when needed, and omit selection history, contradictions, precedence explanations, or other Design Spec provenance. Executor reads these fields from the retained lock and loads every referenced catalog entry once per valid context.- **page_rhythm is mandatory**: Based on the page list in §IX Content Outline, assign each page one of `anchor` / `dense` / `breathing`. This is what breaks the uniform "every page is a card grid" feel. New locks may not omit the section; consumer omission behavior is owned by [`executor-base.md`](executor-base.md) §2.1.- **Fact IDs and scenario labels are mandatory when applicable**: Read any `sources/*.facts.json`. For each §IX page, list the stable IDs actually used; never cite an ID whose claim is absent from the page. Mark invented KPIs/targets/internal ratios as `Data class: scenario` and state which values are scenario data. Executor carries external sources into notes/footnotes and renders a visible scenario label for scenario figures.- - **Mandatory — whole-roster rhythm check**: During the same §IX composition, compare neighbors and section arcs to judge whether chapter entries visibly reset, extended same-density runs are intentional, repeated dominant geometry carries a continuity job, each section follows a mode-fitting progression—including framework → explanation/evidence → judgment/action when it serves the objective—and a genuine ending lowers information load. Repair the existing roster, `Layout`, and `page_rhythm` choices in place. This is judgment, not quota; preserve intentional continuity, legitimately all-`dense` material, and 1:1/literal order. Do not invent filler pages to manufacture rhythm; a `breathing` page marks a meaningful pause—chapter transition, standalone emphasis, or SCQA bridge—and must stand alone. Create no field, lock row, artifact, or second review/execution pass.+ - **Mandatory — whole-roster rhythm check**: During the same §IX composition, compare neighbors and section arcs to judge whether chapter entries visibly reset, extended same-density runs are intentional, extended same-carrier or same-topology runs form an intentional semantic sub-arc, repeated dominant geometry carries a continuity job, each section follows a mode-fitting progression—including framework → explanation/evidence → judgment/action when it serves the objective—and the final arc resolves the communication objective before a genuine ending lowers information load. Repair the existing roster, `Layout`, and `page_rhythm` choices in place. This is judgment, not quota; preserve intentional continuity, legitimately all-`dense` material, and 1:1/literal order. Do not invent filler pages to manufacture rhythm; a `breathing` page marks a meaningful pause—chapter transition, standalone emphasis, or SCQA bridge—and must stand alone. Create no field, lock row, artifact, or second review/execution pass.- **Cover impact is mandatory**: In `design_spec.md §IX`, give `P01` one concrete hook from the source's strongest claim, metaphor, number, moment, or conflict plus a recommended composition. The hook binds; Executor may adapt the composition to prepared assets and explicit constraints. With no suitable image, recommend a native-SVG hook instead of a generic title treatment. Beautify / template-fill preservation paths are exempt.- **Cover rhythm lock**: `P01` remains `anchor`. Default away from generic content-page templates; a card grid, agenda, or equal-weight columns remains valid when content, user direction, or the template makes it the clearest cover.- **Closing impact (only when the deck closes)**: For a genuine conclusion / CTA / final takeaway, name the binding takeaway plus a recommended composition; Executor may adapt the latter. Do not default to an information-empty "Thank you", contact-only slide, or cover reprise; an explicit contact/event CTA may serve the purpose. **Do NOT invent a closing page to satisfy this**. Preservation paths are exempt.diff --git a/skills/ppt-master/workflows/create-template/create-style.md b/skills/ppt-master/workflows/create-template/create-style.mdindex 37482218..92d9f464 100644--- a/skills/ppt-master/workflows/create-template/create-style.md+++ b/skills/ppt-master/workflows/create-template/create-style.md@@ -36,6 +36,8 @@ Use every supplied reference only as evidence for reusable method and design def| Brand or organization material | A lower-priority fallback direction when the user explicitly wants it generalized | Official identity truth, logos, proprietary palettes, brand voice, or trademarked presentation rules || Existing mode, visual-style, or image-rendering catalog entry | A preferred catalog seed plus a concise Style-owned overlay | A duplicated copy of the catalog file |+**Mandatory — series-aware PPTX analysis**: Before inferring cross-page cadence from a composite PPTX reference, distinguish coherent finished-deck series from page/layout libraries. Infer cadence only within each coherent series; treat library pages as independent composition evidence, never as one ordered narrative run.+Preserve source provenance in `Style Overview`. Keep exact user-authored method decisions distinct from AI-derived defaults. Reject organization-confidential examples and do not generalize proprietary frameworks into a reusable Style.**Reference — not a constraint**: A Style may prefer a catalog mode, visual style, image rendering, fallback palette, or fallback font stack. These values seed the normal Stage-2 solution; they are not execution locks and never bypass user confirmation.diff --git a/skills/ppt-master/workflows/profiles/quick-generate.md b/skills/ppt-master/workflows/profiles/quick-generate.mdindex dfe05185..5cb3d161 100644--- a/skills/ppt-master/workflows/profiles/quick-generate.md+++ b/skills/ppt-master/workflows/profiles/quick-generate.md@@ -227,10 +227,12 @@ Before writing P01, resolve in active context:**Mandatory — whole-roster rhythm check**: During the same active-contextresolution, compare neighbors and section arcs to judge whether chapter entries-visibly reset, extended same-density runs are intentional, repeated dominant+visibly reset, extended same-density runs are intentional, extended same-carrier+or same-topology runs form an intentional semantic sub-arc, repeated dominantgeometry carries a continuity job, each section follows a mode-fittingprogression—including framework → explanation/evidence → judgment/action when-it serves the objective—and a genuine ending lowers information load. Repair+it serves the objective—and the final arc resolves the communication objective+before a genuine ending lowers information load. Repairthe transient roster, density, and composition choices in place. This isjudgment, not quota; preserve intentional continuity, legitimately all-`dense`material, and 1:1/literal order. Add no filler page: a `breathing` page marks a