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

refactor(ppt): slim charts_index.json to summary-only and update Strategist workflow

hugohe37857e1d5596f
diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.md
index 15c55aad..aba283a8 100644
--- a/skills/ppt-master/references/strategist.md
+++ b/skills/ppt-master/references/strategist.md
@@ -335,18 +335,20 @@ Side-by-side only: container ratio must match image ratio. Hero / atmosphere / a
When content outline pages involve **data visualization or infographic-style structured information design** (comparisons, trends, proportions, KPIs, flows, timelines, org structures, strategic frameworks, etc.), Strategist should select appropriate visualization types from the built-in template library.
> **Reading is mandatory; the catalog is a starting point, not a copy target.**
-> - Fully read `templates/charts/charts_index.json` **before drafting the Eight Confirmations** — the read happens up front, not when you sit down to write Section VII. Each `summary` is a selection rule (`"Pick for … Skip if …"`), not a description.
+> - Fully read `templates/charts/charts_index.json` **before drafting the Eight Confirmations** — the read happens up front, not when you sit down to write Section VII. The file contains `meta` + `charts.<key>.summary` only; each `summary` is a selection rule (`"Pick for … Skip if …"`), not a description. There is **no category, quickLookup, or keyword index** — selection is done by semantically matching each page's content shape against all 72 summaries in one pass.
> - Not every page needs a chart. When a page's information structure matches a catalog entry, **use that template as a structural starting point** — keep the visualization type and core layout logic, then adapt composition, density, color, decoration, and accompanying elements to fit this deck's content and visual tone. Free adjustment is encouraged; what is forbidden is (a) generating without reading the catalog, and (b) blind verbatim mimicry that ignores the page's actual content weight.
>
> **Workflow**:
-> 1. Match each page against `summary` / `keywords` across all entries; use `quickLookup` for cross-check.
+> 1. Read all 72 summaries; for each page, identify the Pick clause that matches the page's content shape AND does not match any Skip clause.
> 2. Prefer specificity (`vertical_list` over generic `numbered_steps`).
> 3. One primary visualization per page; a supporting layout may accompany it.
> 4. List selections in Design Spec section VII; section IX only notes the visualization type name per page.
>
+> **Source vocabulary mismatch** — the catalog is in English. When source content uses Chinese / industry jargon ("中台", "架构图", "述职", "管道", "前后端"), translate the intent first, then match against summaries. The catalog deliberately keeps no keyword index — full-read forces semantic matching rather than lexical grep.
+>
> **Read-audit (mandatory, written at the top of section VII)** — designed to make fabrication impossible:
> ```
-> Catalog read: <N> templates / <M> categories
+> Catalog read: 72 templates
>
> Per-page selection (one row per viz page):
> P03 bar_chart | summary-quote: "<paste the first sentence of the entry's `summary` field, verbatim>"
@@ -361,7 +363,7 @@ When content outline pages involve **data visualization or infographic-style str
> The `summary-quote` must be copy-pasted from `charts_index.json` — paraphrasing or summarizing breaks the audit. Every `<key_*>` and selected key must `grep` cleanly inside `charts_index.json` (so misspelled or invented keys fail). If fewer than 3 visualization pages exist, list what exists and note "fewer than 3 viz pages"; runners-up still required for each page that does exist.
>
> **Fallback when no template fits**:
-> 1. Re-scan `categories` and `quickLookup` — concepts often live under non-obvious labels (e.g. "causal chain" → `process_flow` / `sankey_chart` under `process`).
+> 1. Re-read the full summary list with the page's intent re-stated in plain language — "non-obvious" matches often surface on the second pass (e.g. "causal chain" → `process_flow` or `sankey_chart`).
> 2. If still no fit: data-driven content → table layout; conceptual/illustrative → "AI-generated image" (Image_Generator handles); structural → "custom layout".
> 3. Mark the page `no-template-match` in section VII with the fallback chosen and why. Do NOT silently substitute a close-but-wrong chart.
diff --git a/skills/ppt-master/templates/charts/README.md b/skills/ppt-master/templates/charts/README.md
index fb417286..1a88d25b 100644
--- a/skills/ppt-master/templates/charts/README.md
+++ b/skills/ppt-master/templates/charts/README.md
@@ -4,9 +4,9 @@ This directory contains the standardized SVG visualization templates used by PPT
## Source of truth
-[`charts_index.json`](./charts_index.json) is the single source of truth for the library: total count, categories, per-template purpose / use cases / size hints, and quick-lookup keywords. Both human readers and AI roles should consume it directly.
+[`charts_index.json`](./charts_index.json) is the single source of truth for the library: total count + one selection-rule `summary` per template (format: `"Pick for X. Skip if Y (use other_key)."`). Both human readers and AI roles read it in full — there is no category/keyword sub-index. Selection is done by semantic match against the summary list in one pass.
-To browse the library, open `charts_index.json` — its `categories` block groups every template, and `quickLookup` maps common intents (ranking, comparison, trend, composition, etc.) to recommended templates.
+To browse the library, open `charts_index.json` and scan the `charts` block top-to-bottom; each entry's `summary` answers "when do I pick this, when do I skip" directly.
## Style rules
diff --git a/skills/ppt-master/templates/charts/charts_index.json b/skills/ppt-master/templates/charts/charts_index.json
index 6181dff9..c7406ac0 100644
--- a/skills/ppt-master/templates/charts/charts_index.json
+++ b/skills/ppt-master/templates/charts/charts_index.json
@@ -1,428 +1,229 @@
{
"meta": {
- "total": 70,
+ "total": 72,
"defaultViewBox": "0 0 1280 720",
"formats": ["ppt169"],
"filePattern": "{key}.svg",
"libraryPositioning": "Visualization template library covering charts, infographics, diagrams, and strategic frameworks. The `charts/` path is retained for backward compatibility.",
- "summaryGrammar": "Each chart's `summary` is a selection rule, not a description. Format: 'Pick for <content shape + scale>. Skip if <reason → alternative>'. Read it as a decision aid: if the source content matches the Pick clause and does not match a Skip clause, the template fits.",
+ "summaryGrammar": "Each chart's `summary` is a selection rule, not a description. Format: 'Pick for <content shape + scale>. Skip if <reason → alternative>'. Strategist matches every page's content shape against all 72 summaries; no category/keyword index — full-read is intentional.",
"updated": "2026-04-25"
},
- "categories": {
- "comparison": {
- "label": "Comparison",
- "charts": ["bar_chart", "horizontal_bar_chart", "grouped_bar_chart", "stacked_bar_chart", "butterfly_chart", "bullet_chart", "dumbbell_chart", "waterfall_chart"]
- },
- "trend": {
- "label": "Trend",
- "charts": ["line_chart", "area_chart", "stacked_area_chart", "dual_axis_line_chart"]
- },
- "composition": {
- "label": "Composition",
- "charts": ["pie_chart", "donut_chart", "treemap_chart"]
- },
- "metrics": {
- "label": "Metrics",
- "charts": ["kpi_cards", "gauge_chart", "progress_bar_chart"]
- },
- "analysis": {
- "label": "Analysis",
- "charts": ["radar_chart", "scatter_chart", "funnel_chart", "matrix_2x2", "bubble_chart", "heatmap_chart", "pareto_chart", "box_plot_chart"]
- },
- "process": {
- "label": "Project Management / Relationships",
- "charts": ["gantt_chart", "timeline", "process_flow", "org_chart", "sankey_chart", "okr_tree"]
- },
- "strategy": {
- "label": "Strategic Frameworks",
- "charts": ["swot_analysis", "porter_five_forces", "pest_analysis", "value_chain", "bcg_matrix", "ansoff_matrix"]
- },
- "architecture": {
- "label": "System Architecture",
- "charts": ["layered_architecture", "module_composition", "pipeline_with_stages", "client_server_flow"]
- },
- "infographic": {
- "label": "Infographics",
- "charts": ["pyramid_chart", "venn_diagram", "pros_cons_chart", "cycle_diagram", "numbered_steps", "icon_grid", "isometric_stairs", "mind_map", "snake_flow", "roadmap_vertical", "word_cloud", "concentric_circles", "chevron_process", "fishbone_diagram", "hub_spoke", "vertical_list", "team_roster", "journey_map", "agenda_list", "flywheel_diagram"]
- },
- "table": {
- "label": "Tables",
- "charts": ["basic_table", "consulting_table", "project_schedule_table", "financial_statement_table", "feature_matrix_table", "comparison_table", "comparison_columns", "harvey_balls_table"]
- }
- },
- "quickLookup": {
- "ranking": ["horizontal_bar_chart", "bar_chart", "pareto_chart"],
- "comparison": ["bar_chart", "grouped_bar_chart", "butterfly_chart", "dumbbell_chart"],
- "trend": ["line_chart", "area_chart", "stacked_area_chart", "dual_axis_line_chart"],
- "composition": ["donut_chart", "pie_chart", "treemap_chart"],
- "kpi": ["kpi_cards", "bullet_chart", "gauge_chart", "progress_bar_chart"],
- "conversion": ["funnel_chart", "sankey_chart", "waterfall_chart"],
- "distribution": ["box_plot_chart", "heatmap_chart", "scatter_chart", "bubble_chart"],
- "correlation": ["scatter_chart", "bubble_chart", "radar_chart"],
- "roadmap": ["gantt_chart", "timeline", "process_flow"],
- "relationship": ["org_chart", "sankey_chart", "matrix_2x2"],
- "flow": ["process_flow", "sankey_chart", "waterfall_chart"],
- "strategy": ["swot_analysis", "porter_five_forces", "pest_analysis", "value_chain", "bcg_matrix", "ansoff_matrix", "matrix_2x2"],
- "hierarchy": ["pyramid_chart", "isometric_stairs", "org_chart", "concentric_circles", "okr_tree"],
- "infographic": ["icon_grid", "numbered_steps", "cycle_diagram", "venn_diagram", "pros_cons_chart", "mind_map", "hub_spoke", "word_cloud", "vertical_list", "team_roster", "agenda_list", "journey_map", "flywheel_diagram"],
- "pros_cons": ["pros_cons_chart", "butterfly_chart", "swot_analysis", "comparison_table", "comparison_columns"],
- "cause_effect": ["fishbone_diagram", "process_flow"],
- "journey": ["snake_flow", "timeline", "roadmap_vertical", "chevron_process", "journey_map"],
- "table": ["basic_table", "consulting_table", "project_schedule_table", "financial_statement_table", "feature_matrix_table", "comparison_table", "comparison_columns", "harvey_balls_table"],
- "pricing": ["comparison_columns", "comparison_table"],
- "brainstorm": ["mind_map", "word_cloud", "hub_spoke"],
- "architecture": ["layered_architecture", "module_composition", "pipeline_with_stages", "client_server_flow"]
- },
"charts": {
"area_chart": {
- "label": "Area Chart",
- "summary": "Pick for 1-2 cumulative trend series emphasizing volume over time. Skip for >=3 series (use stacked_area_chart) or pure direction without volume (use line_chart).",
- "keywords": ["trend", "cumulative", "area chart", "time series"]
+ "summary": "Pick for 1-2 cumulative trend series emphasizing volume over time. Skip for >=3 series (use stacked_area_chart) or pure direction without volume (use line_chart)."
},
"bar_chart": {
- "label": "Bar Chart",
- "summary": "Pick for single-series category value comparison, 3-8 categories. Skip for >12 long-label items (use horizontal_bar_chart) or multi-series (use grouped_bar_chart).",
- "keywords": ["comparison", "ranking", "category", "bar chart"]
+ "summary": "Pick for single-series category value comparison, 3-8 categories. Skip for >12 long-label items (use horizontal_bar_chart) or multi-series (use grouped_bar_chart)."
},
"box_plot_chart": {
- "label": "Box Plot",
- "summary": "Pick for distribution shape per group (median, quartiles, outliers). Skip if only the average per group matters (use bar_chart).",
- "keywords": ["distribution", "statistics", "outlier", "box plot"]
+ "summary": "Pick for distribution shape per group (median, quartiles, outliers). Skip if only the average per group matters (use bar_chart)."
},
"bubble_chart": {
- "label": "Bubble Chart",
- "summary": "Pick for 3-axis data (x position, y position, size). Skip for plain x-y correlation (use scatter_chart).",
- "keywords": ["correlation", "three-dimensional", "bubble chart", "competitive"]
+ "summary": "Pick for 3-axis data (x position, y position, size). Skip for plain x-y correlation (use scatter_chart)."
},
"bullet_chart": {
- "label": "Bullet Chart",
- "summary": "Pick for 3-7 KPIs each with explicit target + actual. Skip for single metric (use gauge_chart) or items with only completion % and no target baseline (use progress_bar_chart).",
- "keywords": ["target", "actual", "performance", "bullet chart"]
+ "summary": "Pick for 3-7 KPIs each with explicit target + actual. Skip for single metric (use gauge_chart) or items with only completion % and no target baseline (use progress_bar_chart)."
},
"butterfly_chart": {
- "label": "Butterfly Chart",
- "summary": "Pick for two mirrored datasets sharing a common axis (age pyramid, A/B, income vs expense). Skip for >2 sides (use grouped_bar_chart).",
- "keywords": ["bidirectional comparison", "butterfly chart", "mirror", "demographics"]
+ "summary": "Pick for two mirrored datasets sharing a common axis (age pyramid, A/B, income vs expense). Skip for >2 sides (use grouped_bar_chart)."
},
"donut_chart": {
- "label": "Donut Chart",
- "summary": "Pick for 3-6 part proportions where a center KPI/total deserves emphasis. Skip if no center value to feature (use pie_chart).",
- "keywords": ["proportion", "composition", "donut chart", "share"]
+ "summary": "Pick for 3-6 part proportions where a center KPI/total deserves emphasis. Skip if no center value to feature (use pie_chart)."
},
"dual_axis_line_chart": {
- "label": "Dual-Axis Line Chart",
- "summary": "Pick when 2 metrics with different units/scales must be compared over time. Skip if both metrics share the same unit (use line_chart).",
- "keywords": ["dual axis", "line chart", "trend", "unit of measure"]
+ "summary": "Pick when 2 metrics with different units/scales must be compared over time. Skip if both metrics share the same unit (use line_chart)."
},
"dumbbell_chart": {
- "label": "Dumbbell Chart",
- "summary": "Pick for before-vs-after or two-state difference across 5-10 items. Skip for single snapshot (use bar_chart) or 3+ states (use grouped_bar_chart).",
- "keywords": ["difference", "before-after comparison", "dumbbell chart", "evaluation"]
+ "summary": "Pick for before-vs-after or two-state difference across 5-10 items. Skip for single snapshot (use bar_chart) or 3+ states (use grouped_bar_chart)."
},
"funnel_chart": {
- "label": "Funnel Chart",
- "summary": "Pick for 3-5 sequential conversion stages with monotonic drop-off. Skip if flow branches/merges (use sankey_chart) or steps don't entail loss (use process_flow).",
- "keywords": ["conversion", "funnel", "drop-off", "stage"]
+ "summary": "Pick for 3-5 sequential conversion stages with monotonic drop-off. Skip if flow branches/merges (use sankey_chart) or steps don't entail loss (use process_flow)."
},
"gantt_chart": {
- "label": "Gantt Chart",
- "summary": "Pick for project schedule with 6-12 tasks, durations, and dependencies. Skip for simple milestones without duration (use timeline) or vertical roadmap (use roadmap_vertical).",
- "keywords": ["scheduling", "Gantt chart", "project", "roadmap"]
+ "summary": "Pick for project schedule with 6-12 tasks, durations, and dependencies. Skip for simple milestones without duration (use timeline) or vertical roadmap (use roadmap_vertical)."
},
"gauge_chart": {
- "label": "Gauge Chart",
- "summary": "Pick for one hero metric's goal achievement rate. Skip for multiple metrics (use bullet_chart for target+actual or progress_bar_chart for completion %).",
- "keywords": ["achievement", "gauge", "KPI", "progress"]
+ "summary": "Pick for one hero metric's goal achievement rate. Skip for multiple metrics (use bullet_chart for target+actual or progress_bar_chart for completion %)."
},
"grouped_bar_chart": {
- "label": "Grouped Bar Chart",
- "summary": "Pick for 2-4 series side-by-side across the same categories (e.g. YoY/QoQ). Skip if showing composition within each category (use stacked_bar_chart).",
- "keywords": ["grouped", "multi-series", "bar chart", "year-over-year"]
+ "summary": "Pick for 2-4 series side-by-side across the same categories (e.g. YoY/QoQ). Skip if showing composition within each category (use stacked_bar_chart)."
},
"heatmap_chart": {
- "label": "Heatmap",
- "summary": "Pick for 2D matrix where each cell is an intensity value (activity grid, correlation matrix). Skip for ranked categories (use bar_chart).",
- "keywords": ["heatmap", "matrix", "correlation", "intensity"]
+ "summary": "Pick for 2D matrix where each cell is an intensity value (activity grid, correlation matrix). Skip for ranked categories (use bar_chart)."
},
"horizontal_bar_chart": {
- "label": "Horizontal Bar Chart",
- "summary": "Pick for ranking 5-12 items, especially with long labels. Skip if <=8 short-label items (use bar_chart).",
- "keywords": ["ranking", "horizontal bar chart", "long label", "comparison"]
+ "summary": "Pick for ranking 5-12 items, especially with long labels. Skip if <=8 short-label items (use bar_chart)."
},
"kpi_cards": {
- "label": "KPI Cards",
- "summary": "Pick for 4-8 standalone numeric metrics shown as overview cards (2x2 or 1x4). Skip if metrics have target baselines (use bullet_chart) or single hero number (use gauge_chart).",
- "keywords": ["KPI", "metric card", "overview", "dashboard"]
+ "summary": "Pick for 4-8 standalone numeric metrics shown as overview cards (2x2 or 1x4). Skip if metrics have target baselines (use bullet_chart) or single hero number (use gauge_chart)."
},
"line_chart": {
- "label": "Line Chart",
- "summary": "Pick for 1-3 time-series on a continuous axis showing direction. Skip if cumulative volume matters (use area_chart) or different units (use dual_axis_line_chart).",
- "keywords": ["trend", "line chart", "growth", "time series"]
+ "summary": "Pick for 1-3 time-series on a continuous axis showing direction. Skip if cumulative volume matters (use area_chart) or different units (use dual_axis_line_chart)."
},
"matrix_2x2": {
- "label": "Action Priority Matrix",
- "summary": "Pick for items plotted on Impact x Effort or similar generic 2-axis prioritization. Skip for named-quadrant strategic frameworks (use bcg_matrix or swot_analysis).",
- "keywords": ["matrix", "quadrant", "priority", "effort", "impact", "features"]
+ "summary": "Pick for items plotted on Impact x Effort or similar generic 2-axis prioritization. Skip for named-quadrant strategic frameworks (use bcg_matrix or swot_analysis)."
},
"org_chart": {
- "label": "Organization Chart",
- "summary": "Pick for organizational hierarchy 2-4 levels deep with reporting lines. Skip for goal hierarchy (use okr_tree) or non-hierarchical team showcase (use team_roster).",
- "keywords": ["organization", "org chart", "hierarchy", "reporting relationship"]
+ "summary": "Pick for organizational hierarchy 2-4 levels deep with reporting lines. Skip for goal hierarchy (use okr_tree) or non-hierarchical team showcase (use team_roster)."
},
"pareto_chart": {
- "label": "Pareto Chart",
- "summary": "Pick to show 80/20 contribution: descending bars + cumulative line. Skip if cumulative line is not the message (use bar_chart).",
- "keywords": ["Pareto", "80/20", "cumulative contribution", "priority"]
+ "summary": "Pick to show 80/20 contribution: descending bars + cumulative line. Skip if cumulative line is not the message (use bar_chart)."
},
"pie_chart": {
- "label": "Pie Chart",
- "summary": "Pick for simple 3-6 part proportions of one whole. Skip for >=7 parts (use donut_chart or treemap_chart) or hierarchical composition (use treemap_chart).",
- "keywords": ["proportion", "pie chart", "composition", "share"]
+ "summary": "Pick for simple 3-6 part proportions of one whole. Skip for >=7 parts (use donut_chart or treemap_chart) or hierarchical composition (use treemap_chart)."
},
"porter_five_forces": {
- "label": "Porter's Five Forces",
- "summary": "Pick for industry-internal competitive structure (5 forces around central rivalry). Skip for macro environment (use pest_analysis).",
- "keywords": ["strategy", "five forces", "industry analysis", "competition"]
+ "summary": "Pick for industry-internal competitive structure (5 forces around central rivalry). Skip for macro environment (use pest_analysis)."
},
"process_flow": {
- "label": "Process Flow",
- "summary": "Pick for 3-8 sequential steps connected by simple arrows. Skip if cyclical (use cycle_diagram) or stages produce named outputs (use pipeline_with_stages).",
- "keywords": ["process", "steps", "flowchart", "methodology", "connector arrow", "line arrow", "marker arrow"]
+ "summary": "Pick for 3-8 sequential steps connected by simple arrows. Skip if cyclical (use cycle_diagram) or stages produce named outputs (use pipeline_with_stages)."
},
"progress_bar_chart": {
- "label": "Progress Bar Chart",
- "summary": "Pick for 3-8 items each with a completion %. Skip if items have explicit target+actual values (use bullet_chart).",
- "keywords": ["progress", "completion rate", "progress bar", "OKR"]
+ "summary": "Pick for 3-8 items each with a completion %. Skip if items have explicit target+actual values (use bullet_chart)."
},
"radar_chart": {
- "label": "Radar Chart",
- "summary": "Pick for 4-8 capability dimensions scored across 1-3 entities. Skip for >3 entities (becomes unreadable; use grouped_bar_chart) or <4 dimensions.",
- "keywords": ["radar chart", "multi-dimensional assessment", "capability", "competitive"]
+ "summary": "Pick for 4-8 capability dimensions scored across 1-3 entities. Skip for >3 entities (becomes unreadable; use grouped_bar_chart) or <4 dimensions."
},
"sankey_chart": {
- "label": "Sankey Diagram",
- "summary": "Pick for 3-stage flow with magnitude (sources -> nodes -> sinks). Skip for simple linear conversion without splits (use funnel_chart).",
- "keywords": ["flow direction", "Sankey diagram", "conversion path", "resource allocation"]
+ "summary": "Pick for 3-stage flow with magnitude (sources -> nodes -> sinks). Skip for simple linear conversion without splits (use funnel_chart)."
},
"scatter_chart": {
- "label": "Scatter Plot",
- "summary": "Pick for x-y correlation, cluster, or outlier scan. Skip if a size dimension also matters (use bubble_chart).",
- "keywords": ["scatter plot", "correlation", "distribution", "outlier"]
+ "summary": "Pick for x-y correlation, cluster, or outlier scan. Skip if a size dimension also matters (use bubble_chart)."
},
"stacked_area_chart": {
- "label": "Stacked Area Chart",
- "summary": "Pick for 2-4 series showing both total and composition over time. Skip if individual series matter more than total (use line_chart).",
- "keywords": ["stacked", "area chart", "trend", "composition change"]
+ "summary": "Pick for 2-4 series showing both total and composition over time. Skip if individual series matter more than total (use line_chart)."
},
"stacked_bar_chart": {
- "label": "Stacked Bar Chart",
- "summary": "Pick when each category splits into 2-4 internal parts and total still matters. Skip if only comparing totals (use bar_chart).",
- "keywords": ["stacked bar chart", "composition", "contribution", "total"]
+ "summary": "Pick when each category splits into 2-4 internal parts and total still matters. Skip if only comparing totals (use bar_chart)."
},
"swot_analysis": {
- "label": "SWOT Analysis",
- "summary": "Pick for SWOT four-quadrant strategic analysis (Strengths/Weaknesses/Opportunities/Threats). Skip for generic 2-axis prioritization (use matrix_2x2).",
- "keywords": ["SWOT", "strategy", "strengths and weaknesses", "opportunities and threats"]
+ "summary": "Pick for SWOT four-quadrant strategic analysis (Strengths/Weaknesses/Opportunities/Threats). Skip for generic 2-axis prioritization (use matrix_2x2)."
},
"timeline": {
- "label": "Timeline",
- "summary": "Pick for 3-8 milestone events on a horizontal time axis (no duration). Skip for tasks with start/end ranges (use gantt_chart) or vertical layout (use roadmap_vertical).",
- "keywords": ["timeline", "milestone", "history", "evolution"]
+ "summary": "Pick for 3-8 milestone events on a horizontal time axis (no duration). Skip for tasks with start/end ranges (use gantt_chart) or vertical layout (use roadmap_vertical)."
},
"treemap_chart": {
- "label": "Treemap",
- "summary": "Pick for hierarchical/grouped area proportion with many parts of varying size. Skip for flat 3-6 parts (use pie_chart or donut_chart).",
- "keywords": ["treemap", "area proportion", "hierarchy", "composition"]
+ "summary": "Pick for hierarchical/grouped area proportion with many parts of varying size. Skip for flat 3-6 parts (use pie_chart or donut_chart)."
},
"waterfall_chart": {
- "label": "Waterfall Chart",
- "summary": "Pick for stepwise additive/subtractive breakdown bridging a starting value to an ending value. Skip if no running total (use bar_chart).",
- "keywords": ["waterfall chart", "change breakdown", "contribution", "bridge analysis"]
+ "summary": "Pick for stepwise additive/subtractive breakdown bridging a starting value to an ending value. Skip if no running total (use bar_chart)."
},
"pyramid_chart": {
- "label": "Pyramid Chart",
- "summary": "Pick for 3-6 stratified hierarchy layers (e.g. Maslow, maturity model). Skip for flat priority list (use vertical_list) or org reporting (use org_chart).",
- "keywords": ["pyramid", "hierarchy", "layers", "maturity model", "Maslow"]
+ "summary": "Pick for 3-6 stratified hierarchy layers in flat 2D side-view, documentary tone (Maslow, maturity model). Skip for dramatic tone (use pyramid_isometric), flat priority list (use vertical_list), or org reporting (use org_chart)."
+ },
+ "pyramid_isometric": {
+ "summary": "Pick for 4-tier maturity/achievement model with presentation drama (review reports, capability tiers). Tier count fixed at 4 (hand-tuned vertices). Skip for documentary tone (use pyramid_chart) or tier count != 4."
},
"venn_diagram": {
- "label": "Venn Diagram",
- "summary": "Pick for 2-3 overlapping sets where the intersection is the message. Skip if no overlap exists (use icon_grid).",
- "keywords": ["Venn", "intersection", "overlap", "relationship", "synergy"]
+ "summary": "Pick for 2-3 overlapping sets where the intersection is the message. Skip if no overlap exists (use icon_grid)."
},
"pros_cons_chart": {
- "label": "Pros & Cons Chart",
- "summary": "Pick for bilateral pros/cons list, 2-5 items per side. Skip for full feature comparison (use comparison_table) or numeric A/B mirror data (use butterfly_chart).",
- "keywords": ["pros cons", "advantages", "disadvantages", "comparison", "evaluation"]
+ "summary": "Pick for bilateral pros/cons list, 2-5 items per side. Skip for full feature comparison (use comparison_table) or numeric A/B mirror data (use butterfly_chart)."
},
"cycle_diagram": {
- "label": "Cycle Diagram",
- "summary": "Pick for 4-6 stage closed loop with no clear start/end (e.g. PDCA). Skip for self-reinforcing growth loop (use flywheel_diagram) or linear flow (use process_flow).",
- "keywords": ["cycle", "loop", "PDCA", "iteration", "circular process"]
+ "summary": "Pick for 4-6 stage closed loop with no clear start/end (e.g. PDCA). Skip for self-reinforcing growth loop (use flywheel_diagram) or linear flow (use process_flow)."
},
"numbered_steps": {
- "label": "Numbered Steps",
- "summary": "Pick for 3-6 horizontal sequential steps with numeric emphasis. Skip if steps need connector arrows (use process_flow) or named output artifacts (use pipeline_with_stages).",
- "keywords": ["steps", "numbered", "sequential", "methodology", "implementation path"]
+ "summary": "Pick for 3-6 horizontal sequential steps with numeric emphasis. Skip if steps need connector arrows (use process_flow) or named output artifacts (use pipeline_with_stages)."
},
"icon_grid": {
- "label": "Icon Grid",
- "summary": "Pick for 4-9 parallel features/capabilities as icon cards. Skip for sequential ordering (use numbered_steps) or hierarchical layers (use pyramid_chart).",
- "keywords": ["grid", "cards", "features", "capabilities", "icon list"]
+ "summary": "Pick for 4-9 parallel features/capabilities as icon cards. Skip for sequential ordering (use numbered_steps) or hierarchical layers (use pyramid_chart)."
},
"isometric_stairs": {
- "label": "Isometric Stairs",
- "summary": "Pick for 4-7 ascending stages emphasizing growth/maturity progression visually. Skip for flat sequential steps (use numbered_steps) or formal hierarchy (use pyramid_chart).",
- "keywords": ["isometric", "3D stairs", "progression", "maturity", "growth stages"]
+ "summary": "Pick for 4-7 ascending stages emphasizing growth/maturity progression visually. Skip for flat sequential steps (use numbered_steps) or formal hierarchy (use pyramid_chart)."
},
"mind_map": {
- "label": "Mind Map",
- "summary": "Pick for one core topic radiating into 3-6 brainstorm branches. Skip for capability hub-and-spoke (use hub_spoke) or strict hierarchy (use okr_tree or org_chart).",
- "keywords": ["mind map", "brainstorm", "knowledge structure", "topic decomposition", "radial"]
+ "summary": "Pick for one core topic radiating into 3-6 brainstorm branches. Skip for capability hub-and-spoke (use hub_spoke) or strict hierarchy (use okr_tree or org_chart)."
},
"comparison_table": {
- "label": "Comparison Table",
- "summary": "Pick for 2-4 plans/products compared across many feature rows (dense matrix). Skip for pricing-tier marketing layout (use comparison_columns).",
- "keywords": ["comparison matrix", "feature comparison", "evaluation", "product selection", "scoring"]
+ "summary": "Pick for 2-4 plans/products compared across many feature rows (dense matrix). Skip for pricing-tier marketing layout (use comparison_columns)."
},
"snake_flow": {
- "label": "Snake Flow",
- "summary": "Pick for 6-10 winding sequential steps fitting a long journey/lifecycle on one slide. Skip for <=5 steps (use numbered_steps).",
- "keywords": ["snake", "S-flow", "journey", "lifecycle", "winding process"]
+ "summary": "Pick for 6-10 winding sequential steps fitting a long journey/lifecycle on one slide. Skip for <=5 steps (use numbered_steps)."
},
"roadmap_vertical": {
- "label": "Vertical Roadmap",
- "summary": "Pick for 4-8 milestones on a vertical timeline with status indicators. Skip for horizontal time emphasis (use timeline) or tasks with durations (use gantt_chart).",
- "keywords": ["roadmap", "vertical timeline", "milestones", "annual plan", "progress tracking"]
+ "summary": "Pick for 4-8 milestones on a vertical timeline with status indicators. Skip for horizontal time emphasis (use timeline) or tasks with durations (use gantt_chart)."
},
"word_cloud": {
- "label": "Word Cloud",
- "summary": "Pick for 20-30 keywords sized by frequency/weight. Skip if individual keyword position carries meaning (use icon_grid).",
- "keywords": ["word cloud", "keywords", "tag cloud", "hot topics", "frequency"]
+ "summary": "Pick for 20-30 keywords sized by frequency/weight. Skip if individual keyword position carries meaning (use icon_grid)."
},
"concentric_circles": {
- "label": "Concentric Circles",
- "summary": "Pick for 3-5 priority rings from core to periphery (bullseye/onion model). Skip for non-prioritized layers (use pyramid_chart).",
- "keywords": ["concentric", "bullseye", "target", "priority layers", "onion diagram"]
+ "summary": "Pick for 3-5 priority rings from core to periphery (bullseye/onion model). Skip for non-prioritized layers (use pyramid_chart)."
},
"chevron_process": {
- "label": "Chevron Process",
- "summary": "Pick for 3-6 phase methodology with chunky arrow-chain progression and deliverables per phase. Skip for <=2 phases or non-linear flow (use process_flow).",
- "keywords": ["chevron", "arrow chain", "block arrow", "chunky arrow", "solid arrow", "phase", "methodology", "implementation"]
+ "summary": "Pick for 3-6 phase methodology with chunky arrow-chain progression and deliverables per phase. Skip for <=2 phases or non-linear flow (use process_flow)."
},
"comparison_columns": {
- "label": "Comparison Columns",
- "summary": "Pick for 2-4 pricing/service tier cards in side-by-side columns (marketing layout). Skip for dense feature comparison (use comparison_table).",
- "keywords": ["pricing", "columns", "service tiers", "membership", "subscription"]
+ "summary": "Pick for 2-4 pricing/service tier cards in side-by-side columns (marketing layout). Skip for dense feature comparison (use comparison_table)."
},
"fishbone_diagram": {
- "label": "Fishbone Diagram",
- "summary": "Pick for cause-and-effect root cause analysis with 4-6 cause branches (Ishikawa, 6M). Skip for sequential flow (use process_flow).",
- "keywords": ["fishbone", "Ishikawa", "cause effect", "root cause", "6M analysis"]
+ "summary": "Pick for cause-and-effect root cause analysis with 4-6 cause branches (Ishikawa, 6M). Skip for sequential flow (use process_flow)."
},
"hub_spoke": {
- "label": "Hub & Spoke",
- "summary": "Pick for 1 core capability + 4-8 surrounding capabilities (platform/ecosystem). Each spoke card carries title only or title + 1-2 line description. Skip if center is a system containing parts with their own descriptions (use module_composition).",
- "keywords": ["hub spoke", "central", "radial", "semi-circle", "platform", "ecosystem", "satellite", "capability matrix", "service architecture", "核心能力", "中台", "surrounding capabilities"]
+ "summary": "Pick for 1 core capability + 4-8 surrounding capabilities (platform/ecosystem); each spoke = title or title + 1-2 line description. Skip if center is a system containing parts with their own descriptions (use module_composition)."
},
"vertical_list": {
- "label": "Vertical List",
- "summary": "Pick for 3-6 numbered key points each with a short description. Skip for icon-style cards (use icon_grid) or sequential steps (use numbered_steps).",
- "keywords": ["vertical list", "numbered list", "advantages", "features", "key points", "strengths"]
+ "summary": "Pick for 3-6 numbered key points each with a short description. Skip for icon-style cards (use icon_grid) or sequential steps (use numbered_steps)."
},
"layered_architecture": {
- "label": "Layered Architecture",
- "summary": "Pick for 3-4 horizontal architecture layers (e.g. presentation/service/data), 2-4 module cards per layer. Each module card MUST carry title + 1-line capability description — do not omit description even when source is brief. Skip if no per-module descriptions are available (use icon_grid) or no horizontal layering (use module_composition).",
- "keywords": ["architecture", "架构图", "系统架构", "分层架构", "layered", "tech stack", "分层", "模块", "technical architecture", "system design"]
+ "summary": "Pick for 3-4 horizontal architecture layers (presentation/service/data), 2-4 module cards per layer, each card = title + 1-line description (description required, even if source brief). Skip if no per-module descriptions (use icon_grid) or no horizontal layering (use module_composition)."
},
"module_composition": {
- "label": "Module Composition",
- "summary": "Pick for one parent container wrapping 3-N child module cards; each child = title + 2-3 bullet descriptions. Direct fit for 'Feature X contains 3 parts, each part has its own description'. Skip if source provides only labels without descriptions (use numbered_steps or icon_grid).",
- "keywords": ["architecture", "架构图", "module composition", "模块组合", "子模块", "组成", "composition", "包含", "sub-modules", "父子结构", "engine components"]
+ "summary": "Pick for one parent container wrapping 3-N child module cards, each = title + 2-3 bullets — fits 'Feature X contains 3 parts, each with its own description'. Skip if source has only labels without descriptions (use numbered_steps or icon_grid)."
},
"pipeline_with_stages": {
- "label": "Pipeline with Stages",
- "summary": "Pick for 3-5 stage horizontal pipeline where each stage = title + 1-line description + output artifact, connected by directional arrows. For data pipelines / ETL / build pipelines where each stage consumes the previous stage's output. Skip if any stage lacks an artifact (use process_flow or numbered_steps).",
- "keywords": ["architecture", "架构图", "pipeline", "管道", "ETL", "数据处理流水线", "data pipeline", "build pipeline", "stages with output", "流水线", "处理流程"]
+ "summary": "Pick for 3-5 horizontal pipeline stages, each = title + 1-line description + output artifact, connected by arrows (data pipelines, ETL, build pipelines). Skip if any stage lacks an artifact (use process_flow or numbered_steps)."
},
"client_server_flow": {
- "label": "Client-Server Flow",
- "summary": "Pick for left-side client modules + right-side server modules with labeled bidirectional arrows showing key interactions (request/response/push). Each module = name + 1-line description; each arrow MUST have an action label. Skip for non-distributed flows (use process_flow).",
- "keywords": ["architecture", "架构图", "client server", "客户端-服务端", "request response", "API 调用", "前后端交互", "C/S architecture", "interaction diagram", "通信架构"]
+ "summary": "Pick for left-side clients + right-side servers with labeled bidirectional arrows for key interactions (request/response/push). Each module = name + 1-line description; each arrow must have an action label. Skip for non-distributed flows (use process_flow)."
},
"basic_table": {
- "label": "Basic Data Table",
- "summary": "Pick for plain tabular text/number grid, 3-8 columns. Skip if cells need visual bars (use consulting_table) or qualitative scores (use harvey_balls_table).",
- "keywords": ["table", "grid", "data table", "list", "metrics"]
+ "summary": "Pick for plain tabular text/number grid, 3-8 columns. Skip if cells need visual bars (use consulting_table) or qualitative scores (use harvey_balls_table)."
},
"consulting_table": {
- "label": "Consulting Data Table",
- "summary": "Pick for high-density tables with embedded micro bar visuals (consulting/financial reports). Skip for plain text data (use basic_table).",
- "keywords": ["table", "visual table", "data bar", "consulting", "financial"]
+ "summary": "Pick for high-density tables with embedded micro bar visuals (consulting/financial reports). Skip for plain text data (use basic_table)."
},
"project_schedule_table": {
- "label": "Project Schedule Table",
- "summary": "Pick for table-style task tracker (task / owner / status / timeline). Skip for true Gantt with dependencies (use gantt_chart) or schedule without ownership (use roadmap_vertical).",
- "keywords": ["table", "schedule", "gantt", "timeline", "project management"]
+ "summary": "Pick for table-style task tracker (task / owner / status / timeline). Skip for true Gantt with dependencies (use gantt_chart) or schedule without ownership (use roadmap_vertical)."
},
"financial_statement_table": {
- "label": "Financial Statement Table",
- "summary": "Pick for income statement / balance sheet style with right-aligned numbers and strong total rows. Skip for non-financial tabular data (use basic_table).",
- "keywords": ["table", "financial", "income statement", "budget", "numbers"]
+ "summary": "Pick for income statement / balance sheet style with right-aligned numbers and strong total rows. Skip for non-financial tabular data (use basic_table)."
},
"feature_matrix_table": {
- "label": "Feature Matrix Table",
- "summary": "Pick for competitive feature checklist with checkmarks across products. Skip for qualitative scores (use harvey_balls_table) or pricing tier marketing (use comparison_columns).",
- "keywords": ["table", "matrix", "feature comparison", "competitor", "checklist"]
+ "summary": "Pick for competitive feature checklist with checkmarks across products. Skip for qualitative scores (use harvey_balls_table) or pricing tier marketing (use comparison_columns)."
},
"harvey_balls_table": {
- "label": "Harvey Balls Matrix",
- "summary": "Pick for qualitative scoring grid using 0-100% Harvey balls (vendor/skill assessment). Skip for binary checkmarks (use feature_matrix_table) or numeric values (use basic_table).",
- "keywords": ["table", "matrix", "harvey balls", "qualitative", "scoring", "evaluation"]
+ "summary": "Pick for qualitative scoring grid using 0-100% Harvey balls (vendor/skill assessment). Skip for binary checkmarks (use feature_matrix_table) or numeric values (use basic_table)."
},
"team_roster": {
- "label": "Team Roster",
- "summary": "Pick for 3-12 leadership/team profile cards (photo + name + title + short bio). Skip for reporting hierarchy (use org_chart).",
- "keywords": ["team", "roster", "profile", "bio", "leadership", "cards"]
+ "summary": "Pick for 3-12 leadership/team profile cards (photo + name + title + short bio). Skip for reporting hierarchy (use org_chart)."
},
"pest_analysis": {
- "label": "PEST Analysis",
- "summary": "Pick for macro-environment scan: Political / Economic / Social / Technological. Skip for industry-internal forces (use porter_five_forces).",
- "keywords": ["strategy", "pest", "pestle", "macro", "environmental", "framework"]
+ "summary": "Pick for macro-environment scan: Political / Economic / Social / Technological. Skip for industry-internal forces (use porter_five_forces)."
},
"value_chain": {
- "label": "Value Chain",
- "summary": "Pick for Porter's primary + support activities mapped to margin. Skip for sequential workflow (use process_flow) or pipeline with artifacts (use pipeline_with_stages).",
- "keywords": ["strategy", "value chain", "operations", "margin", "competitive advantage"]
+ "summary": "Pick for Porter's primary + support activities mapped to margin. Skip for sequential workflow (use process_flow) or pipeline with artifacts (use pipeline_with_stages)."
},
"journey_map": {
- "label": "Customer Journey Map",
- "summary": "Pick for multi-phase customer experience matrix with actions, emotion curve, and pain points per phase. Skip for simple linear funnel (use funnel_chart).",
- "keywords": ["journey", "ux", "customer", "experience", "marketing", "funnel"]
+ "summary": "Pick for multi-phase customer experience matrix with actions, emotion curve, and pain points per phase. Skip for simple linear funnel (use funnel_chart)."
},
"agenda_list": {
- "label": "Agenda List",
- "summary": "Pick for table of contents, meeting agendas, or section dividers (large numbers, sparse content). Skip for substantive content lists (use vertical_list).",
- "keywords": ["agenda", "table of contents", "toc", "divider", "list", "meeting"]
+ "summary": "Pick for table of contents, meeting agendas, or section dividers (large numbers, sparse content). Skip for substantive content lists (use vertical_list)."
},
"bcg_matrix": {
- "label": "BCG Matrix",
- "summary": "Pick for product portfolio in Growth x Share named quadrants (Stars / Cash Cows / Question Marks / Dogs). Skip for generic 2-axis prioritization (use matrix_2x2).",
- "keywords": ["strategy", "bcg matrix", "portfolio", "growth-share", "product lifecycle"]
+ "summary": "Pick for product portfolio in Growth x Share named quadrants (Stars / Cash Cows / Question Marks / Dogs). Skip for generic 2-axis prioritization (use matrix_2x2)."
},
"ansoff_matrix": {
- "label": "Ansoff Matrix",
- "summary": "Pick for growth strategy: Existing/New Markets x Existing/New Products. Skip for portfolio analysis (use bcg_matrix).",
- "keywords": ["strategy", "ansoff", "growth", "expansion", "market development"]
+ "summary": "Pick for growth strategy: Existing/New Markets x Existing/New Products. Skip for portfolio analysis (use bcg_matrix)."
},
"flywheel_diagram": {
- "label": "Flywheel Diagram",
- "summary": "Pick for circular self-reinforcing growth loop where each stage compounds the next (e.g. Attract -> Engage -> Delight). Skip for non-compounding closed loop (use cycle_diagram).",
- "keywords": ["process", "flywheel", "cycle", "growth loop", "momentum"]
+ "summary": "Pick for circular self-reinforcing growth loop where each stage compounds the next (e.g. Attract -> Engage -> Delight). Skip for non-compounding closed loop (use cycle_diagram)."
},
"okr_tree": {
- "label": "OKR Goal Tree",
- "summary": "Pick for top-down hierarchical tree connecting Objective -> Key Results -> Initiatives. Skip for organizational reporting (use org_chart).",
- "keywords": ["okr", "goals", "hierarchy", "tree", "planning", "alignment"]
+ "summary": "Pick for top-down hierarchical tree connecting Objective -> Key Results -> Initiatives. Skip for organizational reporting (use org_chart)."
+ },
+ "labeled_card": {
+ "summary": "Pick for 3-4 parallel aspects of one subject with per-aspect titles + short body (self-introduction, four-pillar overview, capability quadrant). Skip for plain feature lists (use icon_grid), sequential steps (use numbered_steps), or strategic quadrants (use swot_analysis / matrix_2x2)."
}
}
}
diff --git a/skills/ppt-master/templates/design_spec_reference.md b/skills/ppt-master/templates/design_spec_reference.md
index e302e65e..c5844865 100644
--- a/skills/ppt-master/templates/design_spec_reference.md
+++ b/skills/ppt-master/templates/design_spec_reference.md
@@ -218,7 +218,7 @@ Two views on the same font decisions — fill both, keep them consistent:
**Read-audit** (mandatory):
```
-Catalog read: <N> templates / <M> categories
+Catalog read: 72 templates
Runners-up considered: <key_A> (rejected: <reason>), <key_B> (rejected: <reason>), <key_C> (rejected: <reason>)
```