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: add centralized chart reference workflow and simplify executor guidance
hugohe38bd74a22b314
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.mdindex 06b4f84e..6a3a58a7 100644--- a/skills/ppt-master/references/executor-base.md+++ b/skills/ppt-master/references/executor-base.md@@ -78,7 +78,15 @@ Full index: `templates/icons/README.md`----## 5. Image Handling+## 5. Chart Reference++When the Design Spec includes a **VII. Chart Reference List**, read the referenced SVG templates from `templates/charts/` to understand common chart patterns. How to apply or adapt them is at your discretion.++> Chart templates: `templates/charts/` (33 types). Index: `templates/charts/charts_index.json`++---++## 6. Image HandlingHandle images based on their status in the Design Specification's "Image Resource List":@@ -94,7 +102,7 @@ Handle images based on their status in the Design Specification's "Image Resourc----## 6. Font Usage+## 7. Font UsageApply corresponding fonts for different text roles based on the font plan in the Design Specification & Content Outline:@@ -109,7 +117,7 @@ See `references/design-guidelines.md` for details.----## 7. Speaker Notes Generation Framework+## 8. Speaker Notes Generation Framework### Task 1. Generate Complete Speaker Notes Document@@ -145,7 +153,7 @@ Automatically split `notes/total.md` into individual speaker note files in the `----## 8. Next Steps After Completion+## 9. Next Steps After Completion> **Auto-continuation**: After Visual Construction Phase (all SVG pages) and Logic Construction Phase (all notes) are complete, the Executor proceeds directly to the post-processing pipeline.diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.mdindex 0b9adc0a..88ff3a6e 100644--- a/skills/ppt-master/references/strategist.md+++ b/skills/ppt-master/references/strategist.md@@ -88,7 +88,27 @@ Built-in library contains 640+ icons; see `templates/icons/README.md`.>> **Quick lookup**: By category → `icons_index.json` `categories`; by semantics → `quickLookup`; full list → `templates/icons/FULL_INDEX.md`-### g. Image Usage Confirmation+### g. Chart Reference Selection++When content outline pages involve **data visualization** (comparisons, trends, proportions, KPIs, flows, strategic frameworks, etc.), consult the chart template library to select appropriate chart types.++Built-in library contains 33 chart templates; see `templates/charts/charts_index.json`.++> **Selection workflow**:+> 1. Identify pages that need data visualization during content planning+> 2. Consult `charts_index.json` — by analysis goal → `quickLookup`; by category → `categories`+> 3. Review `bestFor` / `avoidFor` to confirm the chart type fits the data characteristics+> 4. List all selected charts in Design Spec **section VII (Chart Reference List)** as a centralized reference; in section IX Content Outline, each page only needs to note the chart type name+>+> **Quick lookup by goal**:+> - Ranking/comparison → `bar_chart`, `horizontal_bar_chart`, `grouped_bar_chart`+> - Trends over time → `line_chart`, `area_chart`, `dual_axis_line_chart`+> - Proportions → `donut_chart`, `pie_chart`, `treemap_chart`+> - KPIs/targets → `kpi_cards`, `bullet_chart`, `gauge_chart`+> - Conversion/flow → `funnel_chart`, `sankey_chart`, `waterfall_chart`+> - Strategy → `swot_analysis`, `porter_five_forces`, `matrix_2x2`++### h. Image Usage Confirmation| Option | Approach | Suitable Scenarios ||--------|----------|-------------------|@@ -295,12 +315,13 @@ The Strategist should make professional judgments on the template basis generate| IV. Typography System | Font plan (P1-P5), font size hierarchy (H1-Code, 7 levels) || V. Layout Principles | Page structure (header/content/footer zones), 6 layout modes, spacing spec || VI. Icon Usage Spec | Source description, placeholder syntax, recommended icon list |-| VII. Image Resource List | Filename, dimensions, ratio, purpose, status, generation description |-| VIII. Content Outline | Grouped by chapter; each page includes layout, title, content points |-| IX. Speaker Notes Requirements | File naming rules, content structure description |-| X. Technical Constraints Reminder | SVG generation rules, PPT compatibility rules |-| XI. Design Checklist | Pre-generation / post-generation check items |-| XII. Next Steps | Clarify subsequent pipeline (Image_Generator or Executor) |+| VII. Chart Reference List | Chart type, reference template path, used-in pages, purpose |+| VIII. Image Resource List | Filename, dimensions, ratio, purpose, status, generation description |+| IX. Content Outline | Grouped by chapter; each page includes layout, title, content points, chart type (if applicable) |+| X. Speaker Notes Requirements | File naming rules, content structure description |+| XI. Technical Constraints Reminder | SVG generation rules, PPT compatibility rules |+| XII. Design Checklist | Pre-generation / post-generation check items |+| XIII. Next Steps | Clarify subsequent pipeline (Image_Generator or Executor) |**Generation steps**:1. Read reference template: `templates/design_spec_reference.md`diff --git a/skills/ppt-master/templates/design_spec_reference.md b/skills/ppt-master/templates/design_spec_reference.mdindex ae21b4df..3eb10c68 100644--- a/skills/ppt-master/templates/design_spec_reference.md+++ b/skills/ppt-master/templates/design_spec_reference.md@@ -162,7 +162,17 @@----## VII. Image Resource List (if needed)+## VII. Chart Reference List (if needed)++> When the presentation includes data visualization, Strategist selects chart types from `templates/charts/charts_index.json` and lists them here for the Executor to reference.++| Chart Type | Reference Template | Used In |+| ---------- | ------------------ | ------- |+| [e.g. grouped_bar_chart] | `templates/charts/grouped_bar_chart.svg` | Slide 05 |++---++## VIII. Image Resource List (if needed)| Filename | Dimensions | Ratio | Purpose | Type | Status | Generation Description || -------- | --------- | ----- | ------- | ---- | ------ | --------------------- |@@ -184,7 +194,7 @@----## VIII. Content Outline+## IX. Content Outline### Part 1: [Chapter Name]@@ -199,18 +209,21 @@- **Layout**: [Choose layout mode]- **Title**: [Page title]+- **Chart**: [chart_type] (see VII. Chart Reference List)- **Content**:- [Point 1]- [Point 2]- [Point 3]+> **Chart field**: Only add when the page includes data visualization. Chart type must be listed in section VII.+---[Strategist continues adding more pages based on source document content and page count planning...]----## IX. Speaker Notes Requirements+## X. Speaker Notes RequirementsGenerate corresponding speaker note files for each page, saved to the `notes/` directory:@@ -219,7 +232,7 @@ Generate corresponding speaker note files for each page, saved to the `notes/` d----## X. Technical Constraints Reminder+## XI. Technical Constraints Reminder### SVG Generation Must Follow:@@ -239,7 +252,7 @@ Generate corresponding speaker note files for each page, saved to the `notes/` d----## XI. Design Checklist+## XII. Design Checklist### Pre-generation@@ -260,7 +273,7 @@ Generate corresponding speaker note files for each page, saved to the `notes/` d----## XII. Next Steps+## XIII. Next Steps1. ✅ Design spec complete2. **Next step**: [Choose based on image approach]