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.mdindex 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.mdindex 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 inStart → 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.mdindex 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.mdindex 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?".>