Initial commit

skills/conference-talk-builder/SKILL.md

@@ -0,0 +1,113 @@
+---
+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