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(template-selection): default to free design, make template flow opt-in

hugohe36f54de07ecaa
diff --git a/skills/ppt-master/SKILL.md b/skills/ppt-master/SKILL.md
index 13fa5ae1..5ca35681 100644
--- a/skills/ppt-master/SKILL.md
+++ b/skills/ppt-master/SKILL.md
@@ -125,27 +125,20 @@ Import source content (choose based on the situation):
---
-### Step 3: Template Selection
+### Step 3: Template Option
🚧 **GATE**: Step 2 complete; project directory structure is ready.
-⛔ **BLOCKING**: If the user has not yet clearly expressed whether to use a template, you MUST present options and **wait for an explicit user response** before proceeding. If the user has previously stated "no template" or specified a particular template, skip this prompt and proceed directly.
+**Default path — free design, no question asked.** Proceed directly to Step 4. Do NOT query `layouts_index.json` and do NOT ask the user an A/B template-vs-free-design question. Free design is the standard mode: the AI tailors structure and style to the specific content.
-**⚡ Early-exit**: If the user has already stated "no template" / "不使用模板" / "自由设计" (or equivalent) at any prior point in the conversation, **do NOT query `layouts_index.json`** — skip directly to Step 4. This avoids unnecessary token consumption.
+**Template flow is opt-in.** Enter it only when one of these explicit triggers appears in the user's prior messages:
-**Template recommendation flow** (only when the user has NOT yet decided):
-Query `${SKILL_DIR}/templates/layouts/layouts_index.json` to list available templates and their style descriptions.
-**When presenting options, you MUST provide a professional recommendation based on the current PPT topic and content** (recommend a specific template or free design, with reasoning). By default, **lean toward free design** unless the content clearly benefits from a fixed structural preset (e.g., consulting report, annual report, academic paper). Then ask the user:
+1. User names a specific template (e.g., "用 mckinsey 模板" / "use the academic_defense template")
+2. User names a style / brand reference that maps to a template (e.g., "McKinsey 那种" / "Google style" / "学术答辩样式")
+3. User explicitly asks what templates exist (e.g., "有哪些模板可以用")
-> 💡 **AI Recommendation**: Based on your content topic (brief summary), I recommend **[specific template / free design]** because...
->
-> Note: Both options produce fully-designed output. A template is a validated **"structure + style" preset** (e.g., McKinsey-style, Google-style); free design lets the AI tailor structure and style to your specific content — usually yielding a more content-fitting result.
->
-> Which approach would you prefer?
-> **A) Use an existing template** — apply a validated structure+style preset (please specify template name or style preference)
-> **B) Free design** (recommended for most cases) — AI tailors structure and style to your content
+Only when a trigger fires: read `${SKILL_DIR}/templates/layouts/layouts_index.json`, resolve the match (or list available options for trigger 3), and copy template files to the project directory:
-After the user confirms option A, copy template files to the project directory:
```bash
cp ${SKILL_DIR}/templates/layouts/<template_name>/*.svg <project_path>/templates/
cp ${SKILL_DIR}/templates/layouts/<template_name>/design_spec.md <project_path>/templates/
@@ -153,17 +146,21 @@ cp ${SKILL_DIR}/templates/layouts/<template_name>/*.png <project_path>/images/ 2
cp ${SKILL_DIR}/templates/layouts/<template_name>/*.jpg <project_path>/images/ 2>/dev/null || true
```
-After the user confirms option B (free design), proceed directly to Step 4.
+**Soft hint (non-blocking, optional).** Before Step 4, if the user's content is an obvious strong match for an existing template (e.g., clearly an academic defense, a government report, a McKinsey-style consulting deck) AND the user has given no template signal, the AI MAY emit a single-sentence notice and continue without waiting:
+
+> Note: the library has a template `<name>` that matches this scenario closely. Say the word if you want to use it; otherwise I'll continue with free design.
+
+This is a hint, not a question — do NOT block, do NOT require an answer. Skip the hint entirely when the match is weak or ambiguous.
> To create a new global template, read `workflows/create-template.md`
-**✅ Checkpoint — User has responded with template selection, template files copied (if option A). Proceed to Step 4.**
+**✅ Checkpoint — Default path proceeds to Step 4 without user interaction. If a template trigger fired, template files are copied before advancing.**
---
### Step 4: Strategist Phase (MANDATORY — cannot be skipped)
-🚧 **GATE**: Step 3 complete; user has confirmed template selection.
+🚧 **GATE**: Step 3 complete; default free-design path taken, or (if triggered) template files copied into the project.
First, read the role definition:
```
@@ -174,7 +171,7 @@ Read references/strategist.md
**Must complete the Eight Confirmations** (full template structure in `templates/design_spec_reference.md`):
-⛔ **BLOCKING**: The Eight Confirmations MUST be presented to the user as a bundled set of recommendations, and you MUST **wait for the user to confirm or modify** before outputting the Design Specification & Content Outline. This is one of only two core confirmation points in the workflow (the other is template selection). Once confirmed, all subsequent script execution and slide generation should proceed fully automatically.
+⛔ **BLOCKING**: The Eight Confirmations MUST be presented to the user as a bundled set of recommendations, and you MUST **wait for the user to confirm or modify** before outputting the Design Specification & Content Outline. This is the single core confirmation point in the workflow. Once confirmed, all subsequent script execution and slide generation should proceed fully automatically.
1. Canvas format
2. Page count range
diff --git a/skills/ppt-master/templates/README.md b/skills/ppt-master/templates/README.md
index 907e734c..d9961eb8 100644
--- a/skills/ppt-master/templates/README.md
+++ b/skills/ppt-master/templates/README.md
@@ -19,7 +19,7 @@ The `layouts/` directory contains pre-built page layout templates organized by d
- **Academic Defense**: Academic defense style, research-oriented
- **Human browsing**: [layouts/README.md](./layouts/README.md)
-- **AI / Programmatic lookup**: [layouts/layouts_index.json](./layouts/layouts_index.json)
+- **Slim lookup (opt-in)**: [layouts/layouts_index.json](./layouts/layouts_index.json) — only consulted when the user explicitly opts into the template flow
## Visualization Templates
diff --git a/skills/ppt-master/templates/layouts/README.md b/skills/ppt-master/templates/layouts/README.md
index dbfcc352..cb58cd2f 100644
--- a/skills/ppt-master/templates/layouts/README.md
+++ b/skills/ppt-master/templates/layouts/README.md
@@ -2,10 +2,10 @@
Pre-built PPT page layout templates supporting multiple styles and use cases.
-- **Full Index**: [README.md](./README.md) (human browsing)
-- **JSON Index**: [layouts_index.json](./layouts_index.json) (AI / programmatic lookup — preferred)
+- **Full Index**: [README.md](./README.md) (human browsing — includes categories, primary colors, detailed tone)
+- **Slim Index**: [layouts_index.json](./layouts_index.json) (lightweight lookup — `label` / `summary` / `keywords` only)
-> **AI / Programmatic recommendation**: Prefer reading `layouts_index.json`; use this README for human browsing and quick comparison.
+> **Template selection is opt-in.** The main workflow defaults to free design and does NOT read `layouts_index.json` unless the user explicitly requests a template. See `SKILL.md` Step 3.
---
@@ -227,9 +227,9 @@ cp templates/layouts/government_red/* projects/<project>/templates/
4. All SVGs use `viewBox="0 0 1280 720"`
5. Follow SVG technical constraints (see below)
6. Validate the template directory with `python3 scripts/svg_quality_checker.py templates/layouts/<template_name> --format ppt169`
-7. Register the new template in `templates/layouts/layouts_index.json`
+7. Register the new template in `templates/layouts/layouts_index.json` with three fields: `label`, `summary`, `keywords`
-`layouts_index.json` is the primary machine-readable source for template discovery. A template folder without an index entry is considered incomplete.
+`layouts_index.json` is the lightweight lookup used when a user explicitly opts into the template flow. A template folder without an index entry will not be discoverable by that flow.
### SVG Technical Constraints (All Templates Must Comply)
diff --git a/skills/ppt-master/templates/layouts/layouts_index.json b/skills/ppt-master/templates/layouts/layouts_index.json
index 644d145e..9d7fb297 100644
--- a/skills/ppt-master/templates/layouts/layouts_index.json
+++ b/skills/ppt-master/templates/layouts/layouts_index.json
@@ -1,204 +1,107 @@
{
- "meta": {
- "total": 21,
- "defaultViewBox": "0 0 1280 720",
- "formats": ["ppt169"],
- "standardFiles": ["design_spec.md", "01_cover.svg", "02_toc.svg", "02_chapter.svg", "03_content.svg", "04_ending.svg"],
- "standardPageTypes": ["cover", "toc", "chapter", "content", "ending"],
- "updated": "2026-04-18"
- },
- "categories": {
- "brand": {
- "label": "Brand Style Templates",
- "layouts": ["google_style", "mckinsey", "anthropic", "china_telecom_template", "中汽研_常规", "中汽研_商务", "中汽研_现代", "中国电建_常规", "中国电建_现代", "招商银行"]
- },
- "general": {
- "label": "General Style Templates",
- "layouts": ["exhibit", "科技蓝商务", "smart_red"]
- },
- "scenario": {
- "label": "Scenario-Specific Templates",
- "layouts": ["academic_defense", "psychology_attachment", "medical_university", "重庆大学"]
- },
- "government": {
- "label": "Government/Enterprise Templates",
- "layouts": ["government_red", "government_blue", "ai_ops"]
- },
- "special": {
- "label": "Special Style Templates",
- "layouts": ["pixel_retro"]
- }
- },
- "quickLookup": {
- "strategy": ["exhibit", "mckinsey"],
- "board": ["exhibit", "mckinsey", "招商银行"],
- "general_business": ["科技蓝商务", "smart_red", "exhibit", "china_telecom_template"],
- "technology": ["anthropic", "google_style", "smart_red", "ai_ops", "china_telecom_template"],
- "government": ["government_red", "government_blue", "ai_ops"],
- "academic": ["academic_defense", "重庆大学"],
- "medical": ["medical_university"],
- "psychology": ["psychology_attachment"],
- "finance": ["招商银行", "exhibit", "mckinsey"],
- "certification": ["中汽研_常规", "中汽研_商务", "中汽研_现代"],
- "energy": ["中国电建_常规", "中国电建_现代"],
- "creative": ["pixel_retro", "smart_red"]
- },
- "layouts": {
- "academic_defense": {
- "label": "Academic Defense Template",
- "summary": "A standard template for academic defenses, research presentations, and project proposals",
- "tone": "Professional, rigorous, research-oriented, clear hierarchy",
- "themeMode": "Light theme (white background + dark blue title bar)",
- "keywords": ["Academic", "Defense", "Research", "Standard"]
- },
- "ai_ops": {
- "label": "Enterprise Digital Intelligence Template",
- "summary": "For high-density scenarios such as telecom AI operations architecture, IT system overview, and digital transformation plans",
- "tone": "Information-dense, structured, modular layout, telecom/government-enterprise style",
- "themeMode": "Light theme (white background + red/blue accents + warm gray panels)",
- "assets": ["reference_style.svg"],
- "keywords": ["Telecom", "AI operations", "Digital intelligence", "High density", "Architecture view"]
- },
- "anthropic": {
- "label": "Anthropic Style Template",
- "summary": "A tech-oriented template for AI/LLM knowledge sharing and product launches",
- "tone": "Tech-forward, professional, modern, conclusion-first",
- "themeMode": "Hybrid theme (dark cover/chapter + light content pages)",
- "keywords": ["AI", "LLM", "Developer", "Technology"]
- },
- "china_telecom_template": {
- "label": "中国电信模板",
- "summary": "A China Telecom style template for telecom solution proposals, digital transformation plans, and government-enterprise briefings",
- "tone": "Authoritative, structured, restrained, telecom enterprise style",
- "themeMode": "Light theme (white background + telecom red title bar + silver-gray lane)",
- "assets": ["logo.png", "top_emblem.png", "footer_ribbon.png", "header_brand.png", "slogan_red.png", "skyline_bg.png"],
- "keywords": ["China Telecom", "Telecom", "Digital transformation", "Government-enterprise", "Briefing"]
- },
- "exhibit": {
- "label": "Exhibit Style Template",
- "summary": "Conclusion-first layout with Exhibit takeaway bars for data-driven strategic reports and executive presentations",
- "tone": "Premium, refined, authoritative, data-driven, conclusion-first",
- "themeMode": "Dark theme (dark background + gradient accent + gold highlights)",
- "keywords": ["Exhibit", "Board", "Executive", "Strategy", "Conclusion-first"]
- },
- "google_style": {
- "label": "Google Style Template",
- "summary": "A Google-branded template for annual reports and technical sharing",
- "tone": "Professional, modern, clean and restrained, data-driven, ample whitespace",
- "themeMode": "Light theme (white/light gray background + Google brand color accents)",
- "keywords": ["Google", "Brand style", "Technical sharing", "Annual report"]
- },
- "government_blue": {
- "label": "Government Blue Template",
- "summary": "A blue government-themed template for smart governance and digital transformation reports",
- "tone": "Grand, tech-forward, modernized, professional government style",
- "themeMode": "Light theme (white background + blue gradient decorations)",
- "keywords": ["Government affairs", "Government blue", "Smart city", "Digitalization"]
- },
- "government_red": {
- "label": "Government Red Template",
- "summary": "A red government-themed template for government reports and party-building scenarios",
- "tone": "Authoritative, solemn, professional, modernized government style",
- "themeMode": "Light theme (white background + government red/blue accents)",
- "keywords": ["Government affairs", "Party building", "Government red", "Authoritative"]
- },
- "mckinsey": {
- "label": "McKinsey Style Template",
- "summary": "A McKinsey-style template for strategic consulting and investment analysis",
- "tone": "Data-driven, structured thinking, professional whitespace, minimalist premium",
- "themeMode": "Light theme (white background + McKinsey Blue accent)",
- "keywords": ["McKinsey", "Consulting", "Structured", "Executive presentation"]
- },
- "medical_university": {
- "label": "Hospital/Medical University Template",
- "summary": "A professional template for medical reports, case discussions, and research presentations",
- "tone": "Professional, rigorous, life-affirming, tech-forward, trustworthy",
- "themeMode": "Light theme (white background + medical blue title bar + life green accents)",
- "keywords": ["Medical", "Hospital", "Case study", "Research"]
- },
- "pixel_retro": {
- "label": "Pixel Retro Template",
- "summary": "A pixel-art template for tech sharing and gaming-themed content",
- "tone": "Retro gaming, neon cyber, geek tech, 8-bit style",
- "themeMode": "Dark theme (deep space black background + neon accents)",
- "keywords": ["Pixel art", "Retro gaming", "Cyberpunk", "Technology"]
- },
- "psychology_attachment": {
- "label": "Psychology Healing Template",
- "summary": "A warm and professional template for psychotherapy training and counseling lectures",
- "tone": "Professional, warm, healing, trustworthy",
- "themeMode": "Light theme (cloud white background + blue-green gradient accent + colorful semantic colors)",
- "keywords": ["Psychology", "Healing", "Counseling", "Warm"]
- },
- "smart_red": {
- "label": "Smart Red-Orange Business Template",
- "summary": "A vibrant business template for tech company introductions and education solutions",
- "tone": "Modern, vibrant, professional, geometric",
- "themeMode": "Hybrid theme (dark/colorful cover + light content pages)",
- "keywords": ["Red-orange business", "Tech enterprise", "Education", "Vibrant"]
- },
- "中国电建_常规": {
- "label": "PowerChina Standard Template",
- "summary": "A solid brand template for engineering construction and state-owned enterprise reports",
- "tone": "Professional, steady, international, state-owned enterprise style",
- "themeMode": "Light theme (white background + PowerChina blue accent)",
- "assets": ["中国水务logo.png", "华东院logo.png", "水电三局logo.png", "电建logo.png"],
- "keywords": ["PowerChina", "State-owned enterprise", "Engineering", "Energy"]
- },
- "中国电建_现代": {
- "label": "PowerChina Modern Template",
- "summary": "A modern engineering template for major projects and international business presentations",
- "tone": "Grand narrative, modern precision, digital technology, international vision",
- "themeMode": "Deep blue tech gradient + precision grid texture",
- "assets": ["中国水务logo.png", "华东院logo.png", "水电三局logo.png", "电建logo.png"],
- "keywords": ["PowerChina", "International engineering", "Modern engineering", "Technology"]
- },
- "中汽研_商务": {
- "label": "CATARC Business Template",
- "summary": "A CATARC brand template for certification showcase and high-end business presentations",
- "tone": "Modern tech, authoritative professional, composed and grand",
- "themeMode": "Deep blue tech gradient + clean white content pages",
- "assets": ["右上角 logo.png", "大型 logo.png"],
- "keywords": ["CATARC", "Certification", "Business", "Technology"]
- },
- "中汽研_常规": {
- "label": "CATARC Standard Template",
- "summary": "A standard CATARC template for certification and testing scenarios",
- "tone": "Professional, authoritative, trustworthy, consulting style",
- "themeMode": "Light theme (white background + dark blue accent)",
- "assets": ["右上角 logo.png", "大型 logo.png"],
- "keywords": ["CATARC", "Certification", "Testing", "Authoritative"]
- },
- "中汽研_现代": {
- "label": "CATARC Modern Template",
- "summary": "A futuristic tech template for cutting-edge technology showcase and premium launches",
- "tone": "Futuristic, tech-forward, deep, refined",
- "themeMode": "Immersive dark cover/transition pages + clean light gray content pages",
- "assets": ["右上角 logo.png", "大型 logo.png"],
- "keywords": ["CATARC", "Future tech", "Cutting-edge technology", "Launch event"]
- },
- "招商银行": {
- "label": "China Merchants Bank Transaction Banking Template",
- "summary": "A transaction-banking template for sales collection solutions, product pitches, and branch training",
- "tone": "Brand-consistent, structured, product-focused, refined finance",
- "themeMode": "Hybrid theme (brand-red cover/chapter/ending + light content pages)",
- "assets": ["cover_bg.png", "logo_white.png", "logo_dark.png", "page_header_bg.png", "logo_crm_banner.png", "ref_content_bg.png"],
- "keywords": ["China Merchants Bank", "Transaction banking", "Sales collection", "Finance", "Training"]
- },
- "科技蓝商务": {
- "label": "Tech Blue Business Template",
- "summary": "A tech-business template for corporate reports and solution proposals",
- "tone": "Tech-forward, business, professional, clean",
- "themeMode": "Hybrid theme (dark blue/tech blue cover + light content pages)",
- "keywords": ["Tech blue", "Business", "Solution proposal", "Corporate report"]
- },
- "重庆大学": {
- "label": "Chongqing University Template",
- "summary": "A university-exclusive template for academic defenses and research presentations",
- "tone": "Academically composed, mountain-city essence, modern minimalist",
- "themeMode": "Academic blue primary + mountain-city layered imagery",
- "assets": ["重庆大学logo.png", "重庆大学logo2.png"],
- "keywords": ["Chongqing University", "Academic", "Defense", "University"]
- }
+ "academic_defense": {
+ "label": "Academic Defense Template",
+ "summary": "A standard template for academic defenses, research presentations, and project proposals",
+ "keywords": ["Academic", "Defense", "Research", "Standard"]
+ },
+ "ai_ops": {
+ "label": "Enterprise Digital Intelligence Template",
+ "summary": "For high-density scenarios such as telecom AI operations architecture, IT system overview, and digital transformation plans",
+ "keywords": ["Telecom", "AI operations", "Digital intelligence", "High density", "Architecture view"]
+ },
+ "anthropic": {
+ "label": "Anthropic Style Template",
+ "summary": "A tech-oriented template for AI/LLM knowledge sharing and product launches",
+ "keywords": ["AI", "LLM", "Developer", "Technology"]
+ },
+ "china_telecom_template": {
+ "label": "中国电信模板",
+ "summary": "A China Telecom style template for telecom solution proposals, digital transformation plans, and government-enterprise briefings",
+ "keywords": ["China Telecom", "Telecom", "Digital transformation", "Government-enterprise", "Briefing"]
+ },
+ "exhibit": {
+ "label": "Exhibit Style Template",
+ "summary": "Conclusion-first layout with Exhibit takeaway bars for data-driven strategic reports and executive presentations",
+ "keywords": ["Exhibit", "Board", "Executive", "Strategy", "Conclusion-first"]
+ },
+ "google_style": {
+ "label": "Google Style Template",
+ "summary": "A Google-branded template for annual reports and technical sharing",
+ "keywords": ["Google", "Brand style", "Technical sharing", "Annual report"]
+ },
+ "government_blue": {
+ "label": "Government Blue Template",
+ "summary": "A blue government-themed template for smart governance and digital transformation reports",
+ "keywords": ["Government affairs", "Government blue", "Smart city", "Digitalization"]
+ },
+ "government_red": {
+ "label": "Government Red Template",
+ "summary": "A red government-themed template for government reports and party-building scenarios",
+ "keywords": ["Government affairs", "Party building", "Government red", "Authoritative"]
+ },
+ "mckinsey": {
+ "label": "McKinsey Style Template",
+ "summary": "A McKinsey-style template for strategic consulting and investment analysis",
+ "keywords": ["McKinsey", "Consulting", "Structured", "Executive presentation"]
+ },
+ "medical_university": {
+ "label": "Hospital/Medical University Template",
+ "summary": "A professional template for medical reports, case discussions, and research presentations",
+ "keywords": ["Medical", "Hospital", "Case study", "Research"]
+ },
+ "pixel_retro": {
+ "label": "Pixel Retro Template",
+ "summary": "A pixel-art template for tech sharing and gaming-themed content",
+ "keywords": ["Pixel art", "Retro gaming", "Cyberpunk", "Technology"]
+ },
+ "psychology_attachment": {
+ "label": "Psychology Healing Template",
+ "summary": "A warm and professional template for psychotherapy training and counseling lectures",
+ "keywords": ["Psychology", "Healing", "Counseling", "Warm"]
+ },
+ "smart_red": {
+ "label": "Smart Red-Orange Business Template",
+ "summary": "A vibrant business template for tech company introductions and education solutions",
+ "keywords": ["Red-orange business", "Tech enterprise", "Education", "Vibrant"]
+ },
+ "中国电建_常规": {
+ "label": "PowerChina Standard Template",
+ "summary": "A solid brand template for engineering construction and state-owned enterprise reports",
+ "keywords": ["PowerChina", "State-owned enterprise", "Engineering", "Energy"]
+ },
+ "中国电建_现代": {
+ "label": "PowerChina Modern Template",
+ "summary": "A modern engineering template for major projects and international business presentations",
+ "keywords": ["PowerChina", "International engineering", "Modern engineering", "Technology"]
+ },
+ "中汽研_商务": {
+ "label": "CATARC Business Template",
+ "summary": "A CATARC brand template for certification showcase and high-end business presentations",
+ "keywords": ["CATARC", "Certification", "Business", "Technology"]
+ },
+ "中汽研_常规": {
+ "label": "CATARC Standard Template",
+ "summary": "A standard CATARC template for certification and testing scenarios",
+ "keywords": ["CATARC", "Certification", "Testing", "Authoritative"]
+ },
+ "中汽研_现代": {
+ "label": "CATARC Modern Template",
+ "summary": "A futuristic tech template for cutting-edge technology showcase and premium launches",
+ "keywords": ["CATARC", "Future tech", "Cutting-edge technology", "Launch event"]
+ },
+ "招商银行": {
+ "label": "China Merchants Bank Transaction Banking Template",
+ "summary": "A transaction-banking template for sales collection solutions, product pitches, and branch training",
+ "keywords": ["China Merchants Bank", "Transaction banking", "Sales collection", "Finance", "Training"]
+ },
+ "科技蓝商务": {
+ "label": "Tech Blue Business Template",
+ "summary": "A tech-business template for corporate reports and solution proposals",
+ "keywords": ["Tech blue", "Business", "Solution proposal", "Corporate report"]
+ },
+ "重庆大学": {
+ "label": "Chongqing University Template",
+ "summary": "A university-exclusive template for academic defenses and research presentations",
+ "keywords": ["Chongqing University", "Academic", "Defense", "University"]
}
}
diff --git a/skills/ppt-master/workflows/create-template.md b/skills/ppt-master/workflows/create-template.md
index a2a89cc1..8dfb7a27 100644
--- a/skills/ppt-master/workflows/create-template.md
+++ b/skills/ppt-master/workflows/create-template.md
@@ -35,7 +35,7 @@ Confirm the following with the user:
| Theme color | Optional | Primary color HEX value (can be auto-extracted from reference) |
| Design style | Optional | Additional style notes, decorative language, brand cues |
| Assets list | Optional | Logos / background textures / reference images to include in the template package |
-| Quick lookup tags | Optional | Tags used in `layouts_index.json > quickLookup`, such as `technology`, `finance`, `academic` |
+| Keywords | Yes | 3–5 short tags for `layouts_index.json` lookup (e.g., `McKinsey`, `Consulting`, `Structured`) |
**Required outcome of Step 1**:
@@ -209,17 +209,19 @@ This step is a **hard gate**. Do not register the template into the library inde
## Step 6: Register Template in Library Index
-Update `skills/ppt-master/templates/layouts/layouts_index.json`:
+Add a top-level entry to `skills/ppt-master/templates/layouts/layouts_index.json`. The file is a flat map of `template_id → { label, summary, keywords }`:
-- `meta.total`
-- `meta.updated`
-- the correct `categories.<category>.layouts` entry
-- the appropriate `quickLookup` entries
-- the new `layouts.<template_id>` metadata block
+```json
+"<template_id>": {
+ "label": "<Human-readable Name>",
+ "summary": "<One-sentence description of what this template is for>",
+ "keywords": ["<Tag1>", "<Tag2>", "<Tag3>"]
+}
+```
-`layouts_index.json` is the **source of truth** for template discovery in the main PPT generation workflow. A template directory that is not registered here is considered incomplete.
+`layouts_index.json` is the lightweight lookup used when a user explicitly opts into the template flow. The main workflow defaults to free design and does not read this file unless a template trigger fires (see `SKILL.md` Step 3). A template directory that is not registered here will not be discoverable by that flow.
-If the human-facing `templates/layouts/README.md` summary table is maintained manually, sync it after updating the JSON index. The JSON index takes priority.
+Also sync the summary table in `templates/layouts/README.md` (the human-facing index with categories, primary colors, and detailed tone).
---
@@ -264,6 +266,6 @@ If the human-facing `templates/layouts/README.md` summary table is maintained ma
1. **SVG technical constraints**: See the technical constraints section in [template-designer.md](../references/template-designer.md)
2. **Color consistency**: All SVG files must use the same color scheme
3. **Placeholder convention**: Use `{{}}` format and the canonical new-template placeholder contract above
-4. **Discovery requirement**: New templates must be added to `layouts_index.json`, otherwise the main workflow cannot recommend them
+4. **Discovery requirement**: New templates must be added to `layouts_index.json`, otherwise they will not be discoverable when a user opts into the template flow
> **Detailed specification**: See [template-designer.md](../references/template-designer.md)