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

docs(fonts): align portability and fallback contracts

hugohe3d4ef74b7d72f
diff --git a/docs/animations.md b/docs/animations.md
index a0bdd9eb..e84850b9 100644
--- a/docs/animations.md
+++ b/docs/animations.md
@@ -127,7 +127,8 @@ The generated sidecar targets stable top-level `<g id="...">` content groups. Co
Use `python3 skills/ppt-master/scripts/pptx_animations.py --describe
<canonical_effect>` to see exactly which options that effect accepts. Speed is
controlled by `duration`; smooth start/end are controlled by
-`accelerate`/`decelerate`.
+`accelerate`/`decelerate`. Change Font's `font_name` is one concrete
+target-installed PowerPoint face, never a CSS font stack.
`trigger_shape` is group-only and points to a different group id on the same
slide. It affects only that row; the slide Start mode still controls all other
diff --git a/docs/technical-design.md b/docs/technical-design.md
index 323d9ad9..fa3ab738 100644
--- a/docs/technical-design.md
+++ b/docs/technical-design.md
@@ -397,7 +397,7 @@ The lock is also the per-page routing table. Beyond global colors and typography
`--record-usage` writes a derived, input-hashed compact-output snapshot for an invoked page under `analysis/page-context/`. Token counting lazily uses `o200k_base`; a missing `tiktoken` installation records `tokens: null` without blocking execution. `page-context-report` excludes stale snapshots, reports existing snapshots, and lists unique reference fingerprints; telemetry may be partial. The once-loaded reference payloads and other session context remain intentionally unmeasured.
-`update_spec.py` propagates an intentional deck-wide anchor change in two coordinated steps: write the new value to `spec_lock.md`, then literal-replace it across every `svg_output/*.svg`. The tool's scope is deliberately narrow — only `colors.*` (HEX values, case-insensitive replacement) and `typography.font_family` (attribute-scoped). Other fields (font sizes, icons, images, canvas) are intentionally **not supported** because their replacements would need attribute-scoped or semantic awareness whose risk/benefit doesn't justify bulk propagation. This reverse lock update is also valid when repeated contextual use is deliberately promoted into a named semantic role; it must not be used merely to empty an informational checker comparison. For unsupported fields, edit the owning artifact and re-author the affected pages.
+`update_spec.py` propagates an intentional deck-wide anchor change in two coordinated steps: plan and literal-replace the value across every `svg_output/*.svg`, then write the authoritative `spec_lock.md` only after those SVG updates succeed. The tool's scope is deliberately narrow — only `colors.*` (HEX values, case-insensitive replacement) and universal `typography.font_family` (attribute-scoped). A universal font replacement also sets every existing `typography.*_family` lock row to the same value in one lock-file write, so title/body/role locks cannot retain values that the command has removed from every SVG. Other fields (font sizes, per-role font changes, icons, images, canvas) are intentionally **not supported** because their replacements would need attribute-scoped or semantic awareness whose risk/benefit doesn't justify bulk propagation. This reverse lock update is also valid when repeated contextual use is deliberately promoted into a named semantic role; it must not be used merely to empty an informational checker comparison. For unsupported fields, edit the owning artifact and re-author the affected pages.
The tool refuses to back up: it relies on git for revert. Adding a backup mechanism would just duplicate git's job and create stale snapshots.
diff --git a/docs/zh/animations.md b/docs/zh/animations.md
index 384f55d4..158cefc5 100644
--- a/docs/zh/animations.md
+++ b/docs/zh/animations.md
@@ -118,7 +118,8 @@ python3 skills/ppt-master/scripts/svg_to_pptx.py <project>
运行 `python3 skills/ppt-master/scripts/pptx_animations.py --describe
<canonical_effect>` 可查看该效果实际接受的完整参数。速度由 `duration` 控制,
-平滑开始/结束由 `accelerate`/`decelerate` 控制。
+平滑开始/结束由 `accelerate`/`decelerate` 控制。Change Font 的 `font_name`
+必须是目标环境已安装的一个具体 PowerPoint 字体名,不能写 CSS 字体列表。
`trigger_shape` 只能写在对象组上,并指向同一页另一个分组 id。它只让当前动画行
变为交互触发,其他行仍遵循页面 Start 模式;录制旁白不接受这种交互动画。
diff --git a/docs/zh/technical-design.md b/docs/zh/technical-design.md
index 66ef6a58..af694ba6 100644
--- a/docs/zh/technical-design.md
+++ b/docs/zh/technical-design.md
@@ -391,7 +391,7 @@ Strategist 阶段产出两份看起来冗余但服务不同对象的产物:
`--record-usage` 在 `analysis/page-context/` 下为实际调用的页面写入派生快照,记录输入 hash 和紧凑 stdout 的实测大小。token 计数按需加载 `o200k_base`;没有安装 `tiktoken` 时写入 `tokens: null`,但不阻塞执行。`page-context-report` 排除过期快照,汇总已有快照并列出唯一引用指纹;统计可以只覆盖部分页面。一次加载的大型引用 payload 与其他会话上下文有意不纳入统计。
-`update_spec.py` 用两个协调步骤传播一次有意的 deck 级锚点修改:把新值写入 `spec_lock.md`,然后字面替换到每一份 `svg_output/*.svg`。工具的范围**故意收得很窄**——只支持 `colors.*`(HEX 值,大小写不敏感替换)和 `typography.font_family`(属性级)。其他字段(字号、图标、图片、画布)**有意不支持**——它们的替换需要属性级或语义级理解,风险/收益不值得做批量传播。当重复出现的上下文值被明确提升为具名语义角色时,反向回写 lock 同样合理;但不能只为了清空 checker 的信息提示而扩充 lock。其他字段应修改其权威产物并重做受影响页面。
+`update_spec.py` 用两个协调步骤传播一次有意的 deck 级锚点修改:先规划并字面替换每一份 `svg_output/*.svg`,这些 SVG 更新成功后才写权威 `spec_lock.md`。工具的范围**故意收得很窄**——只支持 `colors.*`(HEX 值,大小写不敏感替换)和全局 `typography.font_family`(属性级)。全局字体替换还会在一次 lock 文件写入中,把所有既有 `typography.*_family` 行同步为同一值,避免标题、正文或其他角色保留已从全部 SVG 移除的旧字体。其他字段(字号、按角色字体变更、图标、图片、画布)**有意不支持**——它们的替换需要属性级或语义级理解,风险/收益不值得做批量传播。当重复出现的上下文值被明确提升为具名语义角色时,反向回写 lock 同样合理;但不能只为了清空 checker 的信息提示而扩充 lock。其他字段应修改其权威产物并重做受影响页面。
工具拒绝做备份:依赖 git 回滚。加备份机制只是重复 git 的工作,还会留下过时快照。
diff --git a/skills/ppt-master/references/animations.md b/skills/ppt-master/references/animations.md
index 4b3acdb0..783315b1 100644
--- a/skills/ppt-master/references/animations.md
+++ b/skills/ppt-master/references/animations.md
@@ -119,7 +119,7 @@ Rules:
| `direction` | Directional Fly/Crawl/Wipe/Peek/Strips/Split/Stretch/Zoom and related entrance/exit effects |
| `amount` | Wheel spokes (`1`, `2`, `3`, `4`, `8`), emphasis Spin degrees, or Transparency ratio |
| `color` | Color-capable emphasis effects; `#RRGGBB` or `theme:<scheme-color>` |
- | `font_name` | Change Font; required for `emphasis_change_font` |
+ | `font_name` | Change Font; required for `emphasis_change_font`; one installed PowerPoint face, not a CSS list |
| `size` | Grow/Shrink |
| `relative` | Motion paths (`true` = shape-relative, `false` = fixed slide path) |
- Any animation/group block may set `repeat_count` or `repeat_duration`
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.md
index cbe1e5aa..5dbf8e0f 100644
--- a/skills/ppt-master/references/executor-base.md
+++ b/skills/ppt-master/references/executor-base.md
@@ -285,7 +285,7 @@ Structural typography anchors come from `spec_lock.md typography`. Use an exact
**Missing required field — `typography.font_family`** → stop and return to Generate Step 4 / [`strategist.md`](strategist.md) §6.2 to repair `spec_lock.md`; do not infer a stack from `design_spec.md`.
-**Hard rule**: every SVG `font-family` stack MUST resolve to a pre-installed exported Latin / EA typeface; use the Strategist §g safe set for locked roles and §2.1 for sparse display exceptions. PPTX has no runtime fallback — missing fonts degrade to Calibri.
+**Hard rule**: every SVG `font-family` stack MUST resolve to target-installed/approved Latin and EA faces. PPTX writes one face per script; CSS tails affect preview only, and fonts are not embedded. Missing-face substitution is viewer-selected—not guaranteed Calibri or a later stack entry.
---
diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.md
index e7e59d35..4060fc28 100644
--- a/skills/ppt-master/references/strategist.md
+++ b/skills/ppt-master/references/strategist.md
@@ -214,9 +214,9 @@ See [`../templates/icons/README.md`](../templates/icons/README.md) for the curre
- User or active template typography is authoritative. Otherwise ≥3 Stage-2 directions include concord (safe) and contrast (tension); never add a separate font-choice round or pair near-duplicate title/body families.
- Every Stage-2 direction carries `heading` / `body` `cjk`, `latin`, `css`, and positive `body_size`; repeat user/template-fixed stacks.
-- Use PowerPoint-installed exported faces. Safe anchors: CJK `Microsoft YaHei` / `SimHei` / `SimSun` / `FangSong` / `KaiTi`; Latin sans `Arial` / `Calibri` / `Segoe UI` / `Verdana` / `Trebuchet MS`; Latin serif `Times New Roman` / `Georgia` / `Cambria` / `Garamond` / `Book Antiqua`; mono `Consolas` / `Courier New`; display `Impact` / `Arial Black`. Other export-safe families are limited to sparse short display/ornament; structural or recurring use returns upstream.
-- Keep each stack to four families or fewer. A non-installed brand or web face is legal only when the Design Spec explicitly records the install / embed requirement and a safe substitute.
-- Avoid splitting roles across near-equivalents such as YaHei↔PingFang, SimSun↔Songti, Arial↔Helvetica↔Segoe UI, or Times New Roman↔Times. A cross-platform counterpart may remain inside one fallback stack.
+- Use concrete, target-installed PowerPoint faces. **Examples only, never a catalog/default** (verify locale): Chinese `DengXian` / `SimSun`; Japanese `Meiryo` / `Yu Gothic`; Korean `Malgun Gothic` / `Batang`; Latin `Arial` / `Georgia` / `Consolas` / `Impact`.
+- Keep stacks to four families or fewer. A brand/web face may lead only after user-confirmed target installation/approved install; PPT Master does not embed fonts. Otherwise export a safe face and keep the unavailable face as Design Spec reference.
+- Avoid near-equivalent role splits such as YaHei↔PingFang, SimSun↔Songti, Arial↔Helvetica↔Segoe UI, or Times New Roman↔Times. Counterparts may aid SVG/browser preview; CSS tails are not deterministic PowerPoint fallbacks.
- Choose by locked style and vary the axis instead of defaulting to YaHei/Arial: serif×sans, Kai/FangSong×hei, hei×song, double-serif, display×neutral, same-family weight, or sans+mono. These are recall seeds, not presets.
**Strategist-owned role extension after confirmation**: Confirm UI keeps the heading/body choice unchanged. While authoring the complete §IX roster and §IV typography plan, scan the actual content for recurring roles that materially need a different family for character or legibility—such as `annotation`, `footer`, `footnote`, `data`, `emphasis`, `quote`, or `code`. Add a lowercase snake_case role and exact stack only when it recurs; inherited roles and one-off garnish stay omitted. The extension must remain coherent with the confirmed heading/body system and locked visual style, and it does not reopen confirmation. Only when an additional family role is added, record one compact `Role rationale` in §IV naming the added role(s) and why; otherwise omit the line.
diff --git a/skills/ppt-master/references/template-designer.md b/skills/ppt-master/references/template-designer.md
index f4b594c1..801276e4 100644
--- a/skills/ppt-master/references/template-designer.md
+++ b/skills/ppt-master/references/template-designer.md
@@ -238,9 +238,10 @@ page_count: <N>
- HEX values with role labels (primary / accent / background / text / etc.)
- Brand-specific application rules when present (e.g. "KPI cards rotate blue→green→red→yellow")
-## III. Typography (omit when using the default `Arial, "Microsoft YaHei", sans-serif` stack)
-- Per-role font stacks ONLY when the template intentionally diverges (display serif title, brand typeface, etc.)
-- Font-install or embedding requirement when a non-preinstalled font leads any stack
+## III. Typography (omit without template-owned typeface identity)
+- Per-role stacks for identity (display serif, brand face, etc.)
+- A non-preinstalled face may lead only after user-confirmed target installation/approved install; no auto-embedding
+- Otherwise export a safe face; unavailable proprietary faces stay references. CSS tails aid preview, not deterministic PowerPoint fallback
- Body baseline px (informational; `spec_lock.md` owns the actual values per project)
## IV. Signature Design Elements
diff --git a/skills/ppt-master/references/visual-styles/glassmorphism.md b/skills/ppt-master/references/visual-styles/glassmorphism.md
index 0d035548..b1f8a030 100644
--- a/skills/ppt-master/references/visual-styles/glassmorphism.md
+++ b/skills/ppt-master/references/visual-styles/glassmorphism.md
@@ -13,9 +13,9 @@ Frosted-glass SaaS — translucent layered panels, flowing gradient light, float
## 2. Typography character
-- Clean modern sans; light / medium weights; airy. Headlines can carry a luminous gradient on the dark field.
+- Clean modern sans; regular with selective bold; airy. Exact Light/Black requires a user-confirmed installed face. Headlines can carry a luminous gradient on the dark field.
-> Families are chosen at confirmation `g`; this style asks for a clean, modern, slightly-light sans *character*.
+> Families are chosen at confirmation `g`; this style asks for a clean, modern, airy sans *character*.
## 3. Using the deck's colors
diff --git a/skills/ppt-master/references/visual-styles/swiss-minimal.md b/skills/ppt-master/references/visual-styles/swiss-minimal.md
index d4ac2527..0d133640 100644
--- a/skills/ppt-master/references/visual-styles/swiss-minimal.md
+++ b/skills/ppt-master/references/visual-styles/swiss-minimal.md
@@ -14,7 +14,7 @@ Strict Swiss-grid discipline. Modular grid, sharp geometry, aggressive whitespac
## 2. Typography character
-- Sans-serif, single family; weight contrast (e.g. 900 / 300) over family contrast. Tight, rigorous spacing.
+- Sans-serif, single family; regular/bold contrast. Exact Light/Black requires a user-confirmed installed face. Tight, rigorous spacing.
- Strong size hierarchy — large headlines, small precise body. Left-aligned, flush.
> Family is chosen at confirmation `g` by subject fit — this style asks for a grotesque / neo-grotesque *character*, not a specific font.
diff --git a/skills/ppt-master/scripts/docs/pptx-animations.md b/skills/ppt-master/scripts/docs/pptx-animations.md
index bc89702d..91075c06 100644
--- a/skills/ppt-master/scripts/docs/pptx-animations.md
+++ b/skills/ppt-master/scripts/docs/pptx-animations.md
@@ -36,7 +36,7 @@ One resolved animation-pane row contains these fields:
| Duration | Finite positive schedule duration; scalable native behavior trees preserve their internal timing ratios |
| Delay | Finite non-negative offset used by `after-previous` or as trigger-shape `TriggerDelayTime` |
| Order | Positive integer sidecar order; ties retain stable SVG order |
-| Effect options | Effect-specific `direction`, `amount`, `color`, `font_name` (required for Change Font), `relative`, or `size` values from PowerPoint `EffectParameters` |
+| Effect options | Effect-specific `direction`, `amount`, `color`, `font_name` (one installed PowerPoint face, required for Change Font; not a CSS list), `relative`, or `size` values from PowerPoint `EffectParameters` |
| Timing options | Repeat count/span, auto-reverse, rewind, accelerate/decelerate, bounce-end ratio, and restart policy |
| Completion | Optional dim/hide behavior and packaged `.m4a`/`.mp3`/`.wav` sound |
diff --git a/skills/ppt-master/scripts/docs/update_spec.md b/skills/ppt-master/scripts/docs/update_spec.md
index f88ac29c..c0202a38 100644
--- a/skills/ppt-master/scripts/docs/update_spec.md
+++ b/skills/ppt-master/scripts/docs/update_spec.md
@@ -1,8 +1,9 @@
# update_spec.py
> **Scope boundary**: this tool updates only deterministic global color and font
-> substitutions, writes the authoritative `spec_lock.md` first, and relies on
-> version control for rollback instead of creating parallel backups.
+> substitutions, writes the authoritative `spec_lock.md` only after the SVG
+> updates succeed, and relies on version control for rollback instead of
+> creating parallel backups.
Propagate a `spec_lock.md` value change to both the lock file and every `svg_output/*.svg`. The single edit surface for bulk style tweaks after generation.
@@ -17,8 +18,9 @@ Bare `<key>=<value>` (no dot) is treated as `colors.<key>=<value>` for backward
One invocation = one change. The tool:
1. Reads the old value from `<project_path>/spec_lock.md`
-2. Writes the new value into `spec_lock.md`
-3. Propagates the change into every `.svg` under `svg_output/`
+2. Plans and propagates the change into every `.svg` under `svg_output/`
+3. Writes the new value into `spec_lock.md`; a global font replacement updates
+ every existing `typography.*_family` row together
4. Prints the list of files touched
## Examples
@@ -32,14 +34,16 @@ python3 skills/ppt-master/scripts/update_spec.py projects/acme_ppt169_20260301 c
# change the deck-wide font family
python3 skills/ppt-master/scripts/update_spec.py projects/acme_ppt169_20260301 \
- 'typography.font_family="Inter", Arial, sans-serif'
+ 'typography.font_family=Arial, "Microsoft YaHei", sans-serif'
```
## v2 scope
- **Supported**:
- `colors.*` — HEX value replacement across `svg_output/*.svg` (case-insensitive).
- - `typography.font_family` — replaces the inner value of every `font-family="..."` / `font-family='...'` attribute.
+ - `typography.font_family` — replaces the inner value of every
+ `font-family="..."` / `font-family='...'` attribute and sets all existing
+ `typography.*_family` lock rows to that universal family.
- **Not supported**: typography sizes, icons, images, canvas, forbidden — these involve attribute-scoped or semantic replacements whose risk/benefit does not warrant bulk propagation. Edit `spec_lock.md` and the affected SVGs by hand, or re-author the pages.
## When to use
@@ -53,6 +57,8 @@ python3 skills/ppt-master/scripts/update_spec.py projects/acme_ppt169_20260301 \
- HEX values (e.g. `#005587`) are unique enough in SVG content that literal replacement is safe
- `font-family` substitution is scoped to the attribute; the outer quote character is preserved, and switched automatically if the new value contains the same quote
+- a global font substitution rewrites all existing family-role lock rows in one
+ file write, so the universal SVG result cannot leave stale title/body roles
- The tool refuses non-HEX inputs, unknown keys, and unsupported sections
- No backups are created — the project folder should be under git so you can diff / revert
diff --git a/skills/ppt-master/scripts/prompt_audit_manifest.json b/skills/ppt-master/scripts/prompt_audit_manifest.json
index b43b707e..904e50ca 100644
--- a/skills/ppt-master/scripts/prompt_audit_manifest.json
+++ b/skills/ppt-master/scripts/prompt_audit_manifest.json
@@ -12,7 +12,7 @@
"skills/ppt-master/templates/schemas/*.json"
],
"exclude": [],
- "max_tokens": 387100
+ "max_tokens": 387200
},
"file_budgets": {
"AGENTS.md": 2400,
@@ -578,7 +578,7 @@
"files": [
"skills/ppt-master/workflows/profiles/beautify-pptx.md"
],
- "max_tokens": 6900
+ "max_tokens": 6950
},
"stage.generate.refine-spec": {
"description": "Explicit post-confirmation spec refinement runbook.",
@@ -632,7 +632,7 @@
"skills/ppt-master/scripts/docs/pptx-transitions.md",
"skills/ppt-master/scripts/docs/svg-pipeline.md"
],
- "max_tokens": 28700
+ "max_tokens": 28725
},
"stage.generate.video-motion-plan": {
"description": "Conditional resolved animation-to-video handoff contract.",
diff --git a/skills/ppt-master/templates/brands/anthropic/templates/design_spec.md b/skills/ppt-master/templates/brands/anthropic/templates/design_spec.md
index 062f1bae..eb579653 100644
--- a/skills/ppt-master/templates/brands/anthropic/templates/design_spec.md
+++ b/skills/ppt-master/templates/brands/anthropic/templates/design_spec.md
@@ -35,10 +35,10 @@ The first two rows are literal Claude asset facts. Background and neutral rows a
| Role | Family | Weight |
|---|---|---|
-| title | `"Styrene A", "Helvetica Neue", Arial, "Microsoft YaHei", sans-serif` | 600–700 |
-| body | `"Anthropic Sans", "Helvetica Neue", Arial, "Microsoft YaHei", sans-serif` | 400 |
+| title | `Arial, "Microsoft YaHei", sans-serif` | 600–700 |
+| body | `Arial, "Microsoft YaHei", sans-serif` | 400 |
-> `Styrene A` and `Anthropic Sans` are proprietary and unlikely to be installed on viewer machines. PPT Master does not bundle or automatically embed them; use the declared fallback chain unless the user supplies an installed/approved font workflow.
+> `Styrene A` and `Anthropic Sans` are references. PPT Master neither auto-embeds fonts nor follows CSS tails in PowerPoint. The rows above are the default Windows/Office export; replace them only with a user-confirmed target-installed face.
## IV. Logo
diff --git a/skills/ppt-master/templates/brands/google/templates/design_spec.md b/skills/ppt-master/templates/brands/google/templates/design_spec.md
index 450f1bcd..c43fda9d 100644
--- a/skills/ppt-master/templates/brands/google/templates/design_spec.md
+++ b/skills/ppt-master/templates/brands/google/templates/design_spec.md
@@ -35,10 +35,10 @@ The four primary brand colors (Blue / Green / Yellow / Red) carry equal weight i
| Role | Family | Weight |
|---|---|---|
-| title | `Google Sans, Roboto, "Microsoft YaHei", sans-serif` | 500–700 |
-| body | `Roboto, "Microsoft YaHei", sans-serif` | 400 |
+| title | `"Segoe UI", "Microsoft YaHei", sans-serif` | 500–700 |
+| body | `"Segoe UI", "Microsoft YaHei", sans-serif` | 400 |
-> `Google Sans` is proprietary. PPT Master does not bundle or automatically embed it; use the `Roboto` / `Microsoft YaHei` fallback unless the user supplies an installed/approved font workflow.
+> `Google Sans` and `Roboto` are references. PPT Master neither auto-embeds fonts nor follows CSS tails in PowerPoint. The rows above are the default Windows/Office export; replace them only with a user-confirmed target-installed face.
## IV. Logo
diff --git a/skills/ppt-master/workflows/profiles/beautify-pptx.md b/skills/ppt-master/workflows/profiles/beautify-pptx.md
index c97dd813..3a805e07 100644
--- a/skills/ppt-master/workflows/profiles/beautify-pptx.md
+++ b/skills/ppt-master/workflows/profiles/beautify-pptx.md
@@ -73,7 +73,7 @@ python3 ${SKILL_DIR}/scripts/pptx_intake.py <project_path>/sources/<source.pptx>
| Field | Use |
|---|---|
| `theme.palette.background` / `text` / `primary` / `accent1..6` | the deck's *declared* colors |
-| `theme.fonts.title` / `body` (`ea` = CJK, `latin`) | the deck's *declared* fonts |
+| `theme.fonts.title` / `body` (`latin` / `ea` / `cs`; `scripts` maps `Hans` / `Hant` / `Jpan` / `Hang` supplemental faces) | the deck's *declared* fonts; use the matching script when `ea` is empty |
| `theme.sizes.title` / `body` (pt) | the deck's *declared* placeholder sizes (master `txStyles`) — the size a run inherits when it sets no explicit `sz`; `body` is the **level-1** default (coarsest, commonly over-reads) |
| `theme.sizes.body_levels` (pt list) | the full master `bodyStyle` ramp (lvl1..lvl9, e.g. `[32, 28, 24, 20, …]`) — **reference context** so you can read a deeper level than the over-reading level-1, not an auto-seed |
| `observed.colors` / `observed.fonts` (`latin` / `ea`, frequency-ranked) | a usage **sample / frequency hint** — run-level fonts + explicit `srgbClr` fills across slides |
diff --git a/skills/ppt-master/workflows/stages/customize-animations.md b/skills/ppt-master/workflows/stages/customize-animations.md
index c8e30a58..0a22ac22 100644
--- a/skills/ppt-master/workflows/stages/customize-animations.md
+++ b/skills/ppt-master/workflows/stages/customize-animations.md
@@ -319,7 +319,8 @@ selected effect. Before writing a parameterized effect, run
`python3 skills/ppt-master/scripts/pptx_animations.py --describe
<canonical_effect>` and use the returned values exactly. `duration` owns
PowerPoint Speed; `accelerate`/`decelerate` own smooth start/end, so do not
-invent duplicate fields.
+invent duplicate fields. Change Font's `font_name` is one concrete
+target-installed PowerPoint face, never a CSS font stack.
**Canonical example — every slide carries explicit transition + animation;
groups appear only when they diverge**: