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

refactor(layouts): soften breathing rule from mechanical thresholds to principle

hugohe3f10e8ada66cc
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.md
index 5e699401..426d43ca 100644
--- a/skills/ppt-master/references/executor-base.md
+++ b/skills/ppt-master/references/executor-base.md
@@ -63,7 +63,7 @@ Before drawing each page, look up its entry in `page_rhythm` (key format `P<NN>`
|-----|-------------------|
| `anchor` | Structural page (cover / chapter / TOC / ending). Follow the matching template verbatim. |
| `dense` | Information-heavy. Card grids, multi-column layouts, KPI dashboards, tables, and charts are all permitted. This is the baseline behavior. |
-| `breathing` | Low-density impact page. **Do NOT use rounded-rectangle card containers** — use naked text blocks, dividers, or full-bleed imagery instead. Whitespace ≥ 40% of canvas. Prefer asymmetric splits (e.g., 2:8, 3:7) over symmetric ones. Figure-text overlap (text floating over a background image with an opacity overlay) is encouraged. Typical forms: hero quote, single large number with one-line interpretation, full-bleed image with floating caption, section transition. |
+| `breathing` | Low-density impact page. Avoid **multi-card grid layouts** — do not organize content as multiple parallel rounded containers (3-card row, 4-card KPI grid, 2×2 matrix rendered as cards). Use naked text blocks, dividers, whitespace, or full-bleed imagery as the content structure. Single rounded visual elements (hero image corners, callouts, tags, one emphasis block) are fine — the rule is about grid structure, not about the `rx` attribute. Proportions follow information weight (not a preset ratio). Typical forms: hero quote, single large number with one-line interpretation, full-bleed image with floating caption, section transition. |
**Why this matters**: Without rhythm variation, long decks default to "every page is a card grid" — the AI-generated look. The `page_rhythm` tag is the only lever that survives context compression (since Executor re-reads `spec_lock.md` per page); narrative guidance buried in `design_spec.md` does not.
diff --git a/skills/ppt-master/references/executor-consultant-top.md b/skills/ppt-master/references/executor-consultant-top.md
index 597759ec..b7456186 100644
--- a/skills/ppt-master/references/executor-consultant-top.md
+++ b/skills/ppt-master/references/executor-consultant-top.md
@@ -117,18 +117,7 @@ Horizontal table; own row highlighted in theme color, others in gray. Leading in
Start → increase/decrease factors → End. Positive factors green bars, negative factors red bars, start/end points dark bars, cumulative line as dashed connector.
-### Break-the-grid Patterns (for `breathing` pages)
-
-> MBB-level decks deliberately use `breathing` pages as narrative leverage — an SCQA "Question" bridge, a single conclusion that needs to land without distraction, a strategic-implication moment between analytical chapters. These pages use **non-grid** patterns (see also `strategist.md` §4 Layout Pattern Library).
-
-| Pattern | MBB-level use |
-|---------|--------------|
-| **Negative-space-driven** | Single executive takeaway in 60%+ whitespace — the most authoritative form for a C-suite audience |
-| **Asymmetric split (2:8)** | Dominant chart + one-sentence strategic implication; one hero metric + decomposition list |
-| **Full-bleed + floating text** | Chapter opener framing market context or board decision moment |
-| **Figure-text overlap** | Hero conclusion headline anchored against chart edge or photograph |
-
-**Rule**: When `page_rhythm = breathing` for the current page, **do NOT wrap content in rounded-rectangle cards** or KPI dashboards. Use naked takeaway text, dividers, and whitespace — the MBB aesthetic of "extreme simplicity" is *served* by breathing pages, not contradicted by them. Cards and dashboards belong to `dense` pages.
+> When `page_rhythm = breathing`, the MBB-appropriate form is **negative-space-driven**: a single takeaway statement on a near-empty canvas, or a dominant chart with one sentence of strategic implication (an asymmetric 2:8 degeneration of the standard chart+insight layout). The extreme-simplicity aesthetic of MBB is *served* by this — filler imagery and decorative overlap from marketing-style decks do NOT belong here. Universal rhythm discipline is in `executor-base.md §2.1`.
---
diff --git a/skills/ppt-master/references/executor-consultant.md b/skills/ppt-master/references/executor-consultant.md
index 6a6a021d..142dd4c5 100644
--- a/skills/ppt-master/references/executor-consultant.md
+++ b/skills/ppt-master/references/executor-consultant.md
@@ -110,18 +110,7 @@ Insight area: x=780, y=120, w=460, h=480
- Data source (12px, gray)
```
-### Break-the-grid Patterns (for `breathing` pages)
-
-> Consulting decks can and should include `breathing` pages — a single insight that deserves to land without a card around it, a data-backed headline moment, a transition between analytical chapters. These pages use the **non-grid** patterns below (see also `strategist.md` §4 Layout Pattern Library).
-
-| Pattern | Consulting use |
-|---------|----------------|
-| **Asymmetric split (3:7 / 2:8)** | One big chart + one sentence of takeaway; one large number + a list of drivers |
-| **Full-bleed + floating text** | Chapter openers, emotional framing of a market context |
-| **Negative-space-driven** | Single headline conclusion on a near-empty canvas — "Market share halved in 18 months" |
-| **Figure-text overlap** | Hero quote over portrait photo; big number anchored against chart edge |
-
-**Rule**: When `page_rhythm = breathing` for the current page, **do NOT wrap content in rounded-rectangle cards** (`<rect rx="...">` containers with padding). Use naked text, dividers, and whitespace instead. Cards are for `dense` pages.
+> When `page_rhythm = breathing`, this standard layout can legitimately degenerate to **chart-dominant (2:8)**: one large chart carrying the page, one sentence of takeaway — the rhythm rule is then satisfied without adding patterns foreign to consulting style. See `executor-base.md §2.1` for the universal rhythm discipline.
---
diff --git a/skills/ppt-master/templates/spec_lock_reference.md b/skills/ppt-master/templates/spec_lock_reference.md
index e6933ee5..c19d6131 100644
--- a/skills/ppt-master/templates/spec_lock_reference.md
+++ b/skills/ppt-master/templates/spec_lock_reference.md
@@ -55,7 +55,7 @@
> **Vocabulary** (exactly these three values):
> - `anchor` — Structural pages (cover / chapter opener / TOC / ending). Follow the corresponding template as-is.
> - `dense` — Information-heavy pages (data, KPIs, comparisons, multi-point lists). Card grids, multi-column layouts, tables, and charts are all permitted.
-> - `breathing` — Low-density pages (single concept, hero quote, big image + caption, section transition). **No card containers** — use naked text blocks or full-bleed imagery. Whitespace ≥ 40% of canvas. Asymmetric layout (e.g., 2:8, 3:7) and figure-text overlap are encouraged.
+> - `breathing` — Low-density pages (single concept, hero quote, big image + caption, section transition). Avoid **multi-card grid layouts** (multiple parallel rounded containers as the primary content structure); organize with naked text, dividers, whitespace, or full-bleed imagery instead. Single rounded visual elements (hero image corners, callouts, tags, one emphasis block) are fine. Proportions follow information weight — not a preset ratio menu.
>
> **Rhythm follows narrative** (for Strategist when filling this section): `breathing` pages appear where the narrative genuinely pauses — section transitions, a single argument worth standalone emphasis, a deliberate stop after a dense sequence. A high-density data briefing or consulting analysis may legitimately be nearly all `dense` — **do not invent filler pages** to pad the rhythm. Validation: every `breathing` page must answer "what independent thing is this page saying?".
>