majiayu000 Slidev Real-time Feedback Skill
Transform your Slidev presentations into interactive experiences with real-time audience feedback and reactions.
Instructions
This skill creates a real-time feedback system for Slidev presentations. When imported:
- Configure your presentation details (title, slide count, allowed reactions)
- Deploy the skill to generate a unique widget URL and QR code
- Embed the widget in your Slidev presentation or share the URL with your audience
- Monitor live reactions and questions through the presenter dashboard
- Export analytics after your presentation for detailed insights
The skill uses WebSocket-powered Durable Objects for real-time synchronization between presenter and audience. All configuration is done through the 8 parameters defined in the frontmatter above.
Overview
The Slidev Real-time Feedback skill enables presenters to gather live reactions, questions, and engagement metrics from their audience during presentations. Built on Cloudflare Durable Objects for scalable real-time performance, this skill provides instant feedback loops that help presenters adjust their delivery on the fly.
Features
✨ Real-time Audience Engagement
- Live Emoji Reactions: Customizable emoji reactions for instant audience sentiment
- Question Submission: Allow audience to ask questions without interrupting
- Slide Synchronization: Automatic slide tracking for contextual feedback
- Participant Counter: See how many people are actively engaged
📊 Presenter Dashboard
- Live Reaction View: See reactions as they happen, organized by slide
- Question Management: Review, moderate, and respond to audience questions
- Analytics Export: Download detailed engagement data for post-presentation analysis
- Navigation Controls: Control slide progression and pause for Q&A
🎨 Embeddable Widget
- Responsive Design: Works on any device - desktop, tablet, or mobile
- Theme Support: Light, dark, and auto themes to match your presentation
- QR Code Access: Generate QR codes for easy audience access
- Anonymous or Authenticated: Choose whether to require login
🔒 Enterprise Features
- Question Moderation: Review questions before displaying to audience
- Session Timeouts: Auto-close sessions after a specified duration
- Access Control: Require authentication for sensitive presentations
- Data Privacy: All data stored securely with automatic cleanup
How It Works
For Presenters (Dashboard Mode)
- Create Session: Configure your presentation details and allowed reactions
- Share Widget: Get an embed code or QR code to share with your audience
- Monitor Feedback: Watch reactions and questions appear in real-time
- Control Flow: Navigate slides and moderate content as needed
- Export Data: Download analytics for future reference
For Audience (Embedded Widget Mode)
- Scan QR Code: Access the feedback widget on any device
- React to Slides: Tap emoji reactions to provide instant feedback
- Ask Questions: Submit text questions without interrupting
- Stay Synced: Widget automatically updates with current slide
- See Engagement: View how many others are participating
Use Cases
📚 Educational Lectures
- Student Comprehension: Quick polls on understanding ("Got it" vs "Confused")
- Pace Control: Adjust speed based on real-time feedback
- Question Queue: Organize student questions by topic/slide
💼 Business Presentations
- Stakeholder Engagement: Gauge executive interest and concerns
- Sales Demos: Capture prospect reactions to different features
- Training Sessions: Check understanding and collect improvement feedback
🎤 Conference Talks
- Large Audiences: Scalable to hundreds of simultaneous participants
- Engagement Metrics: Identify which slides resonate most
- Q&A Management: Organize questions for post-talk sessions
🧪 Research Presentations
- Peer Feedback: Collect colleague reactions to methodology
- Interest Tracking: Identify which findings generate most interest
- Collaboration: Facilitate discussion in virtual or hybrid settings
Technical Architecture
Real-time Infrastructure
┌─────────────┐ WebSocket ┌──────────────────┐
│ Presenter │◄──────────────────────────►│ │
│ Dashboard │ │ Durable Object │
└─────────────┘ │ (Persistent │
│ State) │
┌─────────────┐ WebSocket │ │
│ Audience │◄──────────────────────────►│ │
│ Widget │ └──────────────────┘
└─────────────┘
Durable Object Benefits:
- Single source of truth for session state
- Automatic connection management
- Built-in WebSocket handling
- Global low-latency access
- Persistent across restarts
Data Flow
- Presenter creates session → Durable Object instance spawned
- Audience joins → WebSocket connection established
- Reactions submitted → Broadcast to all connected clients
- Slide changes → Synchronized across all participants
- Session ends → Data exported, connections gracefully closed
Configuration Examples
Common Configurations:
- Workshop/Training: Enable questions, moderate if needed, 2-hour auto-close, reactions like ✅❓💡
- Business Presentation: Require auth, moderate questions, professional reactions like 👍💼📊
- Conference Talk: Disable questions (use Q&A later), open access, engaging reactions like ❤️🔥🚀
All parameters are configured through the widget creation interface. See the 8 parameters in the frontmatter above for full customization options.
Analytics & Insights
What You Can Track
- Engagement Rate: Reactions per slide
- Peak Interest: Slides with most reactions
- Audience Size: Participant count over time
- Question Themes: Common topics and concerns
- Session Duration: Actual vs planned timing
- Reaction Distribution: Sentiment analysis per slide
Export Formats
- JSON (full data export)
- CSV (spreadsheet analysis)
- Analytics Dashboard (visual charts)
Security & Privacy
Data Protection
- ✅ Anonymous participation by default
- ✅ Optional authentication for sensitive content
- ✅ No personal data stored without consent
- ✅ Automatic data cleanup after session
- ✅ Encrypted WebSocket connections
- ✅ GDPR compliant
Access Control
- Session-based tokens for anonymous users
- Email verification for authenticated sessions
- Presenter-only access to raw data
- Public analytics opt-in
Installation
Import from GitHub
- Go to "Add Skill" in your Amagen dashboard
- Select "Import from GitHub"
- Enter repository URL:
https://github.com/amagen-skill-exchange/slidev-feedback-skill - Click "Import Skill"
Create Widget (10 Credits)
- Navigate to "My Skills"
- Find "Slidev Real-time Feedback"
- Click "Create Widget"
- Configure presentation settings
- Get embed code and QR code
Integration
After creating a widget, you'll receive:
- Widget URL:
https://widgets.amagen.app/widget/YOUR_WIDGET_ID - QR Code: For easy mobile access
- Embed Code: Ready-to-use iframe snippet
Quick Embed (works in Slidev, HTML, or any webpage):
<iframe src="https://widgets.amagen.app/widget/YOUR_WIDGET_ID"
width="400" height="600" frameborder="0">
</iframe>
Share the widget URL or display the QR code during your presentation for audience access.
Support & Resources
License
MIT License - See LICENSE file for details
Credits
Built with:
- Cloudflare Durable Objects - Real-time infrastructure
- React - UI framework
- TypeScript - Type safety
- Zod - Schema validation
- @amagen/ui - Component library
Created by the Amagen Skill Exchange community.