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.mdindex 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 consumptionWhen 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.mdindex 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.mdindex 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.pyindex 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.5RAMP_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:continueexcept 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: