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: sync filter targets, calibrate notes, chart schema key, story canvas geometry
hugohe3fbbb8636ad77
diff --git a/skills/ppt-master/references/canvas-formats.md b/skills/ppt-master/references/canvas-formats.mdindex ee6b88dc..be062fd2 100644--- a/skills/ppt-master/references/canvas-formats.md+++ b/skills/ppt-master/references/canvas-formats.md@@ -48,7 +48,10 @@ low = round(span * 0.025); start = round(span * 0.029); high = round(span * 0.03| `wechat` | 900 | 23–30 | 26 || `moments` | 1080 | 27–36 | 31 || `xiaohongshu` | 1660 | 42–55 | 48 |-| `story` / `banner` | 1920 | 48–63 | 56 |+| `banner` | 1920 | 48–63 | 56 |+| `story` | 1920 | 48–63 | 56 || `a4` | 1754 | 44–58 | 51 |+`story` and `banner` share one span but not one measure: the same body size sits on a 1920 px line in `banner` and a 1080 px line in `story` (about half the characters per line), so portrait pages often settle at the low end of the band.+**Default — starting anchor, not a floor (may override when confirmed identity, source fidelity, or target viewing conditions require it)**: start from the table or formula, then resolve the complete role ramp and page density from the content and delivery context. The band only surfaces unusual values; falling outside it is not a validation failure. Apply the viewing-distance baseline in [`shared-standards-core.md`](./shared-standards-core.md) instead of silently shrinking a recurring role to make content fit.diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.mdindex dd6345dc..4426be1f 100644--- a/skills/ppt-master/references/executor-base.md+++ b/skills/ppt-master/references/executor-base.md@@ -71,7 +71,7 @@ Read this before §1: the expression vocabulary every page draws from — what e| Elevated primary object | The one card, image, or CTA that sits above the page | `softShadow` at resting opacity on that object; peers stay flat || Duotone or brand-wash image | A photo that must join the deck palette instead of fighting it | Wash gradient over the picture, or a prepared duotone derivative ([`svg-effects.md`](./svg-effects.md) §6.5 / §6.12) |-**Reference — layout structures (starting points; proportion follows information weight)**: 16:9 values for 1280×720 — safe area 1200×640 with 40 px margins; title band ≈ 100 px, content field ≈ 500 px, footer ≈ 40 px. 4:3 values for 1024×768 — safe area 944×688 with 40 px margins; title band ≈ 90 px, content field ≈ 540 px, footer ≈ 40 px; the field is 256 px narrower than 16:9, so a text column beside an image needs ≥ 520 px or the page stacks top/bottom. A4 portrait values for 1240×1754 (`a4`, print) — 80 px margins, a running masthead band ≈ 100 px, body field 1080×1490, footer band ≈ 60 px; regions stack, an evidence margin of ≈ 330 px beside a ≥ 700 px argument column reads as a document, and a chart takes the full measure.+**Reference — layout structures (starting points; proportion follows information weight)**: 16:9 values for 1280×720 — safe area 1200×640 with 40 px margins; title band ≈ 100 px, content field ≈ 500 px, footer ≈ 40 px. 4:3 values for 1024×768 — safe area 944×688 with 40 px margins; title band ≈ 90 px, content field ≈ 540 px, footer ≈ 40 px; the field is 256 px narrower than 16:9, so a text column beside an image needs ≥ 520 px or the page stacks top/bottom. A4 portrait values for 1240×1754 (`a4`, print) — 80 px margins, a running masthead band ≈ 100 px, body field 1080×1490, footer band ≈ 60 px; regions stack, an evidence margin of ≈ 330 px beside a ≥ 700 px argument column reads as a document, and a chart takes the full measure. Story values for 1080×1920 (`story`) — 80 px margins, a 920 px measure, title band ≈ 90 px, meaning-bearing content ends near y ≈ 1740 ([`canvas-formats.md`](./canvas-formats.md) keep-clear band); regions stack, a side-by-side pair works only when both halves are near-square, and the bottom band below 1740 carries background bleed, texture, or a deliberately cropped element rather than dead space.| Content relationship | Useful starting structure | Starting geometry ||---|---|---|diff --git a/skills/ppt-master/references/svg-effects.md b/skills/ppt-master/references/svg-effects.mdindex 2e2a3a35..056c26dc 100644--- a/skills/ppt-master/references/svg-effects.md+++ b/skills/ppt-master/references/svg-effects.md@@ -177,7 +177,7 @@ Preset patterns are a separate PPT interface in [`native-data-interface.md`](./nA filter is native-effect metadata, not a pixel-filter surface: one direct`<defs><filter>` referenced as a direct `filter="url(#id)"` on a `<rect>`,-`<circle>`, `<image>`, `<path>`, `<text>`, or a helper-authored preset group,+`<circle>`, `<polygon>`, `<image>`, `<path>`, `<text>`, or a helper-authored preset group,built from `feDropShadow` or the blur + flood + composite + merge graph belowwith explicit `stdDeviation`, `dx`/`dy`, and `flood-opacity`. A meaningfuloffset becomes one outer shadow; zero offset — even `feDropShadow` withdiff --git a/skills/ppt-master/scripts/docs/conversion.md b/skills/ppt-master/scripts/docs/conversion.mdindex cd2b29bd..90ff5ada 100644--- a/skills/ppt-master/scripts/docs/conversion.md+++ b/skills/ppt-master/scripts/docs/conversion.md@@ -61,8 +61,10 @@ Useful options:`--no-images`, and `--filter-images` map to the PDF image mode.`--no-images` (or `--images none`) also applies to web pages (images stayremote links, no `<stem>_files/`) and is a no-op on Markdown/text.-- A `.md` / `.markdown` / `.txt` URL whose body is not HTML is saved verbatim- under a `Source:` header, named by the URL's filename stem.+- A URL that serves a PDF / Office document (by Content-Type, body magic, or+ suffix) is saved beside the Markdown and converted by that document's+ backend; a `.md` / `.txt` URL whose body is not HTML is saved verbatim+ under a `Source:` header, named by the URL stem.- Unknown backend-specific flags are passed through to each selected converter.- `-o/--output` selects one Markdown file for one input, or an output directoryfor multiple inputs / directory inputs.diff --git a/skills/ppt-master/scripts/docs/native-data.md b/skills/ppt-master/scripts/docs/native-data.mdindex 4f0811ff..1b02c88a 100644--- a/skills/ppt-master/scripts/docs/native-data.md+++ b/skills/ppt-master/scripts/docs/native-data.md@@ -29,6 +29,8 @@ Cells accept `text`, `fill`, `fill_opacity`, `color`, `align`. (SVG-first parity## §2 Chart schemas+Chart payloads carry no `schema` key: the marker's `data-pptx-replace-with` value selects the chart schema, and an invented key is rejected.+- **Category charts** — `column`, `bar`, `line`, `area`, `pie`, `doughnut`, `pieOfPie`, `barOfPie`, `radar`: `categories` plus `series[].values`. Column, bar, line, and area values may be `null` for a gap (the workbook cell stays blank, the cache omits the point, `dispBlanksAs` is `gap`; at least one value per series is a number) — a fallback that breaks one line into segments is two series of the same colour with `null` outside their segment. Pie-family charts take exactly one series with per-slice colors; `hole_size` is doughnut-only, integer `10..90`, default `75`; no rotation field. Column/bar may set `series[].point_colors` (camelCase `pointColors` is read-compatible; length = values). Bar categories run top-down in payload order — the exporter reverses the category axis and moves the value-axis crossing so the value axis keeps its declared position; `axes.category.reverse: false` restores PowerPoint's bottom-up order (column charts stay left-to-right unless `reverse: true`). Bar/column spacing: root `gap_width` (`0..500`, the empty slot share as a percentage of one bar; PowerPoint default `150`) and clustered `overlap` (`-100..100`, the share of one bar the next series covers, negative for a gap); SVG-first export reads both from the fallback bars inside `plot_area` when the payload omits them, JSON-first uses the defaults.- **Line markers** — `line_style: "lineMarker"` draws a circle at every point in the series colour; `marker_size` (root or per series, SVG px diameter, `2..72` pt after `×0.75`) sizes it. `series[].point_colors` on a line series marks single points: a colour draws that point's marker in that colour, `null` leaves it bare (with `line_style: "line"` only the coloured points carry markers), so an emphasised endpoint is `[null, …, "#C8102E"]`. Area series draw no markers; a line with markers over a fill is a `combo`. `data_labels` (column, bar, line, and area plots only, combo plots of those types included; pie-family, radar, scatter/bubble, stock, and ChartEx charts reject it — show their values through companion `notes`) is `true` or an object with `show_value`, `position`, `number_format`, `font_size`, `font_family`, `bold`, `color`, per-point `colors`, and `points` (zero-based `idx` plus optional overrides); positions: clustered column/bar `outside_end` / `inside_end` / `inside_base` / `center`, stacked `inside_end` / `inside_base` / `center`, line `above` / `center` / `best_fit`, area none. Set `data_labels.number_format` to match the fallback (the parity gate reads `0`, `0.0`, `0.00`, `#,##0`, `#,##0.0`, their `%` forms — which scale the value by 100 — and a quoted literal prefix/suffix such as `"$"#,##0` or `0.0"%"`; other codes match only the literal value)'s rendered value labels.- **Combo** — shared `categories` plus `plots[]` (`type: "column" | "line" | "area"`, own `series`, optional `axis: "secondary"`, optionally own `categories` / `category_numeric` when caches genuinely differ, and `series_indices` for imported identity — same-length unique non-negative integers forming one contiguous `0..N-1` range across plots) or typed `series[]` with per-series `type` / `axis` (adjacent compatible series share a plot). Area series may set `fill_opacity` (`0..1`; `fillOpacity` read-compatible); a line plot with `area_fill: true` exports as an area chart; line/area series may set `line_width` in SVG px (`lineWidth` read-compatible); column plots take `gap_width` / `overlap`, line plots `line_style` / `marker_size`. An area series is a fill without an outline; `line_width` adds a same-colour outline around the whole region (baseline included), so a fallback that strokes only the top edge — or draws markers on it — is an area plot under a line plot with the same values. Export layers areas below columns and lines.diff --git a/skills/ppt-master/scripts/docs/svg-contract.md b/skills/ppt-master/scripts/docs/svg-contract.mdindex 5072796e..ec5411c9 100644--- a/skills/ppt-master/scripts/docs/svg-contract.md+++ b/skills/ppt-master/scripts/docs/svg-contract.md@@ -554,7 +554,7 @@ Filters are native-effect metadata, not a general pixel-filter surface.| Concern | Contract ||---|---|| Definition/reference | Direct `<defs><filter id="...">` child with unique id; direct `filter="url(#id)"` attribute, never inline style |-| Public targets | `<rect>`, `<circle>`, `<image>`, `<path>`, `<text>`; one validated compact authored shape-preset `<g>`; an exact outer `<g filter>` whose sole visual child is one clipped `<image>` |+| Public targets | `<rect>`, `<circle>`, `<polygon>`, `<image>`, `<path>`, `<text>`; one validated compact authored shape-preset `<g>`; an exact outer `<g filter>` whose sole visual child is one clipped `<image>` || Required primitive | `feDropShadow` or `feGaussianBlur` || Generated glow form | Zero-offset `feDropShadow` with flood paint, or the complete blur + flood + composite + merge graph; never bare blur || Required parameters | Explicit `stdDeviation` on either effect primitive; explicit `dx`, `dy`, and `flood-opacity` on `feDropShadow`; explicit `flood-opacity` on `feFlood`; explicit `slope` on linear `feFuncA` |diff --git a/skills/ppt-master/scripts/docs/svg-pipeline.md b/skills/ppt-master/scripts/docs/svg-pipeline.mdindex d1090f5a..e5c2837d 100644--- a/skills/ppt-master/scripts/docs/svg-pipeline.md+++ b/skills/ppt-master/scripts/docs/svg-pipeline.md@@ -1037,9 +1037,12 @@ class-average estimate, with the existing fixed advances for monospaced faces.(headroom included), while the checker measures each real line glyph byglyph: capital-heavy words, digits, and wide letters run wider than the Latinrate, so the table also prints CAPS and DIGITS rates, and a zone should stay- about 5% below its bounds width. `--outline` adds the longest §IX planned+ about 5% below its bounds width. The rates ignore `letter-spacing`, so a+ tracked role or a display-size line is sized per string with `measure+ --letter-spacing`. `--outline` adds the longest §IX plannedline per role — the planned wording only; a line rewritten while authoring- is re-estimated with the rates. The checker's overflow+ is re-estimated with the rates. Quick projects have no Design Spec, so+ the column stays empty there and the table says so. The checker's overflowdiagnostic prints that line's average px per character, which is not areusable rate. A lock role without its own`<role>_family` resolves to `title_family` when the role name contains