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
feat(prompts): restore v2.5/v2.13 aesthetic defaults and everyday effects in the executor core
hugohe3c1472709052e
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.mdindex 963fdc64..cf0afa7a 100644--- a/skills/ppt-master/references/executor-base.md+++ b/skills/ppt-master/references/executor-base.md@@ -58,6 +58,40 @@ Read this before §1: the expression vocabulary every page draws from. The contr**Reference — page-level recipes**: [`svg-effects.md`](./svg-effects.md) §6.13 stacks cover, divider, text-led, process, evidence, comparison, closing, and cross-page-motif pages back to front.+**Reference — everyday effects and aesthetic defaults (self-contained; the full contract and rarer techniques are [`svg-effects.md`](./svg-effects.md))**:++- **Color**: 60-30-10 as the starting proportion (dominant field ≈ 60%, support ≈ 30%, accent ≈ 10%), at most four hues per page, body text contrast ≥ 4.5:1; cover and chapter pages may use the theme color as a large field; same-hue gradients add depth; the accent color goes on the key number or word to create focus, not everywhere; cool tones read technical, warm tones energetic, dark fields grave; trends use green up / red down / gray flat with the deck's polarity roles.+- **Rhythm and weight**: follow a data-heavy page with a breathing page; balance visual weight — dark or large elements are heavy, light or small ones light — across left/right and top/bottom; keep layout consistent within a chapter and vary between chapters. A consulting-style content page may add an assertion headline, a one-sentence takeaway band under the title, and a muted source note at the page bottom.+- **Depth through restraint**: depth comes from rhythm (flat vs lifted, dense vs spacious), not shadows everywhere — shadow 2–3 genuinely floating objects per page at most (card over a photo or colored panel, the primary CTA, an overlay) and keep peer-grid cards, dividers, and body containers flat; reach for weight, spacing, accent bars, and tints before shadow; pick one weight tool per container (shadow, border, gradient fill, or strong tint — never stacked); one light source per page (`dx="0"`, `dy="4"`–`"8"`); the shadow is felt, not seen — resting `flood-opacity` 0.06–0.10, raised at most 0.20 (above that is the Office 2007 look); on dark fields use a light hairline or a restrained glow instead of black shadow.+- **Image overlays**: a directional scrim darkest beside the text (`0.88 → 0.30 → 0`), a bottom fade under a lower title (`0 → 0.72`), a radial vignette for atmosphere (`0 → 0.58`), or a brand wash (`0.80 → 0.10`); never a uniform flat opacity over the whole image or a solid black plate.+- **Lines**: `stroke-dasharray` `4,4` separator, `2,2` placeholder outline, `8,4` timeline or flow connector, `8,4,2,4` dimension line; `marker-end` for connector arrowheads; divider hairlines at 0.2–0.3 alpha.+- **Inline emphasis**: lift numerical results, before/after contrasts, and one or two load-bearing nouns per sentence as bold runs in the primary color; never connectives, common verbs, every noun, decorative adjectives, or structural text (footer, axis, legend, page number); reserve green/red for real polarity.++```xml+<defs>+ <filter id="softShadow" x="-15%" y="-20%" width="130%" height="150%">+ <feDropShadow dx="0" dy="6" stdDeviation="8" flood-color="#000000" flood-opacity="0.10"/>+ </filter>+ <filter id="titleGlow" x="-30%" y="-30%" width="160%" height="160%">+ <feGaussianBlur in="SourceAlpha" stdDeviation="6" result="b"/>+ <feFlood flood-color="#1A73E8" flood-opacity="0.45" result="c"/>+ <feComposite in="c" in2="b" operator="in" result="g"/>+ <feMerge><feMergeNode in="g"/><feMergeNode in="SourceGraphic"/></feMerge>+ </filter>+ <linearGradient id="field" x1="0" y1="0" x2="1" y2="0">+ <stop offset="0%" stop-color="#1A73E8"/><stop offset="100%" stop-color="#0D47A1"/>+ </linearGradient>+ <linearGradient id="scrim" x1="0" y1="0" x2="1" y2="0">+ <stop offset="0%" stop-color="#1A1A2E" stop-opacity="0.85"/>+ <stop offset="55%" stop-color="#1A1A2E" stop-opacity="0.30"/>+ <stop offset="100%" stop-color="#1A1A2E" stop-opacity="0"/>+ </linearGradient>+</defs>+<rect x="60" y="60" width="400" height="240" rx="12" fill="#FFFFFF" filter="url(#softShadow)"/> <!-- card floating over a photo/panel -->+<image href="../images/cover.jpg" x="0" y="0" width="1280" height="720" preserveAspectRatio="xMidYMid slice"/>+<rect x="0" y="0" width="1280" height="720" fill="url(#scrim)"/> <!-- text sits on the dark side -->+```+---## 1. Effect Capability Discoverydiff --git a/skills/ppt-master/references/executor-chart.md b/skills/ppt-master/references/executor-chart.mdindex 2c36e423..e39916ef 100644--- a/skills/ppt-master/references/executor-chart.md+++ b/skills/ppt-master/references/executor-chart.md@@ -22,6 +22,8 @@ Construct in this order: (1) resolve data domain, categories, units, baseline, s**Perceptual reading**: choose the least ambiguous presentation of the same data. Preserve source or semantic order when it carries meaning; otherwise sort for the page's comparison task. Prefer direct series labels when legible; keep legends, grid lines, and ticks only when they materially reduce lookup effort. Comparable panels share domain, scale, and category order unless a disclosed difference is the message. Magnitude bars and columns start from zero; interval marks keep their authoritative domain; any non-zero baseline or axis break is explicit and never exaggerates. A dual-axis chart is valid only when both series share the exact time/category domain and units and identities stay unambiguous.+**Reference — chart color and annotation conventions**: a monochromatic depth scheme reads cleaner than rainbow — the primary series in the full theme color, a comparison series in the same hue at about 60% alpha, baselines as a gray dashed line, the accent color only on the key data points; positive / warning / negative trends use the deck's green / yellow / red polarity roles. Place direct data labels at bar ends or beside points instead of a legend where they stay legible; annotate genuine inflection points in words ("policy change", "product launch"); mark an industry average or target as a gray dashed comparison baseline; keep units and precision consistent within one chart; give every data page a muted source note.+**Per-object completeness**: preserve every authoritative series, category, point, label, unit, qualifier, source, and scale cue. For a `<object-key>=yes` chart, the JSON mirrors the drawn fallback item by item in the same edit — legend labels verbatim, point-level exception colors as `point_colors`, the axis scale, `plot_area` from the plot-area marker, visible data labels or summary figures as `data_labels` or companion text, actual label/axis/grid colors (omit `text_color` and siblings rather than guess). When the source cannot determine a required scale or derived value, return the ambiguity upstream in Default or resolve it from explicit source facts in Quick; never fabricate at draw time.**Selected reference**: with a `chart/<key>` primary reference, [`executor-visualization.md`](./executor-visualization.md) owns resolution and adaptation; this branch still owns the value-to-geometry calculation. A chart authored from scratch follows the same contract. An incidental microvisual (small trend or indicator) is drawn accurately but enters §2 and verification only when Default §IX or the Quick active-context decision promotes it to a coordinate-verified object.diff --git a/skills/ppt-master/references/executor-table.md b/skills/ppt-master/references/executor-table.mdindex 9245620e..d5aa4cca 100644--- a/skills/ppt-master/references/executor-table.md+++ b/skills/ppt-master/references/executor-table.md@@ -28,7 +28,7 @@ With a `table/<key>` primary reference, [`executor-visualization.md`](./executor**Per-cell completeness**: never drop a row, column, summary, footnote, unit, or qualifier to imitate a lighter catalog preview; reflow text, widen the column, rebalance neighbors, or increase row height within the page's information contract and [`executor-base.md`](./executor-base.md) typography bounds.-**Spans and chrome**: merge only rectangular regions whose repeated boundaries would obscure an intended shared heading or group, with no competing visible content in covered areas; native merge fields belong exclusively to [`native-data-interface.md`](./native-data-interface.md). Distinguish header/body/summary with the lightest sufficient weight, fill, rule, and whitespace; decorative card treatment must not break row or column continuity.+**Spans and chrome**: merge only rectangular regions whose repeated boundaries would obscure an intended shared heading or group, with no competing visible content in covered areas; native merge fields belong exclusively to [`native-data-interface.md`](./native-data-interface.md). Distinguish header/body/summary with the lightest sufficient weight, fill, rule, and whitespace; decorative card treatment must not break row or column continuity. **Reference — table defaults**: a dark header fill with white bold text (or a bold rule under a plain header), zebra rows at `fill-opacity` 0.05, numbers right-aligned and text left-aligned with consistent units and precision, one highlighted row in the accent at `fill-opacity` 0.1, and horizontal rules only — avoid a full grid of lines.---diff --git a/skills/ppt-master/references/image-layout-spec.md b/skills/ppt-master/references/image-layout-spec.mdindex 999d1958..9f2e8544 100644--- a/skills/ppt-master/references/image-layout-spec.md+++ b/skills/ppt-master/references/image-layout-spec.md@@ -39,6 +39,8 @@ x = x0 - ax × overflow_x; y = y0 - ay × overflow_y### 2.3 Mode selection+**Reference — narrative intent before geometry**: decide whether the image is the page (hero / full-bleed: image fills the canvas or dominant zone, title floats over a gradient or scrim — covers, dividers, breathing pages), a backdrop (atmosphere: low-contrast image behind text), a coequal block (side-by-side: image and text read together — most content pages), or an accent (small image beside related text, no ratio matching); do not default every image page to side-by-side. For side-by-side, start from the source ratio: > 2.0 ultra-wide → top-bottom with the image full width; 1.5–2.0 → top-bottom; 0.8–1.5 → left-right; < 0.8 portrait → left-right with the image on the left; on portrait canvases (Xiaohongshu, Story) prefer top-bottom for most ratios because side columns become too narrow.+Complete source, evidence, or edge content → contain; region coverage with a focal-safe crop → fill; complete source plus a detail view → one contain placement plus a separately justified crop; irregular or repeated source windows → the selected region math first, then the owning crop/shape reference.---diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.mdindex a24bad5c..66fb210c 100644--- a/skills/ppt-master/references/strategist.md+++ b/skills/ppt-master/references/strategist.md@@ -135,7 +135,7 @@ Record the style and rationale in `design_spec.md`, then project `- visual_style**Hard rule**: user-specified colors are truth — lock supplied HEX, brand colors, or natural-language directives (templates follow inherited-design precedence). Every direction fills all six roles (`background`, `secondary_bg`, `primary`, `accent`, `secondary_accent`, `body_text`), repeating fixed roles and varying only open ones; never an empty palette. In §III derive the standard `secondary_text` and `divider` neutrals and project them to `spec_lock.md colors`; §V fixes the five deck-wide spacing anchors.-**Reference — not a constraint**: WCAG AA body contrast is 4.5:1. Without user/template colors, propose project-specific directions from content and style; `scripts/config.py` industry colors and the dominant/support/accent hierarchy are recall aids, never default locks, ratios, or quotas.+**Reference — not a constraint**: starting proportions follow the 60-30-10 rule (dominant ≈ 60%, support ≈ 30%, accent ≈ 10%), body contrast is at least 4.5:1 (WCAG AA), and a page carries at most four hues; color carries mood — cool tones read technical and calm, warm tones energetic and approachable, dark fields grave and premium. Without user/template colors, propose project-specific directions from content and style; `scripts/config.py` industry anchors (finance/business navy `#003366`, technology bright blue `#1565C0`, healthcare teal `#00796B`, government red `#C41E3A`) and the dominant/support/accent hierarchy are recall aids, never default locks or quotas.**Lock recurring semantic anchors, not every paint**: add neutral roles the style and page plan give a stable meaning — `surface`, `grid`, `scrim`, `overlay`, `block-shade` — and leave page-local tints, gradient stops, shadow/glow colors, and one-off tones to execution, promoting one only when it becomes a reusable named role.@@ -170,7 +170,9 @@ AI illustrated icons are not a base option, add-on, field, or key — like decor🚧 **GATE**: apply the chosen custom behavior and only the already-loaded `visual_style_references` files. The title carries the character; the body may stay neutral.-**Family selection**: user/template typography is authoritative — repeat fixed stacks with `typography.fixed: true` in every direction (reasonable repetition is non-blocking; no extra font round). Each direction carries `heading` / `body` `primary`, `css`, and a positive `body_size`, plus `english` only for a non-English deck. Resolve the delivery target under [`shared-standards-core.md`](./shared-standards-core.md) §4.1 and name concrete target-installed/approved PowerPoint faces (the Confirm UI catalog is manual choice, not a whitelist); at most four families; a brand/web face leads only after user-confirmed installation, otherwise export a safe face and keep it as a Design Spec reference (fonts are not embedded; CSS tails are preview aids, not PowerPoint fallbacks). Avoid near-equivalent splits (YaHei↔PingFang, SimSun↔Songti, Arial↔Helvetica↔Segoe UI, Times↔Times New Roman). Vary the axis by the locked style — serif×sans, Kai/FangSong×hei, hei×song, double-serif, display×neutral, same-family weight, sans+mono — as recall seeds, not presets.+**Family selection**: user/template typography is authoritative — repeat fixed stacks with `typography.fixed: true` in every direction (reasonable repetition is non-blocking; no extra font round). Each direction carries `heading` / `body` `primary`, `css`, and a positive `body_size`, plus `english` only for a non-English deck. Resolve the delivery target under [`shared-standards-core.md`](./shared-standards-core.md) §4.1 and name concrete target-installed/approved PowerPoint faces (the Confirm UI catalog is manual choice, not a whitelist); at most four families; a brand/web face leads only after user-confirmed installation, otherwise export a safe face and keep it as a Design Spec reference (fonts are not embedded; CSS tails are preview aids, not PowerPoint fallbacks). Avoid near-equivalent splits (YaHei↔PingFang, SimSun↔Songti, Arial↔Helvetica↔Segoe UI, Times↔Times New Roman). Fonts in one deck form contrast (different family, weight, or proportion) or concord (one family throughout); propose one of each unless the user or template fixes the stack, and never default to title = body without a reason.++**Reference — PPT-safe faces and pairings (recall seeds, not presets)**: pre-installed leads — CJK sans `Microsoft YaHei` / `SimHei` (macOS `PingFang SC` / `Heiti SC`), CJK serif `SimSun` / `FangSong` / `KaiTi` (`Songti SC`), Latin sans `Arial` / `Calibri` / `Segoe UI` / `Verdana` / `Trebuchet MS`, Latin serif `Times New Roman` / `Georgia` / `Cambria` / `Palatino` / `Garamond`, mono `Consolas` / `Courier New`, display `Impact` / `Arial Black`; keep at most one macOS-only family per stack. The title carries the style's character — `ink-wash` → `KaiTi` / `FangSong`; `brutalist` / `memphis` / `vintage-poster` / `zine` → `SimHei` / `Impact`; `editorial` / `data-journalism` / `photo-editorial` → `Georgia` / `Cambria` / `SimSun`; `dark-tech` / `blueprint` → clean sans + `Consolas`; `swiss-minimal` / `soft-rounded` → grotesque or friendly sans; a neutral sans title where the style asks for character is the failure to avoid, and `Microsoft YaHei` / `Arial` are neutral tails, not the automatic lead. Axes: serif × sans (`Georgia, KaiTi` × `Microsoft YaHei`), Kai × hei, FangSong × hei (`FangSong` × `SimHei`), double serif (`Palatino, FangSong` × `Cambria, SimSun`), same family with 900 / 300 weight, display × neutral (`Impact, SimHei` × `Arial, Microsoft YaHei`), cool academic serif (`Cambria, SimSun` × `Times New Roman, SimSun`), hei × song for 政务, sans body + `Consolas` code. Non-pre-installed directions — retro/pixel Press Start 2P / VT323, rounded Nunito / Quicksand / OPPO Sans (safe substitute `Trebuchet MS` / `Verdana`), modern web Inter / HarmonyOS Sans / Source Han, calligraphic 隶书 / 华文行楷 / 华文新魏 (safe substitute `KaiTi` / `FangSong`, titles only), brand faces — need target installation or stay Design Spec references.**Role extension after confirmation**: while authoring §IX and §IV, add a lowercase snake_case role with an exact stack only for a recurring role that materially needs a different family (`annotation`, `footer`, `footnote`, `data`, `emphasis`, `quote`, `code`), coherent with the confirmed heading/body system and locked style; one-off garnish stays omitted, confirmation is not reopened, and one compact `Role rationale` line in §IV names any added role.@@ -264,7 +266,9 @@ Mode: [`modes/_index.md`](./modes/_index.md) → `pyramid` / `narrative` / `inst## 3. Color Selection Reference-No universal palette: user / brand → active template → project-specific proposal, with `scripts/config.py` industry anchors as optional recall. Count and distribution follow encoding, style, and natural assets. Lock the stable role set the deck needs, including recurring neutrals (`surface`, `grid`, `scrim`, `overlay`, `block-shade`), as identity anchors rather than an exhaustive paint list; Executor derives tints, shades, alpha, gradients, and effects and adds sparse page-local accents that never form a competing palette, while Strategist owns reusable positive / warning / negative roles.+No universal palette: user / brand → active template → project-specific proposal, with `scripts/config.py` industry anchors as optional recall. Count and distribution follow encoding, style, and natural assets, with 60-30-10 as the starting proportion.++**Reference — color knowledge base (recall aids, never defaults)**: consulting brands — Deloitte `#0076A8`, McKinsey `#005587`, BCG `#003F6C`, PwC `#D04A02`, EY `#FFE600`; versatile anchors — tech blue `#2196F3`, vibrant orange `#FF9800`, growth green `#4CAF50`, professional purple `#9C27B0`, alert red `#F44336`; data-visualization polarity ramps — positive green `#2E7D32 → #4CAF50 → #81C784`, warning yellow `#F57C00 → #FFA726 → #FFD54F`, negative red `#C62828 → #EF5350 → #E57373`. Lock the stable role set the deck needs, including recurring neutrals (`surface`, `grid`, `scrim`, `overlay`, `block-shade`), as identity anchors rather than an exhaustive paint list; Executor derives tints, shades, alpha, gradients, and effects and adds sparse page-local accents that never form a competing palette, while Strategist owns reusable positive / warning / negative roles.---@@ -272,14 +276,16 @@ No universal palette: user / brand → active template → project-specific prop**Reference — not a constraint**: macro vocabulary only; proportion follows information weight, and Executor may adopt, adapt, or decline after reading the page. Repeating symmetric card grids without a page job is a failure mode.-| Content relationship | Useful starting structure |-|---|---|-| One focal claim | centered single column, negative space, or full-bleed + floating text |-| Equal comparison | symmetric split or a true matrix |-| Dominant evidence + takeaway | asymmetric split with one dominant field |-| Parallel sequence | three-column, process line, or Z-pattern |-| Core + surrounding forces | center-radiating or hub-spoke |-| Wide visual + explanation | top-bottom split |+| Content relationship | Useful starting structure | PPT 16:9 reference dimensions |+|---|---|---|+| One focal claim | centered single column, negative space (one element in 40–60% whitespace), or full-bleed + floating text | content width 800–1000 px centered; full-bleed image 1280×720 with an opacity overlay under the text |+| Equal comparison | symmetric split (5:5) or a true matrix / four quadrants | column ratio 1:1 with a 40–60 px gap; quadrant about 560×250 px with 20–30 px gaps |+| Dominant evidence + takeaway | asymmetric split (3:7 / 2:8) with one dominant field | heavier side 840–1024 px, lighter side 256–440 px |+| Parallel sequence | three-column, process line, Z-pattern / waterfall | 1:1:1 columns with 30–40 px gaps; 3–5 alternating blocks guiding the eye in a Z |+| Core + surrounding forces | center-radiating or hub-spoke | center element 200–300 px with 4–6 satellite nodes |+| Wide visual + explanation | top-bottom split, or figure-text overlap for a hero moment | image full width, text area ≥ 150 px high; overlap places the headline against the image edge, not beside it |++PPT 16:9 (1280×720) key dimensions: safe area 1200×640 (40 px margins); title area 1200×100; content area 1200×500; footer area 1200×40. Reference values only — proportion follows information weight.Once the roster and planned resources are known, recommend a cross-page motif or element family when it can carry identity or meaning — title/corner ornaments, a directional contour, an opening, a line lattice, an oversized numeral — recording its continuity job and reuse mode in §III `Theme` and mentioning it only in the §IX `Layout` blocks that benefit; Executor owns its geometry and may decline it; no motif field, lock row, or quota.diff --git a/skills/ppt-master/references/svg-effects.md b/skills/ppt-master/references/svg-effects.mdindex 653045bb..a299aa49 100644--- a/skills/ppt-master/references/svg-effects.md+++ b/skills/ppt-master/references/svg-effects.md@@ -220,7 +220,11 @@ paper-layer treatment flips every affected layer together, so one plane keepsone light direction.**Reference — not a constraint**: use no more elevation categories than the-hierarchy needs; a page may reuse one category across several related objects.+hierarchy needs; a page may reuse one category across several related objects,+but two or three shadowed objects usually read cleanest — check that a fourth+earns its weight. Pick one weight tool per container — shadow, border,+gradient fill, or strong tint — never stacked; peer-grid cards, dividers,+body containers, and background panels stay on the floor.Same-family colored shadow is reserved for a focal accent. On dark backgroundsa light hairline or restrained glow separates surfaces; glow on body copyreduces legibility. For older/strict renderers, replace a filter with two ordiff --git a/skills/ppt-master/scripts/prompt_audit_manifest.json b/skills/ppt-master/scripts/prompt_audit_manifest.jsonindex c857dbe5..a57e1139 100644--- a/skills/ppt-master/scripts/prompt_audit_manifest.json+++ b/skills/ppt-master/scripts/prompt_audit_manifest.json@@ -18,7 +18,7 @@"file_budgets": {"AGENTS.md": 3250,"skills/ppt-master/SKILL.md": 1750,- "skills/ppt-master/references/executor-base.md": 8000,+ "skills/ppt-master/references/executor-base.md": 9000,"skills/ppt-master/references/executor-structured.md": 5500,"skills/ppt-master/references/executor-chart.md": 1750,"skills/ppt-master/references/executor-visualization.md": 1000,@@ -34,7 +34,7 @@"skills/ppt-master/references/native-data-interface.md": 5000,"skills/ppt-master/references/pptx-structure-interface.md": 3000,"skills/ppt-master/references/preset-shape-vocabulary.md": 2750,- "skills/ppt-master/references/strategist.md": 12000,+ "skills/ppt-master/references/strategist.md": 14000,"skills/ppt-master/references/strategist-image.md": 3250,"skills/ppt-master/references/strategist-template.md": 2500,"skills/ppt-master/templates/design_spec_reference.md": 3500,@@ -73,7 +73,7 @@"skills/ppt-master/workflows/create-template/create-deck.md": 1500,"skills/ppt-master/workflows/stages/customize-animations.md": 4250,"skills/ppt-master/references/svg-image-embedding.md": 1750,- "skills/ppt-master/references/image-layout-spec.md": 2250,+ "skills/ppt-master/references/image-layout-spec.md": 2500,"skills/ppt-master/templates/README.md": 1750,"skills/ppt-master/templates/brands/README.md": 750,"skills/ppt-master/templates/styles/README.md": 1250,