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

feat(register): let each content block follow its natural expression mode

hugohe372e01db7a636
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.md
index 7dd512cd..29ebf79d 100644
--- a/skills/ppt-master/references/executor-base.md
+++ b/skills/ppt-master/references/executor-base.md
@@ -89,6 +89,10 @@ Before the first SVG page, output a confirmation listing: canvas dimensions, bod
**Hard rule**: Before generating **each** SVG page, `read_file <project_path>/spec_lock.md`. Use only values from this file, not from memory. If context was auto-compacted, also `read_file <project_path>/design_spec.md` for the current page's §IX brief.
+**Per-block expression**: mirror each `design_spec.md §IX Content` block's written texture. Render a full-sentence block as flowing prose (body ramp + paragraph layout — line length, leading, spacing; not a new font size); render a fragment/label block as bullets/keywords. Never default a full-sentence block to bullets. If a block carries no clear texture, infer the mode from its wording and the page layout.
+
+> Note: this is block-level phrasing, applied *within* the page's `page_rhythm` density (below), not against it.
+
**If `spec_lock.md` is missing**: emit `warning: spec_lock.md missing — generating without execution lock` once, then proceed using `design_spec.md` values. Expected only for legacy projects; new projects MUST have it (see [strategist.md](strategist.md) §6 step 4).
**Forbidden — values outside the lock**:
diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.md
index 2929939f..6dbd3026 100644
--- a/skills/ppt-master/references/strategist.md
+++ b/skills/ppt-master/references/strategist.md
@@ -718,6 +718,10 @@ Templates are starting points. The Strategist may adjust based on content and au
| B) General Consulting | Structured sections, data-driven insights | Professional terms, conclusion-first |
| C) Top Consulting | SCQA + pyramid principle | Highly condensed, conclusion-driven |
+**Per-block expression**: phrase each §IX content block in the mode that fits it — prose, bullet, keyword, or any phrasing the content calls for — not a default bullet. Take the cue from the source's texture: a spoken script leans prose; a data sheet leans bullet/keyword. Write the real sentence into §IX itself, not a skeleton point to expand later. One page mixes modes; let layout pull each (narrative → prose, structural/chart → bullets/keywords).
+
+> Note: §IX is the only content copy the Executor re-reads after context compression — what you write there is what survives.
+
### 6.2 Outline Output Specification (Must include 11 chapters)
| Chapter | Content Requirements |
@@ -730,7 +734,7 @@ Templates are starting points. The Strategist may adjust based on content and au
| VI. Icon Usage Spec | Source description, placeholder syntax, recommended icon list |
| VII. Visualization Reference List | Visualization type, reference template path, used-in pages, purpose |
| VIII. Image Resource List | Filename, dimensions, ratio, purpose, status, generation description |
-| IX. Content Outline | Grouped by chapter; each page includes layout, title, core message (the page's one idea), content points, visualization type (if applicable) |
+| IX. Content Outline | Grouped by chapter; each page includes layout, title, core message (the page's one idea), content blocks (in the selected phrasing mode), visualization type (if applicable) |
| X. Speaker Notes Requirements | File naming rules, content structure description |
| XI. Technical Constraints Reminder | SVG generation rules, PPT compatibility rules |
diff --git a/skills/ppt-master/templates/design_spec_reference.md b/skills/ppt-master/templates/design_spec_reference.md
index e98697af..eb91b8d8 100644
--- a/skills/ppt-master/templates/design_spec_reference.md
+++ b/skills/ppt-master/templates/design_spec_reference.md
@@ -303,12 +303,12 @@ Catalog read: 71 templates
- **Layout**: [Choose a pattern from §V, combine two, or break the grid as the content demands]
- **Title**: [Page title]
-- **Core message**: [the one thing this page exists to land — its spine. One per page; can't name it → merge or cut the page.]
+- **Core message**: [the one thing this page exists to land — its spine, always phrased as one assertion sentence (prose by nature). One per page; can't name it → merge or cut the page.]
- **Visualization**: [visualization_type] (see VII. Visualization Reference List)
-- **Content** (instantiates the core message — items may stay parallel as evidence, but they sit under the one assertion above, never replace it):
- - [Point]
- - [Point]
- - [Point]
+- **Content**: write each block in the phrasing that fits it (prose / bullet / keyword / … any phrasing the content calls for) and write it already in that mode, so the texture itself carries the intent — a prose block reads as a real sentence, not a fragment. One page may mix modes; blocks still sit under the core message, never replace it:
+ - [a connected sentence or two that argues the point]
+ - [parallel fragment] · [parallel fragment] · [parallel fragment]
+ - [label] / [label] / [label]
> **Visualization field**: add only when the page has data visualization or structured infographic elements. Type must be listed in §VII.