Skip to content

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.md
index 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 Handling
Handle 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 Usage
Apply 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.md
index 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.md
index 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 Requirements
Generate 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 Steps
1. ✅ Design spec complete
2. **Next step**: [Choose based on image approach]