conference-talk-builder
Scannednpx machina-cli add skill Microck/ordinary-claude-skills/conference-talk-builder --openclawConference 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:
- Introduction - Current status quo
- Problem Statement - What needs solving
- Exploration - Initial attempts
- Experimentation - Deep investigation
- Solution - The breakthrough
- Challenges - Implementation difficulties
- Apply Knowledge - Integration into project
- 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"
- Gather their experience, main points, and target audience
- Read
story-circle.md - 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
- Read
ia-presenter-syntax.md - Generate markdown slides with proper formatting
- Iterate based on feedback
Source
git clone https://github.com/Microck/ordinary-claude-skills/blob/main/skills_all/conference-talk-builder/SKILL.mdView on GitHub Overview
This skill helps you create conference talk outlines and iA Presenter markdown slides using the Story Circle narrative framework. It maps your content to the eight storytelling steps and generates slide decks that progress from setup to disruption and resolution. It supports iterative refinement based on feedback and formatting best practices.
How This Skill Works
First you gather talk details such as title, topic, audience, and main points. Next you load the Story Circle framework and map content to its eight steps. Finally you generate iA Presenter slides using the required syntax and iterate based on feedback.
When to Use It
- You want to structure a tech talk from concept to outline
- You need Markdown slides formatted for the iA Presenter syntax
- You want to map content into the eight Story Circle steps for a narrative flow
- You want to refine sections, pacing, and code examples after feedback
- You need a complete deck with a title slide, per-step content, and closing resources
Quick Start
- Step 1: Gather talk title, topic, audience, main points, constraints, and a brain dump
- Step 2: Read the Story Circle reference and map content to eight steps
- Step 3: Generate iA Presenter slides and refine based on feedback
Best Practices
- Gather complete talk details before outlining
- Map content to the eight Story Circle steps for a coherent arc
- Break code across slides and use syntax highlighting
- Follow ia-presenter syntax: use --- separators and tabs for slide content
- Iterate with feedback and test on projection conditions
Example Use Cases
- Migrating from JavaScript to TypeScript and presenting the migration strategy
- Structuring a talk about a new tech topic by aligning content with Story Circle steps
- Generating iA Presenter slides from an outline with per-step coverage
- Refining speaker notes and slide formatting after audience feedback
- Demonstrating a real-world problem and the breakthrough solution with lessons learned
