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: bar calculator gap-width slots, sheet type spelling, narrower rule chrome token
hugohe3c47602895b18
diff --git a/skills/ppt-master/references/animations.md b/skills/ppt-master/references/animations.mdindex 4b450db0..61ea3c37 100644--- a/skills/ppt-master/references/animations.md+++ b/skills/ppt-master/references/animations.md@@ -234,7 +234,7 @@ Animations anchor on unique top-level `<g id>` content groups (`cover-title`, `c**Hard rule — existing groups are not custom-animation intent**: during the custom stage derive one group per logical motion unit from claims, comparisons, sequence, causality, and narration — splitting coarse wrappers and merging fragments without changing appearance, never to hit a count — and run `list-groups` only after that rewrite.-**Chrome stays static by default**: a `data-pptx-layer` group is structural and never animates, and a full-canvas background rect becomes the slide background, which cannot animate either. A static role/placeholder marker or a chrome-name id (background, header/footer, decor, watermark, page number, nav, logo, rule) keeps a group out of automatic animation and the scaffold; a sidecar entry that names it animates it — a background field panning (§4.1), a cover band sliding in — judged per page, never by category. Wrap logical sections in `<g id>` ([`shared-standards-core.md`](./shared-standards-core.md) §4.3); a root with no top-level group falls back to a bounded primitive set ([`svg-pipeline.md`](../scripts/docs/svg-pipeline.md)).+**Chrome stays static by default**: a `data-pptx-layer` group is structural and never animates, and a full-canvas background rect becomes the slide background, which cannot animate either. A static role/placeholder marker or a chrome-name id (background, header/footer, decor, watermark, page number, nav, logo, or a bare `rule` / decorative-line `hairline-rule`; a content group such as `commit-rule` is not chrome) keeps a group out of automatic animation and the scaffold; a sidecar entry that names it animates it — a background field panning (§4.1), a cover band sliding in — judged per page, never by category. Wrap logical sections in `<g id>` ([`shared-standards-core.md`](./shared-standards-core.md) §4.3); a root with no top-level group falls back to a bounded primitive set ([`svg-pipeline.md`](../scripts/docs/svg-pipeline.md)).---diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.mdindex c399b0a9..8ecbfa13 100644--- a/skills/ppt-master/references/executor-base.md+++ b/skills/ppt-master/references/executor-base.md@@ -280,7 +280,7 @@ Mechanical repetition comes from reusing one carrier and topology without a page**Checkpoints**:- **Phased generation** (recommended):- 1. **Visual Construction Phase**: generate all pages sequentially, applying every triggered branch while drawing. **MUST embed one object-scoped plot-area marker** per §IX-named or Quick-promoted value-driven chart object ([`executor-chart.md`](./executor-chart.md) §2); calibration follows in [`verify-charts`](../workflows/stages/verify-charts.md). Write every `<object-key>=yes` native marker plus JSON metadata atomically ([`native-data-interface.md`](./native-data-interface.md) §2) and stamp its baseline before the page's gate — `python3 ${SKILL_DIR}/scripts/stamp_native_fallbacks.py <project_path>/svg_output/<page>.svg --write`, rerun after any visible edit inside the marker group. **Reach for native presets** per §3.0 as you draw, decided by the object's intent, never by scanning finished paths; several presets for one page go through one `preset_shape_svg.py render-batch --input -` round (gradient/pattern paint stays ordinary SVG; a justified §6.4 shadow/glow stays on the helper-authored shape).+ 1. **Visual Construction Phase**: generate all pages sequentially, applying every triggered branch while drawing. **MUST embed one object-scoped plot-area marker** per §IX-named or Quick-promoted value-driven chart object ([`executor-chart.md`](./executor-chart.md) §2); calibration follows in [`verify-charts`](../workflows/stages/verify-charts.md). Write every `<object-key>=yes` native marker plus JSON metadata atomically ([`native-data-interface.md`](./native-data-interface.md) §2) and stamp its baseline before the page's gate — `python3 ${SKILL_DIR}/scripts/stamp_native_fallbacks.py <project_path>/svg_output/<page>.svg --write`, rerun after any visible edit inside the marker group, a `compact_svg_styles.py --inplace` rewrite included. **Reach for native presets** per §3.0 as you draw, decided by the object's intent, never by scanning finished paths; several presets for one page go through one `preset_shape_svg.py render-batch --input -` round (gradient/pattern paint stays ordinary SVG; a justified §6.4 shadow/glow stays on the helper-authored shape).2. **Quality gates**: the gate points and their commands are the route's — [`generate-pptx.md`](../workflows/generate-pptx.md) Step 6 or [`quick-generate.md`](../workflows/profiles/quick-generate.md) §3–4. The repair discipline at every gate is the same: run the checker unfiltered, review the complete issue set, fix every error plus the selected warnings in one consolidated pass, verify once. Never check between individual fixes, never `cat` a passing report, never defer errors past `finalize_svg.py` (it rewrites SVG and masks violations). Every `warning` is advisory.3. **Logic Construction Phase (conditional)**: after the gates pass, generate speaker notes for narrative continuity only when the effective Speaker Notes outcome is enabled.diff --git a/skills/ppt-master/references/image-generator.md b/skills/ppt-master/references/image-generator.mdindex ee1dd039..fc061323 100644--- a/skills/ppt-master/references/image-generator.md+++ b/skills/ppt-master/references/image-generator.md@@ -148,7 +148,7 @@ Shape families that cannot share a roomy grid take separate sheets; coherence co| Row | Content ||---|---|-| **Sheet row** | `Acquire Via: ai`, `Type: Illustration Sheet`, named as the slice source with intent, cell shape, and purpose (`Reference: reusable title/corner illustration family`, `illustrated-icon set: cues = ...`, or `decorative lettering set: exact strings = ...`). Step 5 generates it; it is never placed; Image_Generator resolves its aspect ratio, grid, and slice command. Its manifest item carries `slice_grid` and `slice_names` — the comma-separated basenames are the complete required output set |+| **Sheet row** | `Acquire Via: ai`, `Type: Illustration Sheet` (the §VIII column; the manifest item omits `type`), named as the slice source with intent, cell shape, and purpose (`Reference: reusable title/corner illustration family`, `illustrated-icon set: cues = ...`, or `decorative lettering set: exact strings = ...`). Step 5 generates it; it is never placed; Image_Generator resolves its aspect ratio, grid, and slice command. Its manifest item carries `slice_grid` and `slice_names` — the comma-separated basenames are the complete required output set || **Element rows** | One per used element, `Acquire Via: slice`, filename matching `--names`, `Reference` naming the parent and cell, listed in the placeable authority normally with `crop=no-crop` (tight slices use fit, not cover-crop), `Type: Illustrated icon` for a compact cue (never an SVG library entry), reusable across pages, each carrying an owner-resolved layout recommendation, dimensions filled after slicing by `analyze_images.py` |```bashdiff --git a/skills/ppt-master/references/native-shape-authoring.md b/skills/ppt-master/references/native-shape-authoring.mdindex 0080b1b6..6f530509 100644--- a/skills/ppt-master/references/native-shape-authoring.md+++ b/skills/ppt-master/references/native-shape-authoring.md@@ -38,7 +38,7 @@ python3 ${SKILL_DIR}/scripts/shape_boolean_svg.py render <svg-file> \|---|---|| Mirror/preserve input already owns native-shape metadata | Keep the object and metadata; never reselect its preset || One exact non-Connector stock contour | Ordinary SVG primitive only when the exporter maps it to that same contour; otherwise `render` and insert the fragment |-| A stock `bentConnector*` / `curvedConnector*` contour expresses a bend or curve with no endpoint attachment | `render --object-kind connector`; an unconnected native Connector |+| A stock `bentConnector*` / `curvedConnector*` contour expresses a bend or curve with no endpoint attachment | `render --object-kind connector`; an unconnected native Connector with no line-end markers (the fragment accepts none), so an arrowed edge stays a `<line>` with a §1.1 marker || A straight relationship, divider, or leader | `<line>`, with a §1.1 marker only when direction is meaningful || A boundary that needs no filled surface | The exact form with `fill="none"` and a visible stroke; content stays an independent sibling || Two or more native contours form the construction without needing one contour | Independent siblings in one semantic group, composed under §2.1 |diff --git a/skills/ppt-master/references/visual-styles/blueprint.md b/skills/ppt-master/references/visual-styles/blueprint.mdindex 9872a1b7..13998b69 100644--- a/skills/ppt-master/references/visual-styles/blueprint.md+++ b/skills/ppt-master/references/visual-styles/blueprint.md@@ -31,7 +31,7 @@ Engineering schematic — thin line work on dark blueprint paper, isometric proj## 5. Paired image-rendering-`blueprint` — lock it so AI imagery shares the schematic line-drawing aesthetic.+`blueprint` — one coherence candidate for AI imagery that shares the schematic line-drawing aesthetic; the resolved rendering decision owns the choice.## 6. Illustration propensitydiff --git a/skills/ppt-master/references/visual-styles/swiss-minimal.md b/skills/ppt-master/references/visual-styles/swiss-minimal.mdindex 482cbc27..e6ce2d1f 100644--- a/skills/ppt-master/references/visual-styles/swiss-minimal.md+++ b/skills/ppt-master/references/visual-styles/swiss-minimal.md@@ -32,7 +32,7 @@ Strict Swiss-grid discipline. Modular grid, sharp geometry, aggressive whitespac## 5. Paired image-rendering-`minimalist-swiss` — lock it for AI images so illustrations share the grid-austere aesthetic.+`minimalist-swiss` — one coherence candidate for AI images that shares the grid-austere aesthetic; the resolved rendering decision owns the choice.## 6. Illustration propensitydiff --git a/skills/ppt-master/scripts/docs/svg-pipeline.md b/skills/ppt-master/scripts/docs/svg-pipeline.mdindex 383324e3..328da3c1 100644--- a/skills/ppt-master/scripts/docs/svg-pipeline.md+++ b/skills/ppt-master/scripts/docs/svg-pipeline.md@@ -1115,6 +1115,7 @@ Use this after `svg_quality_checker.py` passes, and only for chart types support```bashpython3 scripts/svg_position_calculator.py calc bar --data "A:185,B:142" --area "130,155,1200,480" --bar-width 120+python3 scripts/svg_position_calculator.py calc bar --data "A:185,B:142" --area "130,155,1200,480" --gap-width 150 # native-ready: equal category slots, bar width = slot / (1 + gap_width/100)python3 scripts/svg_position_calculator.py calc line --data "0:50,10:80,20:120" --area "120,120,1200,600" --y-range "0,150"python3 scripts/svg_position_calculator.py calc pie --data "A:35,B:25,C:20" --center "420,400" --radius 200python3 scripts/svg_position_calculator.py calc grid --rows 2 --cols 3 --area "50,150,1230,670"diff --git a/skills/ppt-master/scripts/image_gen.py b/skills/ppt-master/scripts/image_gen.pyindex 7e99db30..07859243 100644--- a/skills/ppt-master/scripts/image_gen.py+++ b/skills/ppt-master/scripts/image_gen.py@@ -548,6 +548,7 @@ STRUCTURAL_IMAGE_TYPES = {}LEGACY_IMAGE_TYPES = {"background", "hero", "portrait", "typography"}EARLY_LEGACY_IMAGE_TYPES = {"illustration", "photography"}+SHEET_TYPE_SPELLINGS = {"illustration sheet", "sheet"}VALID_IMAGE_TYPES = (STRUCTURAL_IMAGE_TYPES| LEGACY_IMAGE_TYPES@@ -710,6 +711,11 @@ def load_manifest(path: str) -> dict:)image_type = item.get("type")+ if isinstance(image_type, str) and image_type.strip().lower() in SHEET_TYPE_SPELLINGS:+ # The resource-row column reads "Illustration Sheet"; the manifest+ # item omits type. Accept the row spelling as that omission.+ item.pop("type")+ image_type = Noneif image_type is not None:normalized_type = (image_type.strip().lower()diff --git a/skills/ppt-master/scripts/svg_position_calculator.py b/skills/ppt-master/scripts/svg_position_calculator.pyindex 7278d60c..d8f0dd05 100644--- a/skills/ppt-master/scripts/svg_position_calculator.py+++ b/skills/ppt-master/scripts/svg_position_calculator.py@@ -1328,6 +1328,9 @@ Common commands:bar_parser.add_argument('--canvas', default='ppt169', help='Canvas format')bar_parser.add_argument('--area', help='Chart area "x_min,y_min,x_max,y_max"')bar_parser.add_argument('--bar-width', type=float, default=50, help='Bar width')+ bar_parser.add_argument('--gap-width', type=float, default=None,+ help='PowerPoint category gap width in percent of the bar (native payload gap_width, default 150): '+ 'lays categories out in equal slots across the area and derives the bar width, overriding --bar-width')bar_parser.add_argument('--horizontal', action='store_true', help='Horizontal bar chart')bar_parser.add_argument('--value-range', help='Value axis range "min,max" (from axis tick labels; omit to auto-normalize)')@@ -1411,11 +1414,21 @@ Common commands:parser.error('calc bar --value-range max must be greater than min')scale_source = f'axis ticks ({v_min}-{v_max})'- positions = calc.calculate(data, bar_width=args.bar_width,- horizontal=args.horizontal,- y_min=v_min, y_max=v_max)+ if args.gap_width is not None:+ if args.gap_width < 0:+ parser.error('calc bar --gap-width must be zero or positive')+ positions = calc.calculate(data, bar_width=None,+ gap_ratio=args.gap_width / 100.0,+ horizontal=args.horizontal,+ y_min=v_min, y_max=v_max)+ else:+ positions = calc.calculate(data, bar_width=args.bar_width,+ horizontal=args.horizontal,+ y_min=v_min, y_max=v_max)print(f"\n=== Bar Chart Coordinate Calculation ===")+ if args.gap_width is not None:+ print(f"Category layout: PowerPoint slots, gap_width {args.gap_width:g}% (bar width derived)")print(f"Canvas: {CANVAS_FORMATS.get(canvas, {}).get('dimensions', canvas)}")print(f"Chart area: ({coord.chart_area.x_min}, {coord.chart_area.y_min}) - "f"({coord.chart_area.x_max}, {coord.chart_area.y_max})")diff --git a/skills/ppt-master/scripts/svg_to_pptx/animation_config.py b/skills/ppt-master/scripts/svg_to_pptx/animation_config.pyindex ff5d4386..2e04dd9c 100644--- a/skills/ppt-master/scripts/svg_to_pptx/animation_config.py+++ b/skills/ppt-master/scripts/svg_to_pptx/animation_config.py@@ -67,7 +67,15 @@ _CHROME_ID_TOKENS = frozenset({'header', 'footer','chrome', 'watermark','pagenumber', 'pagenum', 'slidenumber', 'slidenum',- 'logo', 'nav', 'rule',+ 'logo', 'nav',+})+# `rule` is chrome only as a bare id or a decorative line name (`rule`,+# `rule-2`, `hairline-rule`); a content group such as `commit-rule` is not.+_RULE_TOKENS = frozenset({'rule', 'rules'})+_RULE_QUALIFIERS = frozenset({+ 'hairline', 'thin', 'horizontal', 'vertical', 'h', 'v',+ 'top', 'bottom', 'left', 'right', 'mid', 'middle',+ 'section', 'page', 'title', 'header', 'footer', 'divider',})@@ -112,8 +120,20 @@ def is_chrome_id(elem_id: str | None) -> bool:compact = lower.replace('-', '').replace('_', '')if compact in _CHROME_ID_TOKENS:return True- tokens = re.split(r'[-_]', lower)- return any(t in _CHROME_ID_TOKENS for t in tokens if t)+ tokens = [t for t in re.split(r'[-_]', lower) if t]+ if any(t in _CHROME_ID_TOKENS for t in tokens):+ return True+ if compact in _RULE_TOKENS:+ return True+ if tokens and tokens[0] in _RULE_TOKENS and all(+ t.isdigit() or t in _RULE_QUALIFIERS for t in tokens[1:]+ ):+ return True+ if tokens and tokens[-1] in _RULE_TOKENS and all(+ t in _RULE_QUALIFIERS or t.isdigit() for t in tokens[:-1]+ ):+ return True+ return False_TITLE_BLOCK_TOKENS = frozenset({'header', 'footer'})diff --git a/skills/ppt-master/workflows/stages/verify-charts.md b/skills/ppt-master/workflows/stages/verify-charts.mdindex 4ec1ca41..88221102 100644--- a/skills/ppt-master/workflows/stages/verify-charts.md+++ b/skills/ppt-master/workflows/stages/verify-charts.md@@ -55,7 +55,7 @@ If the list is empty, output `verify-charts: active profile declares no data-dri5. Run the matching command (see the [calculator documentation](../../scripts/docs/svg-pipeline.md#svg_position_calculatorpy) and recipes for decomposable, partial, formula, and manual modes):```bash- python3 skills/ppt-master/scripts/svg_position_calculator.py calc bar --data "L1:V1,L2:V2" --area "x_min,y_min,x_max,y_max" --bar-width 120 --value-range=0,axis_max+ python3 skills/ppt-master/scripts/svg_position_calculator.py calc bar --data "L1:V1,L2:V2" --area "x_min,y_min,x_max,y_max" --bar-width 120 --value-range=0,axis_max # a Native-ready bar/column passes --gap-width <payload gap_width, default 150> instead of --bar-width so the category axis follows the PowerPoint slot model the parity gate checkspython3 skills/ppt-master/scripts/svg_position_calculator.py calc line --data "x1:y1,x2:y2" --area "x_min,y_min,x_max,y_max" --y-range=0,maxpython3 skills/ppt-master/scripts/svg_position_calculator.py calc pie --data "S1:V1,S2:V2" --center "cx,cy" --radius 200 [--inner-radius 120] --start-angle -90python3 skills/ppt-master/scripts/svg_position_calculator.py calc radar --data "D1:V1,D2:V2,D3:V3" --center "cx,cy" --radius 200 --max-value 100