conference-talk-builder

name	conference-talk-builder
description	Create conference talk outlines and iA Presenter markdown slides using the Story Circle narrative framework. Use when the user wants to structure a tech talk, create presentation slides, or needs help organizing talk ideas into a story-driven format.

Conference Talk Builder

This skill helps create compelling conference talk outlines and iA Presenter markdown slides using the Story Circle narrative framework.

Process

Follow these steps in order when building a conference talk:

1. Gather Information

Ask the user for:

• Talk title and topic
• Target audience and their expected knowledge level
• Main points they want to cover
• Brain dump of everything they know about the topic
• Problem they're solving or story they're telling
• Any constraints (time limit, specific technologies, etc.)

2. Read the Story Circle Framework

Load references/story-circle.md to understand the eight-step narrative structure.

The framework maps tech talks to:

• Top half: Established practices and order
• Bottom half: Disruption and experimentation

3. Create the Outline

Structure the talk using the eight Story Circle steps:

1. Introduction - Current status quo
2. Problem Statement - What needs solving
3. Exploration - Initial attempts
4. Experimentation - Deep investigation
5. Solution - The breakthrough
6. Challenges - Implementation difficulties
7. Apply Knowledge - Integration into project
8. Results & Insights - Lessons learned

Map the user's content to these steps. Show this outline to the user and refine based on feedback.

4. Generate iA Presenter Slides

Read references/ia-presenter-syntax.md for markdown formatting rules.

Create slides that:

• Use --- to separate slides
• Add tabs (⇥) before content that should be visible on slides
• Leave speaker notes without tabs (spoken text only)
• Include comments with // for reminders
• Format code blocks with proper syntax highlighting
• Keep slides focused on one concept each

Structure the slide deck:

• Title slide
• Introduction slide with your photo/bio
• One or more slides per Story Circle step
• Code examples broken across multiple slides for readability
• Closing slide with contact info and resources

5. Refine and Iterate

After showing the slides:

• Ask if sections need expansion or compression
• Check if code examples need better formatting
• Verify the story flow makes sense
• Adjust based on user feedback

Key Principles

Tell a Story: You don't need to be an expert. Focus on how you approached a problem and solved it.

Keep It Readable: Break code across slides. Use syntax highlighting. Test on bad projectors (consider light themes).

Engage the Audience: Use humor where appropriate. Ask questions. Make eye contact.

Make Follow-up Easy: Include a memorable URL or QR code on the final slide linking to resources.

Bundled Resources

References

• references/story-circle.md - Eight-step Story Circle framework with examples. Read this first to understand the narrative structure.
• references/ia-presenter-syntax.md - Complete iA Presenter markdown syntax reference. Read this when generating slides.

Example Workflow

User: "I want to create a talk about migrating from JavaScript to TypeScript"

1. Gather their experience, main points, and target audience
2. Read story-circle.md
3. Map their content:
   • Introduction: Current JS codebase
   • Problem: Type safety issues and bugs
   • Exploration: Research into TypeScript
   • Experimentation: Pilot conversion on one module
   • Solution: Incremental migration strategy
   • Challenges: Third-party library types
   • Apply Knowledge: Full codebase migration
   • Results: 40% reduction in runtime errors
4. Read ia-presenter-syntax.md
5. Generate markdown slides with proper formatting
6. Iterate based on feedback