| name | technical-presentations |
| description | Create and deliver effective technical presentations, demos, and talks. Provides frameworks for structuring content, designing slides, and handling live demos. |
| allowed-tools | Read, Glob, Grep |
Technical Presentations Skill
Create compelling technical presentations that educate, persuade, and engage developer audiences.
Keywords
presentation, slides, talk, demo, speaking, pitch, architecture review, tech talk, brown bag, lightning talk, conference, meetup, powerpoint, keynote, google slides
When to Use This Skill
This skill provides guidance when developers need to:
- Structure a technical presentation or talk
- Create effective slides for developer audiences
- Plan and execute live demos
- Present architecture decisions or proposals
- Deliver knowledge-sharing sessions
- Pitch technical solutions to stakeholders
Core Framework: What-Why-How
Every technical presentation should follow this structure:
┌─────────────────────────────────────────────────────────────┐
│ WHAT (10% of time) - The Hook │
│ "Here's the problem/opportunity we're addressing" │
├─────────────────────────────────────────────────────────────┤
│ WHY (30% of time) - The Context │
│ "Here's why it matters and why you should care" │
├─────────────────────────────────────────────────────────────┤
│ HOW (50% of time) - The Solution │
│ "Here's how we solve it / how it works" │
├─────────────────────────────────────────────────────────────┤
│ CLOSE (10% of time) - The Call to Action │
│ "Here's what you should do next / key takeaways" │
└─────────────────────────────────────────────────────────────┘
WHAT: The Hook (First 2-3 Minutes)
Goal: Grab attention and establish relevance.
Techniques:
- Start with a problem the audience recognizes
- Open with a surprising statistic or fact
- Ask a provocative question
- Tell a brief story that illustrates the pain
What to avoid:
- "Today I'm going to talk about..."
- Agenda slides before you've hooked them
- Starting with definitions or background
- Apologizing for anything
WHY: The Context (Next 30% of Time)
Goal: Build the case for why this matters.
Include:
- Background that's essential to understanding
- The stakes (what happens if we don't act)
- The opportunity (what's possible)
- Why now (urgency or timing)
Calibrate for audience:
- Technical peers: Less context, more depth
- Mixed audience: More context, less jargon
- Leadership: Business impact focus
HOW: The Solution (Main Body - 50%)
Goal: Deliver the substance.
Structure options:
- Chronological (the journey)
- Problem → Solution → Proof
- Three key points with examples
- Before → Change → After
For technical content:
- Architecture diagrams
- Code examples (simplified)
- Live demos (with backups)
- Metrics and data
CLOSE: The Call to Action (Final 10%)
Goal: Make it stick and drive action.
Include:
- Summary (3 key takeaways max)
- Clear next steps
- Resources for going deeper
- Time for Q&A
Presentation Types
Type 1: Architecture Review / RFC
Purpose: Get feedback on technical approach.
Structure:
- Problem statement (2 min)
- Constraints and requirements (3 min)
- Options considered (5 min)
- Proposed solution (10 min)
- Trade-offs acknowledged (3 min)
- Open questions (2 min)
- Discussion (15+ min)
Keys to success:
- Share materials beforehand
- Focus on decisions, not implementation details
- Explicitly call out what you're NOT doing
- Prepare for tough questions
Type 2: Demo / Walkthrough
Purpose: Show how something works.
Structure:
- What problem this solves (2 min)
- Quick overview (3 min)
- Live demonstration (15-20 min)
- Under the hood (optional, 5-10 min)
- Q&A (5-10 min)
Keys to success:
- Always have a backup (screenshots, video)
- Use realistic but safe data
- Explain what you're doing as you do it
- Have rollback plan for failures
Type 3: Knowledge Share / Brown Bag
Purpose: Teach something useful.
Structure:
- Why this topic matters (3 min)
- Core concepts (10 min)
- Practical application (10 min)
- Gotchas and tips (5 min)
- Resources and Q&A (5 min)
Keys to success:
- Know your audience's level
- Include actionable takeaways
- Provide follow-up resources
- Make it interactive
Type 4: Decision Pitch
Purpose: Get buy-in for a proposal.
Structure:
- The problem/opportunity (3 min)
- Options we considered (5 min)
- Our recommendation (10 min)
- Why this over alternatives (5 min)
- Risk mitigation (3 min)
- Ask for decision/next steps (2 min)
Keys to success:
- Lead with recommendation (don't bury it)
- Anticipate objections
- Have data to support claims
- Be clear about what you're asking for
Slide Design Principles
The Rules
- One idea per slide - If you need "and" in the title, split it
- 5-7 words per bullet - Slides are cues, not scripts
- Visual > Text - Diagrams, screenshots, code
- Consistent design - Same fonts, colors, layouts
- Readable from the back - 24pt minimum for body text
What Works
| Element | Good | Bad |
|---|---|---|
| Titles | Action-oriented, specific | Generic, vague |
| Bullets | Keywords and phrases | Complete sentences |
| Diagrams | Simplified, labeled | Busy, tiny labels |
| Code | Highlighted key lines | Full files |
| Data | One clear point | Multiple charts |
Slide Types
Title slide: Topic, your name, date, context
Agenda slide: Use sparingly, after hook
Content slides: One point with support
Diagram slides: Visual with minimal text
Code slides: Syntax highlighted, key lines marked
Summary slides: 3 key takeaways
Q&A slide: Signal for questions
Live Demo Best Practices
Preparation
- Test everything the morning of
- Have screenshots/video backup
- Use realistic but safe data
- Increase font size (18pt+ for terminal)
- Disable notifications
- Pre-stage browser tabs/windows
- Have recovery plan
Execution
- Narrate what you're doing
- Pause to let audience catch up
- Point out what to look at
- Acknowledge when things go wrong
- Have "get out of jail" plan
When Things Break
- Acknowledge it briefly
- Try one quick fix (30 seconds max)
- If still broken, switch to backup
- Continue with confidence
- Don't apologize excessively
Handling Q&A
Techniques
Repeat the question: Ensures everyone heard and gives you time to think.
Clarify if needed: "Are you asking about X or Y?"
Acknowledge good questions: "That's a great point..."
It's okay to not know: "I don't have the answer to that, but I can find out."
Defer if needed: "That's a bigger topic—let's discuss offline."
Bridge to your message: "That relates to the point about..."
Difficult Questions
| Type | Response |
|---|---|
| Challenge to your approach | "That's a valid concern. Here's how we thought about it..." |
| Out of scope | "Good question—that's outside what we covered. Let's take it offline." |
| Hostile tone | Stay calm, address the content, not the tone |
| Show-off question | "Interesting point. Let me address the practical aspect..." |
| Rambling non-question | "Let me make sure I understand your question..." |
Timing and Pacing
Time Allocation
| Duration | Content | Q&A |
|---|---|---|
| 5-10 min (lightning) | 8 min | None or 2 min |
| 20-30 min (standard) | 20-25 min | 5-10 min |
| 45-60 min (deep dive) | 35-45 min | 10-15 min |
Pacing Tips
- Start strong (don't waste opening minutes)
- Vary energy (not monotone)
- Build to key points
- Use silence strategically
- End on time (or early!)
Practice Routine
- Read-through: Time yourself reading slides aloud
- Talk-through: Practice without looking at slides
- Full run: Present to someone or record yourself
- Cut ruthlessly: If over time, remove content
References
For detailed guidance, see:
references/slide-design-guide.md- Comprehensive slide creation guidancereferences/demo-playbook.md- Live demo preparation and executionreferences/presentation-checklist.md- Pre-presentation preparation list
Related Commands
/soft-skills:structure-presentation- Generate presentation outline/soft-skills:write-cfp- Write conference proposals
Anti-Patterns to Avoid
- Starting with "Today I'm going to talk about..."
- Reading slides verbatim
- Too much text on slides
- Live demos without backup
- Running over time
- Apologizing for content
- Skipping Q&A
- No clear takeaways
Version History
- v1.0.0 (2025-12-26): Initial release
Last Updated
Date: 2025-12-26 Model: claude-opus-4-5-20251101