Pitch Deck Builder
This skill provides a comprehensive workflow for creating professional pitch decks through conversational discovery, narrative structuring, and technical execution with context-aware best practices.
Overview
Creating effective pitch decks requires balancing compelling storytelling with strategic information architecture. This skill guides the process from initial concept through final presentation, with special attention to:
- Conversational discovery to extract key business insights
- Narrative arc construction that resonates with target audiences
- Modern, uncluttered slide design that emphasizes clarity
- Token-aware chunking strategies to prevent context window overflow
- Iterative refinement based on presentation goals
When to Use This Skill
Use this skill when:
- Creating investor pitch decks or fundraising presentations
- Building sales decks or business presentations
- Developing product launch presentations
- Crafting founder or team introductions
- Any scenario requiring strategic narrative presentation of business concepts
Core Workflow
Phase 1: Discovery Interview
CRITICAL: Before creating any slides, conduct a structured discovery interview to understand the pitch requirements. This prevents wasted effort and ensures the final deck aligns with user goals.
The discovery process should be conversational and adaptive, not a rigid questionnaire. Ask 2-3 questions at a time, then build on responses naturally. Focus on understanding the story before collecting details.
Stage 1: Foundation (3-5 questions)
Start with high-level questions to understand the pitch context:
Pitch Type & Audience: "What type of pitch deck are you creating, and who's the primary audience? For example: pre-seed investors, enterprise customers, strategic partners, internal stakeholders, etc."
Core Narrative: "In 2-3 sentences, what's the most compelling story you want to tell? Think about the transformation or opportunity you're presenting."
Stage & Goals: "What stage is your company/product at, and what's your goal for this deck? For example: raising $2M seed round, closing enterprise deals, securing partnerships, etc."
Key Constraints: "Are there any specific constraints I should know about? For example: must be under 15 slides, needs to address specific concerns, follows a particular format, etc."
Stage 2: Business Fundamentals (5-8 questions)
Based on initial responses, dive into the business model and value proposition:
Problem Definition: "Describe the problem you're solving. What pain point exists today, and how acute is it for your target customers?"
Solution Approach: "What's your solution, and why is it uniquely positioned to solve this problem? What's your unfair advantage?"
Market Opportunity: "What's the market size and your addressable segment? Are there any particularly compelling market dynamics or timing factors?"
Business Model: "How do you make money? What are your unit economics or revenue model?"
Traction & Validation: "What traction or validation do you have? This could be revenue, users, partnerships, pilot results, etc."
Competition: "Who are your main competitors or alternatives, and how are you differentiated?"
Stage 3: Narrative Elements (4-6 questions)
Gather the elements needed to craft a compelling narrative:
Founding Story: "Is there a compelling founding story or insight that led to creating this company/product?"
Customer Evidence: "Do you have any customer quotes, case studies, or success stories that illustrate your impact?"
Vision: "What's your long-term vision? Where do you see this in 3-5 years?"
Team: "What makes your team uniquely qualified? Any notable backgrounds, expertise, or relevant achievements?"
Milestones: "What are your key milestones or roadmap items for the next 12-18 months?"
Stage 4: Data & Materials (3-4 questions)
Collect specific data points and existing materials:
Quantitative Data: "What are your key metrics or numbers? For example: revenue, growth rate, user count, retention, CAC/LTV, margins, etc."
Visual Materials: "Do you have any existing materials I should incorporate? For example: logos, brand colors, product screenshots, team photos, existing slides, etc."
Must-Include Elements: "Are there any specific slides, data points, or messages that absolutely must be included?"
Context Window Management Strategy
BEFORE proceeding to Phase 2, assess the context implications:
Calculate estimated token usage:
- Discovery interview: ~2,000-4,000 tokens
- Narrative planning: ~1,500-3,000 tokens
- Slide content creation: ~500-800 tokens per slide
- Technical execution: ~3,000-5,000 tokens
- Base overhead: ~2,000 tokens
Identify chunking needs:
- If deck > 15 slides: STRONGLY RECOMMEND chunking strategy
- If deck > 20 slides: REQUIRE chunking strategy
- If user provides extensive existing content: Consider chunking
Propose chunking approach (if needed):
"Based on your requirements, we're looking at approximately [X] slides. To maintain quality and avoid context constraints, I recommend we build this deck in [2-3] phases:
- Phase 1: Opening slides (Cover, Problem, Solution, Product) - slides 1-[X]
- Phase 2: Business slides (Market, Business Model, Traction, Competition) - slides [X]-[Y]
- Phase 3: Closing slides (Team, Financials, Milestones, Ask) - slides [Y]-[Z]
We'll create each phase completely, then combine them at the end. This ensures every slide gets proper attention and design quality. Does this approach work for you?"
Document phase boundaries: If using chunking, clearly document in narrative plan which slides belong to which phase
Phase 2: Narrative Planning
After completing discovery, create a detailed narrative plan that serves as the blueprint for the deck.
Step 1: Determine Slide Sequence
Based on pitch type and discovery insights, recommend an appropriate slide sequence. Common structures:
Standard Investor Pitch (12-15 slides):
- Cover slide (Company name, tagline, contact)
- Problem (The pain point)
- Solution (Your approach)
- Product/Demo (How it works)
- Market Opportunity (TAM/SAM/SOM)
- Business Model (Revenue streams)
- Traction (Metrics, growth)
- Competition (Landscape, differentiation)
- Go-to-Market (Distribution, customer acquisition)
- Team (Founders, key hires)
- Financials (Projections, unit economics)
- Milestones (12-18 month roadmap)
- Funding Ask (Amount, use of funds)
- Vision (Long-term impact)
- Contact/Thank You
Product Pitch (8-12 slides):
- Cover
- Problem
- Solution Overview
- Product Details/Demo
- Benefits & ROI
- Customer Success Stories
- Competitive Advantage
- Pricing/Packages
- Implementation
- Team/Company
- Next Steps
- Contact
CRITICAL: Adapt the sequence based on discovery insights. If the user has exceptional traction, move that slide earlier. If the team is the strongest asset, elevate it. The narrative should build momentum toward the most compelling elements.
Step 2: Create Detailed Content Outline
For each slide, document:
- Slide title: Clear, assertive statement (not generic labels)
- Core message: The single most important point this slide must convey
- Supporting points: 2-4 key facts, data points, or arguments (bullet form)
- Visual strategy: How this slide should be visually presented
- Speaker notes: 1-3 sentences the presenter should say about this slide
- Data requirements: Specific numbers, percentages, or facts needed
Example outline entry:
Slide 7: "We've Grown 40% Month-Over-Month for 6 Months"
Core message: Our consistent growth demonstrates product-market fit and validates our approach
Supporting points:
- 10,000+ active users, up from 500 six months ago
- 85% of users remain active after 30 days (industry benchmark: 25%)
- NPS score of 72 (promoter-heavy user base)
- Zero paid marketing spend - all organic and referral growth
Visual strategy: Large growth chart showing MoM trajectory, with key metrics callouts around it
Speaker notes: "This isn't a spike - it's sustained, compounding growth driven by genuine product love. Our users are becoming our sales team, and retention numbers show they're staying because we're solving a real problem for them."
Data requirements: Monthly user count for last 6 months, retention cohort data, NPS score
Step 3: Validate Narrative Arc
Review the complete outline and validate:
- Opening strength: Do the first 3 slides hook attention and establish credibility?
- Logical flow: Does each slide build naturally to the next?
- Peak placement: Is the strongest material positioned for maximum impact (typically slides 6-9)?
- Emotional resonance: Are there moments of human connection (customer stories, founding insight, vision)?
- Objection handling: Are likely concerns addressed before they become barriers?
- Clear ask: Is the call-to-action unambiguous and compelling?
Present the complete narrative outline to the user for approval before proceeding to design. Make it easy to review by presenting in a clear, scannable format.
Phase 3: Design & Technical Execution
Once the narrative plan is approved, execute the technical creation using the pptx skill and html2pptx workflow.
Design Principles
CRITICAL: Pitch decks must balance professionalism with visual impact. Follow these principles:
Whitespace is strategic: Each slide should have 40-60% whitespace. Crowded slides lose impact.
One idea per slide: If a slide tries to communicate multiple ideas, split it into multiple slides.
Typography hierarchy:
- Headlines: Large (36-48pt), bold, assertive statements
- Body text: Readable (18-24pt), limited to 3-5 bullets maximum
- Data callouts: Extra large (48-72pt) for key numbers
- Avoid paragraphs: Use bullet points, but even better - use short phrases
Color strategy:
- Primary: Brand color for key elements and data visualization
- Accent: Complementary color for highlights and emphasis
- Neutral: Dark gray (not black) for body text, light gray for backgrounds
- Limit palette to 3-4 colors total
Data visualization:
- Prefer charts over tables when showing trends
- Use large, simple charts with clear labels
- Highlight the key insight (annotate charts with the "so what?")
- Remove chart junk - no 3D effects, excessive gridlines, or decorative elements
Layout patterns:
- Full-bleed: Image or color background with text overlay (cover, section dividers)
- Two-column: Text on left, visual on right (most content slides)
- Centered: Single key message or data point (impact slides)
- Grid: Multiple items of equal importance (team, customers, features)
Technical Implementation
IMPORTANT: Read /mnt/skills/public/pptx/SKILL.md completely before beginning slide creation. The pptx skill contains critical requirements for html2pptx workflow.
Follow this execution sequence:
Read pptx skill documentation: view /mnt/skills/public/pptx/SKILL.md (no range limits - read entire file)
Read html2pptx documentation: view /mnt/skills/public/pptx/html2pptx.md (no range limits - read entire file)
Install html2pptx if needed: Verify installation with npm list -g @ant/html2pptx and install if necessary
Create shared CSS file: Define CSS variables for colors, typography, and spacing that will be used across all slides
Create HTML files for each slide:
- Use proper dimensions (960px × 540px for 16:9)
- Embed shared CSS in
<style> tags
- Use semantic HTML (
<h1>, <p>, <ul>, etc.)
- Use row/col/fit classes for layout (NOT flexbox)
- Apply CSS variables consistently
- Include
class="placeholder" for chart/table areas
Create conversion script: Write JavaScript to convert HTML to PPTX using html2pptx library and PptxGenJS
Execute and validate: Run the conversion script and generate thumbnail grid for visual validation
Iterate if needed: Fix any layout issues, text overflow, or visual problems identified in thumbnails
Chunking Execution Strategy
If using a multi-phase approach (recommended for >15 slides):
Phase execution:
- Build Phase 1 completely (HTML + PPTX generation + validation)
- Save Phase 1 output to
/mnt/user-data/outputs/
- Begin new conversation or clear context
- Load Phase 1 PPTX and narrative plan
- Build Phase 2 (append to existing PPTX)
- Repeat for remaining phases
Phase handoff checklist:
Combination approach:
- After all phases complete, combine using Python-PPTX or manual merge
- Validate slide numbering and transitions
- Generate final thumbnail grid
- Check for design consistency across all slides
Phase 4: Refinement & Delivery
After initial creation, support iterative improvement:
Visual review: Generate and examine thumbnail grid for layout issues
Content refinement: Offer to adjust messaging, data presentation, or narrative flow based on feedback
Design iteration: Make styling adjustments, color changes, or layout modifications
Export preparation: Ensure final PPTX is in /mnt/user-data/outputs/ with clear filename
Usage guidance: Provide brief tips for presenting the deck effectively
Best Practices
Discovery Quality
- Listen more than prescribe - let the user's story emerge naturally
- Ask "why" and "so what" to uncover deeper insights
- Notice what the user emphasizes - these are often the strongest narrative elements
- Validate understanding by reflecting back key points
Narrative Construction
- Start with why, not what - establish emotional connection before details
- Use assertive slide titles that make claims, not generic labels ("We're Growing 40% Monthly" not "Traction")
- Place the strongest material in the middle third of the deck (slides 6-9 in a 15-slide deck)
- End with clarity on the ask and vision for impact
Design Execution
- When in doubt, remove elements rather than add them
- Use data visualization to replace bullet points whenever possible
- Test readability by viewing slides at thumbnail size - key points should still be clear
- Maintain consistent spacing, alignment, and typography throughout
Context Management
- Propose chunking early if deck will exceed 15 slides
- Document design decisions in CSS comments for phase consistency
- Save phase outputs immediately to prevent context loss
- Keep narrative plan accessible across phases
Common Pitch Deck Types
Investor Pitch (Pre-Seed/Seed)
- Focus: Team, problem, early traction
- Length: 12-15 slides
- Tone: Ambitious but realistic, founder-driven
- Key slides: Problem, solution, why now, founding story, early metrics
Investor Pitch (Series A+)
- Focus: Growth metrics, business model, competitive moats
- Length: 15-18 slides
- Tone: Data-driven, scalable, market-leading
- Key slides: Growth charts, unit economics, competitive landscape, market expansion
Sales/Product Pitch
- Focus: Customer value, ROI, implementation
- Length: 10-15 slides
- Tone: Customer-centric, benefit-oriented, practical
- Key slides: Problem/pain point, solution benefits, customer success, pricing, next steps
Partnership Pitch
- Focus: Strategic alignment, mutual value, capabilities
- Length: 8-12 slides
- Tone: Collaborative, strategic, win-win
- Key slides: Company overview, strategic fit, proposed partnership model, case for collaboration
References
For additional guidance on pitch deck best practices, narrative construction, and data visualization, see:
references/pitch-deck-best-practices.md - Comprehensive guide to effective pitch decks
references/data-visualization-guide.md - Chart types, design patterns, and storytelling with data
references/narrative-frameworks.md - Story structures and persuasion techniques
Technical Dependencies
This skill leverages the pptx skill for presentation creation. Ensure the following are available:
- pptx skill at
/mnt/skills/public/pptx/
- html2pptx library (installed via npm)
- python-pptx and related dependencies
All technical execution should follow the workflows documented in /mnt/skills/public/pptx/SKILL.md.
1---2name: pitch-deck-builder-23description: Comprehensive pitch deck creation with conversational discovery, narrative structuring, and context-aware chunking strategies. This skill should be used when users request help creating pitch decks, investor presentations, fundraising decks, or startup presentations. It guides through narrative development, data collection, and professional slide creation.4license: MIT5---6
7# Pitch Deck Builder
8
9This skill provides a comprehensive workflow for creating professional pitch decks through conversational discovery, narrative structuring, and technical execution with context-aware best practices.
10
11## Overview
12
13Creating effective pitch decks requires balancing compelling storytelling with strategic information architecture. This skill guides the process from initial concept through final presentation, with special attention to:
14
15- Conversational discovery to extract key business insights
16- Narrative arc construction that resonates with target audiences
17- Modern, uncluttered slide design that emphasizes clarity
18- Token-aware chunking strategies to prevent context window overflow
19- Iterative refinement based on presentation goals
20
21## When to Use This Skill
22
23Use this skill when:
24- Creating investor pitch decks or fundraising presentations
25- Building sales decks or business presentations
26- Developing product launch presentations
27- Crafting founder or team introductions
28- Any scenario requiring strategic narrative presentation of business concepts
29
30## Core Workflow
31
32### Phase 1: Discovery Interview
33
34**CRITICAL**: Before creating any slides, conduct a structured discovery interview to understand the pitch requirements. This prevents wasted effort and ensures the final deck aligns with user goals.
35
36The discovery process should be conversational and adaptive, not a rigid questionnaire. Ask 2-3 questions at a time, then build on responses naturally. Focus on understanding the story before collecting details.
37
38#### Stage 1: Foundation (3-5 questions)
39
40Start with high-level questions to understand the pitch context:
41
421. **Pitch Type & Audience**: "What type of pitch deck are you creating, and who's the primary audience? For example: pre-seed investors, enterprise customers, strategic partners, internal stakeholders, etc."
43
442. **Core Narrative**: "In 2-3 sentences, what's the most compelling story you want to tell? Think about the transformation or opportunity you're presenting."
45
463. **Stage & Goals**: "What stage is your company/product at, and what's your goal for this deck? For example: raising $2M seed round, closing enterprise deals, securing partnerships, etc."
47
484. **Key Constraints**: "Are there any specific constraints I should know about? For example: must be under 15 slides, needs to address specific concerns, follows a particular format, etc."
49
50#### Stage 2: Business Fundamentals (5-8 questions)
51
52Based on initial responses, dive into the business model and value proposition:
53
541. **Problem Definition**: "Describe the problem you're solving. What pain point exists today, and how acute is it for your target customers?"
55
562. **Solution Approach**: "What's your solution, and why is it uniquely positioned to solve this problem? What's your unfair advantage?"
57
583. **Market Opportunity**: "What's the market size and your addressable segment? Are there any particularly compelling market dynamics or timing factors?"
59
604. **Business Model**: "How do you make money? What are your unit economics or revenue model?"
61
625. **Traction & Validation**: "What traction or validation do you have? This could be revenue, users, partnerships, pilot results, etc."
63
646. **Competition**: "Who are your main competitors or alternatives, and how are you differentiated?"
65
66#### Stage 3: Narrative Elements (4-6 questions)
67
68Gather the elements needed to craft a compelling narrative:
69
701. **Founding Story**: "Is there a compelling founding story or insight that led to creating this company/product?"
71
722. **Customer Evidence**: "Do you have any customer quotes, case studies, or success stories that illustrate your impact?"
73
743. **Vision**: "What's your long-term vision? Where do you see this in 3-5 years?"
75
764. **Team**: "What makes your team uniquely qualified? Any notable backgrounds, expertise, or relevant achievements?"
77
785. **Milestones**: "What are your key milestones or roadmap items for the next 12-18 months?"
79
80#### Stage 4: Data & Materials (3-4 questions)
81
82Collect specific data points and existing materials:
83
841. **Quantitative Data**: "What are your key metrics or numbers? For example: revenue, growth rate, user count, retention, CAC/LTV, margins, etc."
85
862. **Visual Materials**: "Do you have any existing materials I should incorporate? For example: logos, brand colors, product screenshots, team photos, existing slides, etc."
87
883. **Must-Include Elements**: "Are there any specific slides, data points, or messages that absolutely must be included?"
89
90#### Context Window Management Strategy
91
92**BEFORE proceeding to Phase 2**, assess the context implications:
93
941. **Calculate estimated token usage**:
95 - Discovery interview: ~2,000-4,000 tokens
96 - Narrative planning: ~1,500-3,000 tokens
97 - Slide content creation: ~500-800 tokens per slide
98 - Technical execution: ~3,000-5,000 tokens
99 - Base overhead: ~2,000 tokens
100
1012. **Identify chunking needs**:
102 - If deck > 15 slides: **STRONGLY RECOMMEND** chunking strategy
103 - If deck > 20 slides: **REQUIRE** chunking strategy
104 - If user provides extensive existing content: Consider chunking
105
1063. **Propose chunking approach** (if needed):
107 "Based on your requirements, we're looking at approximately [X] slides. To maintain quality and avoid context constraints, I recommend we build this deck in [2-3] phases:
108
109 - **Phase 1**: Opening slides (Cover, Problem, Solution, Product) - slides 1-[X]
110 - **Phase 2**: Business slides (Market, Business Model, Traction, Competition) - slides [X]-[Y]
111 - **Phase 3**: Closing slides (Team, Financials, Milestones, Ask) - slides [Y]-[Z]
112
113 We'll create each phase completely, then combine them at the end. This ensures every slide gets proper attention and design quality. Does this approach work for you?"
114
1154. **Document phase boundaries**: If using chunking, clearly document in narrative plan which slides belong to which phase
116
117### Phase 2: Narrative Planning
118
119After completing discovery, create a detailed narrative plan that serves as the blueprint for the deck.
120
121#### Step 1: Determine Slide Sequence
122
123Based on pitch type and discovery insights, recommend an appropriate slide sequence. Common structures:
124
125**Standard Investor Pitch (12-15 slides)**:
1261. Cover slide (Company name, tagline, contact)
1272. Problem (The pain point)
1283. Solution (Your approach)
1294. Product/Demo (How it works)
1305. Market Opportunity (TAM/SAM/SOM)
1316. Business Model (Revenue streams)
1327. Traction (Metrics, growth)
1338. Competition (Landscape, differentiation)
1349. Go-to-Market (Distribution, customer acquisition)
13510. Team (Founders, key hires)
13611. Financials (Projections, unit economics)
13712. Milestones (12-18 month roadmap)
13813. Funding Ask (Amount, use of funds)
13914. Vision (Long-term impact)
14015. Contact/Thank You
141
142**Product Pitch (8-12 slides)**:
1431. Cover
1442. Problem
1453. Solution Overview
1464. Product Details/Demo
1475. Benefits & ROI
1486. Customer Success Stories
1497. Competitive Advantage
1508. Pricing/Packages
1519. Implementation
15210. Team/Company
15311. Next Steps
15412. Contact
155
156**CRITICAL**: Adapt the sequence based on discovery insights. If the user has exceptional traction, move that slide earlier. If the team is the strongest asset, elevate it. The narrative should build momentum toward the most compelling elements.
157
158#### Step 2: Create Detailed Content Outline
159
160For each slide, document:
161
1621. **Slide title**: Clear, assertive statement (not generic labels)
1632. **Core message**: The single most important point this slide must convey
1643. **Supporting points**: 2-4 key facts, data points, or arguments (bullet form)
1654. **Visual strategy**: How this slide should be visually presented
1665. **Speaker notes**: 1-3 sentences the presenter should say about this slide
1676. **Data requirements**: Specific numbers, percentages, or facts needed
168
169Example outline entry:
170```
171Slide 7: "We've Grown 40% Month-Over-Month for 6 Months"
172
173Core message: Our consistent growth demonstrates product-market fit and validates our approach
174
175Supporting points:
176- 10,000+ active users, up from 500 six months ago
177- 85% of users remain active after 30 days (industry benchmark: 25%)
178- NPS score of 72 (promoter-heavy user base)
179- Zero paid marketing spend - all organic and referral growth
180
181Visual strategy: Large growth chart showing MoM trajectory, with key metrics callouts around it
182
183Speaker notes: "This isn't a spike - it's sustained, compounding growth driven by genuine product love. Our users are becoming our sales team, and retention numbers show they're staying because we're solving a real problem for them."
184
185Data requirements: Monthly user count for last 6 months, retention cohort data, NPS score
186```
187
188#### Step 3: Validate Narrative Arc
189
190Review the complete outline and validate:
191
1921. **Opening strength**: Do the first 3 slides hook attention and establish credibility?
1932. **Logical flow**: Does each slide build naturally to the next?
1943. **Peak placement**: Is the strongest material positioned for maximum impact (typically slides 6-9)?
1954. **Emotional resonance**: Are there moments of human connection (customer stories, founding insight, vision)?
1965. **Objection handling**: Are likely concerns addressed before they become barriers?
1976. **Clear ask**: Is the call-to-action unambiguous and compelling?
198
199Present the complete narrative outline to the user for approval before proceeding to design. Make it easy to review by presenting in a clear, scannable format.
200
201### Phase 3: Design & Technical Execution
202
203Once the narrative plan is approved, execute the technical creation using the pptx skill and html2pptx workflow.
204
205#### Design Principles
206
207**CRITICAL**: Pitch decks must balance professionalism with visual impact. Follow these principles:
208
2091. **Whitespace is strategic**: Each slide should have 40-60% whitespace. Crowded slides lose impact.
210
2112. **One idea per slide**: If a slide tries to communicate multiple ideas, split it into multiple slides.
212
2133. **Typography hierarchy**:
214 - Headlines: Large (36-48pt), bold, assertive statements
215 - Body text: Readable (18-24pt), limited to 3-5 bullets maximum
216 - Data callouts: Extra large (48-72pt) for key numbers
217 - Avoid paragraphs: Use bullet points, but even better - use short phrases
218
2194. **Color strategy**:
220 - Primary: Brand color for key elements and data visualization
221 - Accent: Complementary color for highlights and emphasis
222 - Neutral: Dark gray (not black) for body text, light gray for backgrounds
223 - Limit palette to 3-4 colors total
224
2255. **Data visualization**:
226 - Prefer charts over tables when showing trends
227 - Use large, simple charts with clear labels
228 - Highlight the key insight (annotate charts with the "so what?")
229 - Remove chart junk - no 3D effects, excessive gridlines, or decorative elements
230
2316. **Layout patterns**:
232 - Full-bleed: Image or color background with text overlay (cover, section dividers)
233 - Two-column: Text on left, visual on right (most content slides)
234 - Centered: Single key message or data point (impact slides)
235 - Grid: Multiple items of equal importance (team, customers, features)
236
237#### Technical Implementation
238
239**IMPORTANT**: Read `/mnt/skills/public/pptx/SKILL.md` completely before beginning slide creation. The pptx skill contains critical requirements for html2pptx workflow.
240
241Follow this execution sequence:
242
2431. **Read pptx skill documentation**: `view /mnt/skills/public/pptx/SKILL.md` (no range limits - read entire file)
244
2452. **Read html2pptx documentation**: `view /mnt/skills/public/pptx/html2pptx.md` (no range limits - read entire file)
246
2473. **Install html2pptx if needed**: Verify installation with `npm list -g @ant/html2pptx` and install if necessary
248
2494. **Create shared CSS file**: Define CSS variables for colors, typography, and spacing that will be used across all slides
250
2515. **Create HTML files for each slide**:
252 - Use proper dimensions (960px × 540px for 16:9)
253 - Embed shared CSS in `<style>` tags
254 - Use semantic HTML (`<h1>`, `<p>`, `<ul>`, etc.)
255 - Use row/col/fit classes for layout (NOT flexbox)
256 - Apply CSS variables consistently
257 - Include `class="placeholder"` for chart/table areas
258
2596. **Create conversion script**: Write JavaScript to convert HTML to PPTX using html2pptx library and PptxGenJS
260
2617. **Execute and validate**: Run the conversion script and generate thumbnail grid for visual validation
262
2638. **Iterate if needed**: Fix any layout issues, text overflow, or visual problems identified in thumbnails
264
265#### Chunking Execution Strategy
266
267If using a multi-phase approach (recommended for >15 slides):
268
2691. **Phase execution**:
270 - Build Phase 1 completely (HTML + PPTX generation + validation)
271 - Save Phase 1 output to `/mnt/user-data/outputs/`
272 - Begin new conversation or clear context
273 - Load Phase 1 PPTX and narrative plan
274 - Build Phase 2 (append to existing PPTX)
275 - Repeat for remaining phases
276
2772. **Phase handoff checklist**:
278 - [ ] Save phase PPTX file to outputs
279 - [ ] Save narrative plan for next phase
280 - [ ] Save CSS file for design consistency
281 - [ ] Document any design decisions or patterns established
282 - [ ] Note current slide number for next phase
283
2843. **Combination approach**:
285 - After all phases complete, combine using Python-PPTX or manual merge
286 - Validate slide numbering and transitions
287 - Generate final thumbnail grid
288 - Check for design consistency across all slides
289
290### Phase 4: Refinement & Delivery
291
292After initial creation, support iterative improvement:
293
2941. **Visual review**: Generate and examine thumbnail grid for layout issues
295
2962. **Content refinement**: Offer to adjust messaging, data presentation, or narrative flow based on feedback
297
2983. **Design iteration**: Make styling adjustments, color changes, or layout modifications
299
3004. **Export preparation**: Ensure final PPTX is in `/mnt/user-data/outputs/` with clear filename
301
3025. **Usage guidance**: Provide brief tips for presenting the deck effectively
303
304## Best Practices
305
306### Discovery Quality
307- Listen more than prescribe - let the user's story emerge naturally
308- Ask "why" and "so what" to uncover deeper insights
309- Notice what the user emphasizes - these are often the strongest narrative elements
310- Validate understanding by reflecting back key points
311
312### Narrative Construction
313- Start with why, not what - establish emotional connection before details
314- Use assertive slide titles that make claims, not generic labels ("We're Growing 40% Monthly" not "Traction")
315- Place the strongest material in the middle third of the deck (slides 6-9 in a 15-slide deck)
316- End with clarity on the ask and vision for impact
317
318### Design Execution
319- When in doubt, remove elements rather than add them
320- Use data visualization to replace bullet points whenever possible
321- Test readability by viewing slides at thumbnail size - key points should still be clear
322- Maintain consistent spacing, alignment, and typography throughout
323
324### Context Management
325- Propose chunking early if deck will exceed 15 slides
326- Document design decisions in CSS comments for phase consistency
327- Save phase outputs immediately to prevent context loss
328- Keep narrative plan accessible across phases
329
330## Common Pitch Deck Types
331
332### Investor Pitch (Pre-Seed/Seed)
333- Focus: Team, problem, early traction
334- Length: 12-15 slides
335- Tone: Ambitious but realistic, founder-driven
336- Key slides: Problem, solution, why now, founding story, early metrics
337
338### Investor Pitch (Series A+)
339- Focus: Growth metrics, business model, competitive moats
340- Length: 15-18 slides
341- Tone: Data-driven, scalable, market-leading
342- Key slides: Growth charts, unit economics, competitive landscape, market expansion
343
344### Sales/Product Pitch
345- Focus: Customer value, ROI, implementation
346- Length: 10-15 slides
347- Tone: Customer-centric, benefit-oriented, practical
348- Key slides: Problem/pain point, solution benefits, customer success, pricing, next steps
349
350### Partnership Pitch
351- Focus: Strategic alignment, mutual value, capabilities
352- Length: 8-12 slides
353- Tone: Collaborative, strategic, win-win
354- Key slides: Company overview, strategic fit, proposed partnership model, case for collaboration
355
356## References
357
358For additional guidance on pitch deck best practices, narrative construction, and data visualization, see:
359- `references/pitch-deck-best-practices.md` - Comprehensive guide to effective pitch decks
360- `references/data-visualization-guide.md` - Chart types, design patterns, and storytelling with data
361- `references/narrative-frameworks.md` - Story structures and persuasion techniques
362
363## Technical Dependencies
364
365This skill leverages the pptx skill for presentation creation. Ensure the following are available:
366- pptx skill at `/mnt/skills/public/pptx/`
367- html2pptx library (installed via npm)
368- python-pptx and related dependencies
369
370All technical execution should follow the workflows documented in `/mnt/skills/public/pptx/SKILL.md`.