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: measure paragraphs that open with an inline run; calc line takes categories and refuses bad values
hugohe309ad58f0d58d
diff --git a/skills/ppt-master/references/executor-chart.md b/skills/ppt-master/references/executor-chart.mdindex 2717f9e6..a857428e 100644--- a/skills/ppt-master/references/executor-chart.md+++ b/skills/ppt-master/references/executor-chart.md@@ -69,7 +69,7 @@ After each page containing verified charts: `rg -n "chart-plot-area" <project_pa----**ChartEx** (`waterfall`, `funnel`, `histogram`, `pareto`, `treemap`, `sunburst`, `box_whisker`) takes no `axes`, `plot_area`, or `data_labels`; values travel only as companion text, so draw no tick/value labels the payload cannot carry, or pick a classic type.+**ChartEx** (`waterfall`, `funnel`, `histogram`, `pareto`, `treemap`, `sunburst`, `box_whisker`) takes no `axes`, `plot_area`, or `data_labels`; values travel only as companion text — one `notes[]` entry per drawn value label, no tick labels — or pick a classic type.## 3. Verification Handoffdiff --git a/skills/ppt-master/references/native-data-interface.md b/skills/ppt-master/references/native-data-interface.mdindex 415157ee..386abef1 100644--- a/skills/ppt-master/references/native-data-interface.md+++ b/skills/ppt-master/references/native-data-interface.md@@ -29,7 +29,7 @@ Both keep the JSON inside the SVG; `native_payloads.json.gz` is for opaque shape**Hard rule — selected-object authoring**: write the marker and JSON for every supported chart and pure text-grid table in the same edit — both are native-ready by default, and an unactivated marker changes no export, so never skip an eligible object. Default reads the key from §IX `Native-ready: <object-key>=yes|no; …`; Quick assigns the same page-local `kebab-case` key before drawing; the key is the marker group `id` and metadata `name`. A catalog `family/key`, §VII row, numeric content, or another ready object never implies eligibility; `=no` entries and incidental microvisuals stay on the fallback route; a legacy bare `Native-ready: yes|no` maps only to the page's sole eligible object. **MUST — atomic authoring**: one object's visible fallback, `data-pptx-replace-with` marker, and single JSON `<metadata>` child are one authoring unit written while the data is in context, never deferred to `verify-charts`, the final gate, or export. Then stamp SVG-first objects:```bash-python3 skills/ppt-master/scripts/stamp_native_fallbacks.py "<svg-file-or-directory>" --write # read-only without --write; skips JSON-first+python3 ${SKILL_DIR}/scripts/stamp_native_fallbacks.py "<svg-file-or-directory>" --write # read-only without --write; skips JSON-first```The hash is a synchronization receipt, not proof of semantic equivalence; never stamp stale JSON to satisfy validation.diff --git a/skills/ppt-master/scripts/docs/native-data.md b/skills/ppt-master/scripts/docs/native-data.mdindex 86b0668c..4f0811ff 100644--- a/skills/ppt-master/scripts/docs/native-data.md+++ b/skills/ppt-master/scripts/docs/native-data.md@@ -34,7 +34,7 @@ Cells accept `text`, `fill`, `fill_opacity`, `color`, `align`. (SVG-first parity- **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.- **Axes** — classic `axes` is a closed object of `category`, `value`, `secondary_category`, `secondary_value`, each with only `kind` (`text` / `date` / `value`), `position`, `visible`, `label_position` (`next_to` / `none` / `low` / `high`), `number_format`, `minimum`, `maximum`, `major_unit` (value axes), `reverse`, `major_gridlines`, `tick_marks` (`none` default / `out` / `in` / `cross`), tick-label `color` / `font_family` / `font_size` (SVG px) when one axis's labels differ from the chart-wide text style, and on value axes `cross_between` (`between` — points sit between ticks, the default written explicitly because renderers disagree when it is absent — or `mid_category` — the first point sits on the axis edge; SVG-first line/area export reads it from where the fallback line starts inside `plot_area`); single-plot `bar` takes `category` left/right and `value` bottom/top; pie-family rejects `axes`. For single-plot category charts, `kind: "date"` is supported only by `area`. Stock dates follow the separate Stock contract below. `position` is honoured through the axis crossing (`top` / `right` cross at the far category, and a reversed crossing axis swaps the ends). `scatter` / `bubble` use `x` and `y` roles only (`kind: "value"`; `x.position` bottom/top, `y.position` left/right) with the same fields. Logarithmic scales, minor units/gridlines, crossing values, display units, and tick skipping are unsupported.- **XY** — `scatter` and `bubble` use `series[].x` + `series[].y` (`bubble` adds one `series[].size` / `sizes` per point), or `series[].points` as `[x, y]` / `[x, y, size]` tuples or `{x, y, size}` objects.-- **ChartEx** — `treemap` / `sunburst` (`values` plus `levels[level][point]` or path-style `categories`; treemap `parent_label_layout: "banner" | "overlapping" | "none"` (default `overlapping`), PowerPoint labels only the top level and leaves), `histogram` (`values`), `pareto` / `waterfall` / `funnel` (`categories` + `values`; `waterfall` accepts `subtotals` / `subtotal_indices`), `boxWhisker` (`series[].values`, optional `series[].categories`). ChartEx writes no `<cx:title>` without a payload title (an empty title shows the series name), emits title/subtitle as companion text boxes, and takes `style.colors` / root `colors` into its color-style part. ChartEx accepts no `plot_area`, `axes`, or `data_labels` (each is refused); values reach the slide only through companion text such as `notes` / `caption`, so a tick or value label drawn in the fallback has no payload channel — choose a classic type when values must be labelled on the marks. Non-Microsoft renderers show a limited subset.+- **ChartEx** — `treemap` / `sunburst` (`values` plus `levels[level][point]` or path-style `categories`; treemap `parent_label_layout: "banner" | "overlapping" | "none"` (default `overlapping`), PowerPoint labels only the top level and leaves), `histogram` (`values`), `pareto` / `waterfall` / `funnel` (`categories` + `values`; `waterfall` accepts `subtotals` / `subtotal_indices`), `boxWhisker` (`series[].values`, optional `series[].categories`). ChartEx writes no `<cx:title>` without a payload title (an empty title shows the series name), emits title/subtitle as companion text boxes, and takes `style.colors` / root `colors` into its color-style part. ChartEx accepts no `plot_area`, `axes`, or `data_labels` (each is refused); values reach the slide only through companion text: register every drawn value label as its own `notes[]` entry with unique text (each is placed from its fallback `<text>` and survives the native export), and draw no tick labels, since an axis has no channel — or choose a classic type when the labels must be bound to the marks. Non-Microsoft renderers show a limited subset.- **Stock** — numeric Excel date serials in `categories` / `dates` plus exactly four series open / high / low / close (`series` with four entries or top-level `open` / `high` / `low` / `close`).- **Supported types**: `column`, `bar` (`grouping`: `clustered` / `stacked` / `percentStacked`); `line` (`grouping`: `standard` / `stacked` / `percentStacked`; `line_style`: `line` / `lineMarker`, default `line` with no markers); `area` (`grouping`: `standard` / `stacked` / `percentStacked`); `pie`, `doughnut`, `pieOfPie`, `barOfPie`; `radar`, `radarMarkers`, `radarFilled`; `scatter` (`scatter_style`: `marker` / `lineMarker` / `line` / `smoothMarker` / `smooth`, default `marker`); `bubble`; `combo`; `treemap`, `sunburst`; `histogram`, `pareto`; `boxWhisker`; `waterfall`, `funnel`; `stock`. 3D aliases and `surface` are unsupported; exploded pie/doughnut, `map`, `heatmap`, `bullet`, and `gantt` are deferred and fail fast.diff --git a/skills/ppt-master/scripts/svg_finalize/flatten_tspan.py b/skills/ppt-master/scripts/svg_finalize/flatten_tspan.pyindex a48d1b89..498e2e5f 100644--- a/skills/ppt-master/scripts/svg_finalize/flatten_tspan.py+++ b/skills/ppt-master/scripts/svg_finalize/flatten_tspan.py@@ -264,7 +264,10 @@ def _build_paragraph_child_view(raw_lead = text_el.text or ""synthetic_first: ET.Element | None = None- if raw_lead.strip():+ # A first visual line may also open with an inline run (a bold lead word)+ # and no direct text; it is the same leading line with an empty prefix.+ leads_with_inline_run = bool(direct_tspans) and not _is_new_line_tspan(direct_tspans[0])+ if raw_lead.strip() or leads_with_inline_run:base_x_raw = get_attr(text_el, "x")if base_x_raw is None:return Nonediff --git a/skills/ppt-master/scripts/svg_position_calculator.py b/skills/ppt-master/scripts/svg_position_calculator.pyindex d8f0dd05..208e87f2 100644--- a/skills/ppt-master/scripts/svg_position_calculator.py+++ b/skills/ppt-master/scripts/svg_position_calculator.py@@ -963,21 +963,34 @@ def parse_data_string(data_str: str) -> Dict[str, float]:def parse_xy_data_string(data_str: str) -> List[Tuple[float, float]]:- """Parse XY data string in 'x1:y1,x2:y2' format"""- result = []+ """Parse XY data string in 'x1:y1,x2:y2' format.++ A categorical series (`K:45.6,1:38.7,…`, `2018-19:26.4,…`) maps its labels+ to the ordinals 1..n, the same slot model `calc bar` uses, so a line or+ area chart over school years or grades verifies as drawn. A value that+ cannot be read is an error rather than a silently dropped point: a+ verifier that changes the point count verifies a different chart.+ """+ pairs: List[Tuple[str, float]] = []for item in data_str.split(','):item = item.strip()if not item:continue- if ':' in item:- x, y = item.split(':', 1)- try:- result.append((float(x.strip()), float(y.strip())))- except ValueError:- print(f"[Warning] Unable to parse coordinates: '{item}', skipped")- else:- print(f"[Warning] Invalid format (expected 'x:y'): '{item}'")- return result+ if ':' not in item:+ raise ValueError(f"Invalid format (expected 'x:y'): '{item}'")+ x, y = item.rsplit(':', 1)+ try:+ pairs.append((x.strip(), float(y.strip())))+ except ValueError as exc:+ raise ValueError(f"Unable to parse value: '{item}'") from exc+ try:+ return [(float(x), y) for x, y in pairs]+ except ValueError:+ print(+ f"[Note] Category axis: {len(pairs)} labels mapped to ordinals 1..{len(pairs)} "+ "(pass --x-range=0.5,N+0.5 to centre them in equal slots)"+ )+ return [(float(index), y) for index, (_label, y) in enumerate(pairs, start=1)]def parse_tuple(s: str) -> Tuple[float, ...]:@@ -1168,7 +1181,11 @@ def interactive_mode() -> None:canvas = input("Canvas format [ppt169]: ").strip() or 'ppt169'coord = CoordinateSystem(canvas)calc = LineChartCalculator(coord)- data = parse_xy_data_string(data_str)+ try:+ data = parse_xy_data_string(data_str)+ except ValueError as exc:+ print(f"[Error] {exc}")+ continuepoints = calc.calculate(data)print()print(calc.format_table(points))@@ -1458,7 +1475,10 @@ Common commands:canvas = args.canvas if hasattr(args, 'canvas') else 'ppt169'coord = CoordinateSystem(canvas, chart_area)calc = LineChartCalculator(coord)- data = parse_xy_data_string(args.data)+ try:+ data = parse_xy_data_string(args.data)+ except ValueError as exc:+ parser.error(f'calc line --data: {exc}')x_range = parse_tuple(args.x_range) if args.x_range else Noney_range = parse_tuple(args.y_range) if args.y_range else Nonediff --git a/skills/ppt-master/scripts/svg_quality/checker.py b/skills/ppt-master/scripts/svg_quality/checker.pyindex 9606c699..c6ef2b5c 100644--- a/skills/ppt-master/scripts/svg_quality/checker.py+++ b/skills/ppt-master/scripts/svg_quality/checker.py@@ -3260,7 +3260,10 @@ class SVGQualityChecker:return Noneline_groups = Nonesynthetic_first = None- if (text_el.text or '').strip():+ leads_with_inline_run = (+ cls._is_tspan(children[0]) and not cls._is_line_tspan(children[0])+ )+ if (text_el.text or '').strip() or leads_with_inline_run:if _classify_paragraph_block is None:return Noneparagraph = _classify_paragraph_block(diff --git a/skills/ppt-master/scripts/tests/test_svg_quality_checker.py b/skills/ppt-master/scripts/tests/test_svg_quality_checker.pyindex b673808f..6ec14139 100644--- a/skills/ppt-master/scripts/tests/test_svg_quality_checker.py+++ b/skills/ppt-master/scripts/tests/test_svg_quality_checker.py@@ -36,6 +36,25 @@ def _empty_result() -> dict:return {'errors': [], 'warnings': []}+class LeadingInlineRunParagraphTests(unittest.TestCase):+ def test_first_line_opening_with_an_inline_run_is_a_paragraph(self) -> None:+ svg = (+ '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1280 720">'+ '<text x="460" y="318" font-size="18">'+ '<tspan font-weight="bold">Trigger</tspan> — already chronically absent'+ '<tspan x="460" dy="26"><tspan font-weight="bold">Action</tspan> — case review</tspan>'+ '<tspan x="460" dy="26"><tspan font-weight="bold">Owner</tspan> — coordinator</tspan>'+ '</text></svg>'+ )+ root = ET.fromstring(svg)+ text_el = next(iter(root))+ classified = checker_module._classify_paragraph_block(text_el, preserve_line_breaks=True)+ self.assertIsNotNone(classified)+ _base, _extras, _breaks, line_groups, synthetic_first = classified+ self.assertEqual(len(line_groups), 3)+ self.assertIsNotNone(synthetic_first)++class TextPictureFillReferenceTests(unittest.TestCase):def test_text_picture_fill_pattern_image_counts_as_a_rendered_reference(self) -> None:svg = (diff --git a/skills/ppt-master/scripts/text_measure.py b/skills/ppt-master/scripts/text_measure.pyindex 9f204ede..13ed505b 100644--- a/skills/ppt-master/scripts/text_measure.py+++ b/skills/ppt-master/scripts/text_measure.py@@ -51,6 +51,8 @@ _CALIBRATION_CJK_SAMPLE = '天地玄黄宇宙洪荒日月盈昃辰宿列张寒_CALIBRATION_LATIN_SAMPLE = 'Clear Slides Make Big Ideas Easy to See.'_CALIBRATION_CAPS_SAMPLE = 'CLEAR SLIDES MAKE BIG IDEAS EASY TO SEE.'_CALIBRATION_DIGITS_SAMPLE = '0123456789'+# A source line: dataset ids, years, brackets and caps mixed into prose.+_CALIBRATION_CITATION_SAMPLE = 'NYC DOE, dataset sgsi-66kk (2018-19 to 2022-23), v2.1'_CORE_CALIBRATION_ROLES = ('body', 'title', 'subtitle', 'annotation')_SLIDE_HEADING_RE = re.compile(r'^#{3,6}[ \t]+Slide[ \t]+([0-9]+|NN)\b.*$',@@ -506,6 +508,7 @@ def _calibration_payload(cjk_length = len(split_project_text_clusters(_CALIBRATION_CJK_SAMPLE))latin_length = len(split_project_text_clusters(_CALIBRATION_LATIN_SAMPLE))digits_length = len(split_project_text_clusters(_CALIBRATION_DIGITS_SAMPLE))+ citation_length = len(split_project_text_clusters(_CALIBRATION_CITATION_SAMPLE))role_rows = {}for name, family, size in roles:weight = weights.get(name, 'normal')@@ -514,6 +517,7 @@ def _calibration_payload(latin_width = measure_text(_CALIBRATION_LATIN_SAMPLE, **style)caps_width = measure_text(_CALIBRATION_CAPS_SAMPLE, **style)digits_width = measure_text(_CALIBRATION_DIGITS_SAMPLE, **style)+ citation_width = measure_text(_CALIBRATION_CITATION_SAMPLE, **style)role_rows[name] = {'family': family,'size': size,@@ -522,6 +526,7 @@ def _calibration_payload('latin_chars_per_100px': round(100.0 * latin_length / latin_width, 1),'caps_chars_per_100px': round(100.0 * latin_length / caps_width, 1),'digits_chars_per_100px': round(100.0 * digits_length / digits_width, 1),+ 'citation_chars_per_100px': round(100.0 * citation_length / citation_width, 1),'longest_planned_line': longest[name],}return {@@ -556,7 +561,7 @@ def _fallback_notes(def _render_calibration_table(payload: dict[str, object], *, include_outline: bool) -> str:role_rows = payload['roles']assert isinstance(role_rows, dict)- headers = ['role', 'family', 'size', 'CJK ≈chars/100px', 'Latin ≈chars/100px', 'CAPS ≈chars/100px', 'DIGITS ≈chars/100px']+ headers = ['role', 'family', 'size', 'CJK ≈chars/100px', 'Latin ≈chars/100px', 'CAPS ≈chars/100px', 'DIGITS ≈chars/100px', 'CITE ≈chars/100px']if include_outline:headers.append('longest planned line (px, slide, text)')lines = [@@ -574,6 +579,7 @@ def _render_calibration_table(payload: dict[str, object], *, include_outline: bof'{raw_row["latin_chars_per_100px"]:.1f}',f'{raw_row["caps_chars_per_100px"]:.1f}',f'{raw_row["digits_chars_per_100px"]:.1f}',+ f'{raw_row.get("citation_chars_per_100px", 0.0):.1f}',]if include_outline:planned = raw_row['longest_planned_line']@@ -606,7 +612,8 @@ def _render_calibration_table(payload: dict[str, object], *, include_outline: bo'estimator (headroom included); the checker measures each real line ''glyph by glyph, so capital-heavy words (WebGPU, GDP), digits (1935, ''83.2%) and wide letters run wider than the Latin rate — use the CAPS '- 'rate for acronyms and uppercase, the DIGITS rate for numbers, and keep '+ 'rate for acronyms and uppercase, the DIGITS rate for numbers, the CITE '+ 'rate for source lines (dataset ids, years, brackets), and keep ''about 5% below any bounds width.')return '\n'.join(lines) + '\n'diff --git a/skills/ppt-master/workflows/generate-pptx.md b/skills/ppt-master/workflows/generate-pptx.mdindex 354c6901..62716341 100644--- a/skills/ppt-master/workflows/generate-pptx.md+++ b/skills/ppt-master/workflows/generate-pptx.md@@ -63,7 +63,7 @@ python3 ${SKILL_DIR}/scripts/project_manager.py import-sources <project_path> <s**Workflow log**: initialization creates `<project_path>/validation/workflow.log`; later project-scoped Python tools record their command envelopes there automatically (prefix `PPT_MASTER_PROJECT_PATH="<project_path>"` when a helper's arguments do not identify the project). Append one concise note with `python3 ${SKILL_DIR}/scripts/workflow_log.py <project_path> "<detail>"` only for a material handoff, rework reason, approved exception, or manual recovery with no owning command output. The log is cold audit evidence, never read during generation.-**Import rules**: pass the source path once when Step 1 wrote Markdown beside it, both locations when `-o` wrote it elsewhere, and only the research pair when Topic Research ran (its facts JSON is imported as a file; no URL is fetched). Copy/move semantics, bitmap archiving, and the PPTX intake bundle it writes under `analysis/` (`<stem>.identity.json`, `<stem>.slide_library.json`, `source_profile.json`) are [`project.md`](../scripts/docs/project.md). Those artifacts are source facts and recommendation candidates, not replica constraints; Beautify stays single-deck.+**Import rules**: pass the source path together with the Markdown Step 1 wrote beside it (a same-stem Markdown suppresses re-conversion and is imported with its sidecar and assets; the source alone is archived and converted again), both locations when `-o` wrote it elsewhere, and only the research pair when Topic Research ran (its facts JSON is imported as a file; no URL is fetched). Copy/move semantics, bitmap archiving, and the PPTX intake bundle it writes under `analysis/` (`<stem>.identity.json`, `<stem>.slide_library.json`, `source_profile.json`) are [`project.md`](../scripts/docs/project.md). Those artifacts are source facts and recommendation candidates, not replica constraints; Beautify stays single-deck.**✅ Checkpoint** — project created, `sources/` complete, converted materials ready. `import-sources` exits 0 when any input converts: read the printed `skipped` reasons and treat those inputs as absent. Proceed to Step 3.diff --git a/skills/ppt-master/workflows/stages/apply-template-workspace.md b/skills/ppt-master/workflows/stages/apply-template-workspace.mdindex ca244b09..4b846a49 100644--- a/skills/ppt-master/workflows/stages/apply-template-workspace.md+++ b/skills/ppt-master/workflows/stages/apply-template-workspace.md@@ -44,7 +44,7 @@ Read [`templates/README.md`](../../templates/README.md), then only the README foA Layout created with `mirror` stays eligible only when its source is brand-neutral and application-neutral; keep a branded or application-bearing source as a Deck or re-author it through `standard` / `fidelity`. Before mapping any workspace, run the shared package validator from its root — Brand/Style are roster-free, the active structure validates its roster, a shadowed Deck still validates its contract; any error blocks installation:```bash-python3 skills/ppt-master/scripts/svg_quality_checker.py "<workspace_root>/templates" --template-mode --canonical-authoring+python3 ${SKILL_DIR}/scripts/svg_quality_checker.py "<workspace_root>/templates" --template-mode --canonical-authoring```## 3. Structured Preflight@@ -71,7 +71,7 @@ Validate each normalized root once. The effective structural owner is Layout whe**Command**: the mapping, provenance line, asset copy, collision and duplicate-kind refusal, and completion receipt below are one run of the install tool (add `--dry-run` to review the mapping first; `--skip-validation` only when the §2 checker already ran on that root in this turn); [`template-tools.md`](../../scripts/docs/template-tools.md#apply_templatepy) owns its behavior:```bash-python3 skills/ppt-master/scripts/apply_template.py <project_path> --root <workspace_root> [--root <workspace_root> ...]+python3 ${SKILL_DIR}/scripts/apply_template.py <project_path> --root <workspace_root> [--root <workspace_root> ...]```**Atomic install preflight**: resolve every source and destination path; enumerate the union mapping across all roots and across `templates/`, `images/`, `icons/`, mapping each source file at most once; resolve Layout-over-Deck precedence before building the map so the shadowed roster never enters it; reject every destination collision and duplicate kind before writing; write the accepted mapping once — never recursive copy as an implicit conflict policy. An input equal to the target project is consumed in place; if a selected Layout supersedes its in-place Deck roster, stage the mapping and replace the roster atomically.diff --git a/skills/ppt-master/workflows/stages/customize-animations.md b/skills/ppt-master/workflows/stages/customize-animations.mdindex a3ba148d..52fb067a 100644--- a/skills/ppt-master/workflows/stages/customize-animations.md+++ b/skills/ppt-master/workflows/stages/customize-animations.md@@ -38,7 +38,7 @@ Before editing `animations.json`, read every semantic file that exists — `desi| Sidecar with no new instruction | Validate and preserve unchanged; repair an invalid sidecar/group reference before export || Ambiguous request | Default asks regenerate-or-modify; Quick decides from the request, SVG, and sidecar |-Unless an all-motion disable bypasses it, validate an existing sidecar first: `python3 skills/ppt-master/scripts/animation_config.py validate <project_path>`.+Unless an all-motion disable bypasses it, validate an existing sidecar first: `python3 ${SKILL_DIR}/scripts/animation_config.py validate <project_path>`.**Hard rule**: semantic files determine motion intent and unit boundaries; the current `svg_output/*.svg` supplies visible content and implementation structure, and its existing `<g>` hierarchy is never accepted as the plan merely because it exists.@@ -103,13 +103,13 @@ Only after visual transition, lifecycle, effect, order, and timing are complete,## 5. Validate and Return to Generate Export-When `animations.json` was created or changed after §1, run `python3 skills/ppt-master/scripts/animation_config.py validate <project_path>`, then return to the owning export path — Default [`generate-pptx.md`](../generate-pptx.md) Step 7.1; Quick [`quick-generate.md`](../profiles/quick-generate.md) §4 — both of which read the sidecar automatically. If §2 changed `svg_output/`, complete the owning route's final SVG rerun before returning; never finalize or export from this stage.+When `animations.json` was created or changed after §1, run `python3 ${SKILL_DIR}/scripts/animation_config.py validate <project_path>`, then return to the owning export path — Default [`generate-pptx.md`](../generate-pptx.md) Step 7.1; Quick [`quick-generate.md`](../profiles/quick-generate.md) §4 — both of which read the sidecar automatically. If §2 changed `svg_output/`, complete the owning route's final SVG rerun before returning; never finalize or export from this stage.**Validation**: every invalid field, target, or Morph pair fails rather than falling back ([`pptx-animations.md`](../../scripts/docs/pptx-animations.md) §6). A passing sidecar and read-back prove the PPTX configuration, not an exported MP4 audio track.### 5.1 Optional Video Motion Handoff-When a downstream renderer will enhance the deck, have Step 7.3 append `--conversion-trace`, then derive the plan from the final resolved trace (the `--recorded-narration` trace for narrated output): `python3 skills/ppt-master/scripts/video_motion_plan.py <project_path>/validation/<output_stem>.trace.json -o <project_path>/validation/video_motion_plan.json --style adaptive --force`. The plan locks identity, effect, direction, order, bounds, and timing and may refine renderer parameters only ([`video-motion-plan.md`](../../scripts/docs/video-motion-plan.md)). With resolved sound cues on the native-export branch, the same final trace and narrated PPTX feed `video_sound_mix.py`; an explicit slideshow capture records native cue playback and uses no trace for mixing.+When a downstream renderer will enhance the deck, have Step 7.3 append `--conversion-trace`, then derive the plan from the final resolved trace (the `--recorded-narration` trace for narrated output): `python3 ${SKILL_DIR}/scripts/video_motion_plan.py <project_path>/validation/<output_stem>.trace.json -o <project_path>/validation/video_motion_plan.json --style adaptive --force`. The plan locks identity, effect, direction, order, bounds, and timing and may refine renderer parameters only ([`video-motion-plan.md`](../../scripts/docs/video-motion-plan.md)). With resolved sound cues on the native-export branch, the same final trace and narrated PPTX feed `video_sound_mix.py`; an explicit slideshow capture records native cue playback and uses no trace for mixing.---