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

fix(modes): land mode/visual-style calibration follow-ups

hugohe33513d2ba4a73
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.md
index 12d4136d..a7f9012b 100644
--- a/skills/ppt-master/references/executor-base.md
+++ b/skills/ppt-master/references/executor-base.md
@@ -39,6 +39,8 @@ Resolve the per-page template SVG via `spec_lock.md page_layouts` (authoritative
> Note: `page_layouts` disambiguates the multiple content variants modern templates ship (e.g., `graduation_defense` has 8); the legacy table cannot.
+**Templates supply structure, not skin (non-mirror)**: a chart or layout template's gradients, drop-shadows, and palette are placeholder. Inherit its geometry, label / legend placement, and series-encoding logic; re-skin every fill / stroke to the deck's `visual_style` + `spec_lock.colors` — flat styles strip the gradients and shadows, gradient / glass styles repaint their own. Forbidden — shipping a template's default `<linearGradient>` / `cardShadow` / Tailwind fills unchanged. Mirror templates are the exception: §1.1 preserves their visuals verbatim.
+
### 1.1 Mirror-mode templates — reference-style consumption
When the project's chosen template is a `mirror` template (`design_spec.md` frontmatter declares `replication_mode: mirror`), Executor switches to a **reference-style** consumption path that bypasses placeholder substitution:
diff --git a/skills/ppt-master/references/modes/briefing.md b/skills/ppt-master/references/modes/briefing.md
index 3bf3a9f0..bb46a813 100644
--- a/skills/ppt-master/references/modes/briefing.md
+++ b/skills/ppt-master/references/modes/briefing.md
@@ -10,6 +10,8 @@ Neutral information delivery. Lay the facts out plainly and completely, organize
**Topic titles, not assertions**: the page title names its subject plainly ("Q3 headcount by team", "Supported file formats") — clarity for lookup beats a persuasive finding. This is the deliberate inverse of `pyramid`'s assertion titles.
+**`core_message` states coverage, not a claim**: when filling `design_spec.md §IX`, write each page's `core_message` as what the page lays out ("Q3 headcount across teams"), not what it proves ("headcount is concentrating in engineering"). The §IX field reads as an assertion under the other modes; under `briefing` it names scope.
+
**Complete over selective**: include the full reference set the audience needs to scan, not only the points that support a case. Coverage is the value here.
**Parallel, even treatment**: sibling items get the same shape and weight so they can be compared and located quickly; nothing is dramatized over its peers unless it genuinely differs.
diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.md
index 2313f03e..b26c71c8 100644
--- a/skills/ppt-master/references/strategist.md
+++ b/skills/ppt-master/references/strategist.md
@@ -94,6 +94,14 @@ Proactively provide a color scheme (HEX values) based on content characteristics
**Color rules**: 60-30-10 rule (primary 60%, secondary 30%, accent 10%); text contrast ratio >= 4.5:1; no more than 4 colors per page.
+**Lock the full neutral set the visual style implies** — not just primary / secondary / accent / border. Predict the extra neutral tiers the locked `visual_style` (§d Layer 2) needs and lock them now; `spec_lock.colors` must be complete before generation, and the Executor draws only from it (never invents a tone mid-deck).
+
+| Style trait | Extra neutral tiers to lock |
+|---|---|
+| Layers panels / charts (e.g. `data-journalism`, `swiss-minimal`) | `surface` (panel lift), `grid` (hairline, lighter than dividers) |
+| Text over imagery / dark field (e.g. `photo-editorial`, `glassmorphism`, `dark-tech`) | `scrim` / `overlay` for legibility |
+| Print / hand-drawn fills (e.g. `chalkboard`, `zine`) | `block-shade`, one step off the field |
+
### f. Icon Usage Confirmation
| Option | Approach | Suitable Scenarios |
diff --git a/skills/ppt-master/scripts/svg_quality_checker.py b/skills/ppt-master/scripts/svg_quality_checker.py
index 94e0401c..c5c4bbc6 100644
--- a/skills/ppt-master/scripts/svg_quality_checker.py
+++ b/skills/ppt-master/scripts/svg_quality_checker.py
@@ -55,6 +55,13 @@ SVG_NS = "http://www.w3.org/2000/svg"
RAMP_MIN_RATIO = 0.5
RAMP_MAX_RATIO = 5.0
+# Modes / visual styles that legitimately use unbounded hero / poster type
+# (huge cover numerals, act dividers, single-number reveals). For these the
+# size-drift upper bound is dropped — the oversize is the design, not Executor
+# drift. The lower bound still applies.
+POSTER_SIZE_MODES = {'showcase'}
+POSTER_SIZE_STYLES = {'zine'}
+
def _design_spec_is_brand(spec_path: Path) -> bool:
"""Return True when a design_spec.md frontmatter declares ``kind: brand``.
@@ -735,7 +742,7 @@ class SVGQualityChecker:
if typo:
default_font = typo.get('font_family', '').strip()
if default_font:
- allowed_fonts.add(default_font)
+ allowed_fonts.add(self._normalize_font_stack(default_font))
for k, v in typo.items():
if k == 'font_family' or not k.endswith('_family'):
continue
@@ -743,7 +750,7 @@ class SVGQualityChecker:
# Skip placeholder text like "same as body (omit if identical)"
if not v_clean or v_clean.lower().startswith('same as'):
continue
- allowed_fonts.add(v_clean)
+ allowed_fonts.add(self._normalize_font_stack(v_clean))
# Sizes: declared slots are anchors; body is the ramp baseline.
allowed_sizes = set()
@@ -768,22 +775,30 @@ class SVGQualityChecker:
color_drifts.add(val)
font_drifts = set()
- for m in re.finditer(r'font-family\s*=\s*["\']([^"\']+)["\']', content):
- val = m.group(1).strip()
- if allowed_fonts and val not in allowed_fonts:
+ # Capture to the matching delimiter (group 1) so a double-quoted stack
+ # containing single-quoted family names is not truncated at the inner quote.
+ for m in re.finditer(r'font-family\s*=\s*(["\'])(.*?)\1', content):
+ val = m.group(2).strip()
+ if allowed_fonts and self._normalize_font_stack(val) not in allowed_fonts:
font_drifts.add(val)
+ # Poster / showcase contexts use unbounded hero type — drop the ceiling.
+ mode = (lock.get('mode', {}).get('mode') or '').strip().lower()
+ vstyle = (lock.get('visual_style', {}).get('visual_style') or '').strip().lower()
+ max_ratio = (float('inf') if mode in POSTER_SIZE_MODES or vstyle in POSTER_SIZE_STYLES
+ else RAMP_MAX_RATIO)
+
size_drifts = set()
for m in re.finditer(r'font-size\s*=\s*["\']([^"\']+)["\']', content):
val = self._normalize_size(m.group(1))
if not allowed_sizes or val in allowed_sizes:
continue
# Intermediate values are allowed when they sit inside the ramp
- # envelope (ratio to body within [RAMP_MIN_RATIO, RAMP_MAX_RATIO]).
+ # envelope (ratio to body within [RAMP_MIN_RATIO, max_ratio]).
if body_px and body_px > 0:
try:
ratio = float(val) / body_px
- if RAMP_MIN_RATIO <= ratio <= RAMP_MAX_RATIO:
+ if RAMP_MIN_RATIO <= ratio <= max_ratio:
continue
except ValueError:
pass
@@ -886,6 +901,15 @@ class SVGQualityChecker:
v = v[:-2].strip()
return v
+ @staticmethod
+ def _normalize_font_stack(stack: str) -> str:
+ """Normalize a font-family stack for comparison: split on commas, strip
+ quotes / whitespace, lowercase, rejoin. Collapses cosmetic differences
+ (comma spacing, single vs double quotes, case) so that
+ `Consolas,'Courier New',monospace` matches `Consolas, "Courier New", monospace`."""
+ parts = [p.strip().strip('"\'').lower() for p in stack.split(',')]
+ return ','.join(p for p in parts if p)
+
def _categorize_issue(self, error_msg: str) -> str:
"""Categorize issue type"""
if 'Invalid XML' in error_msg: