Demo Video Script: PM Tools Templates Quick Start
Guides recording a 2:45 demo video that walks first-time visitors through template selection and basic usage of the PM Tools Templates repository.
What this file does
Guides recording a 2:45 demo video that walks first-time visitors through template selection and basic usage of the PM Tools Templates repository.
When to use it
- You need a short demo video for a GitHub project with interactive onboarding
- You want a structured script and recording checklist for a product walkthrough
- You plan to embed a video in GitHub Pages and need hosting and embedding guidance
Assumes this stack
Demo Video Script: PM Tools Templates Quick Start
Target Length: 2 minutes 45 seconds
Audience: First-time visitors and new users
Purpose: Show template selection and basic usage
Video Outline
Opening (0:00 - 0:15)
Scene: GitHub repository homepage
Voiceover: "Welcome to PM Tools Templates - your comprehensive project management toolkit. In under 3 minutes, I'll show you how to find and use the perfect template for your project."
Actions:
- Show repository main page
- Highlight star count and key features
- Scroll to show organized structure
Template Discovery (0:15 - 1:00)
Scene: Interactive onboarding launch
Voiceover: "Let's start with our Interactive Onboarding Experience. This guides you to the right templates based on your specific needs."
Actions:
- Run:
node ecosystem-gateway.js - Select "Start Interactive Onboarding"
- Quick demo of profile questions:
- Experience level: "Some experience (2-4 years)"
- Project type: "Software/IT Development"
- Team size: "Small team (2-5 people)"
- Methodology: "Agile/Scrum"
Template Recommendations (1:00 - 1:45)
Scene: AI-powered recommendations
Voiceover: "Based on your profile, our AI recommends these templates. Notice how each recommendation explains why it's perfect for your situation."
Actions:
- Show personalized template recommendations
- Highlight the "why" explanations
- Demonstrate template selection process
- Show direct links to recommended templates
Template Usage (1:45 - 2:30)
Scene: Using a selected template
Voiceover: "Let's see a template in action. Here's how you'd use the Sprint Planning Template."
Actions:
- Open Sprint Planning Template
- Show the blank template structure
- Switch to completed example
- Highlight key sections and how to fill them out
- Show the before/after comparison
Resources & Next Steps (2:30 - 2:45)
Scene: Additional resources
Voiceover: "Need more help? Check out our getting started guide, methodology selector, and community support. Start your project management journey today!"
Actions:
- Show docs/getting-started/
- Highlight community resources
- End with call-to-action: "Star the repo and try the onboarding!"
Screen Recording Setup
Tool Recommendations (macOS)
- Built-in: QuickTime Player (free)
- Advanced: ScreenFlow ($129) - recommended for professional quality
- Free alternative: OBS Studio (free, open source)
Recording Settings
- Resolution: 1920x1080 (1080p)
- Frame rate: 30 fps
- Audio: 44.1 kHz, 16-bit
- Format: MP4 (H.264)
Pre-Recording Checklist
Environment Setup
- Clean desktop/browser
- Close unnecessary applications
- Set up terminal with larger font (16pt minimum)
- Prepare browser bookmarks for quick navigation
- Test microphone audio levels
Content Preparation
- Practice the script timing (aim for 2:30-2:45)
- Set up example project data for realistic demo
- Prepare clean repository state
- Test all interactive features work smoothly
Technical Setup
- Install/configure screen recording software
- Set recording area to capture full screen or specific window
- Test audio recording quality
- Prepare editing software (if needed)
Recording Instructions
Phase 1: Screen Recording
# Prepare the environment
cd /Users/michael/pm-tools-templates
git status # Ensure clean state
node ecosystem-gateway.js # Test onboarding works
Phase 2: Audio Recording
- Record voiceover separately for better quality control
- Use script timing markers
- Speak clearly and at moderate pace
- Include natural pauses for visual actions
Phase 3: Post-Production
- Sync audio with video
- Add subtle zoom-ins for important UI elements
- Include captions for accessibility
- Add intro/outro graphics (optional)
- Export in multiple formats for web compatibility
Quick Setup Commands
Install OBS Studio (Free Option)
# Using Homebrew
brew install --cask obs
# Manual download from: https://obsproject.com/
Install ScreenFlow (Premium Option)
# Available from Mac App Store or:
# https://www.telestream.net/screenflow/
Alternative: Use Built-in QuickTime
# Launch QuickTime Player
open -a "QuickTime Player"
# File > New Screen Recording
Video Hosting & Embedding
Recommended Platforms
- YouTube (recommended for GitHub integration)
- Vimeo (professional, customizable player)
- GitHub Releases (direct hosting for small files)
Embedding Code Template
<!-- Responsive YouTube embed -->
<div class="video-container">
<iframe
src="https://www.youtube.com/embed/VIDEO_ID"
title="PM Tools Templates Demo"
frameborder="0"
allowfullscreen>
</iframe>
</div>
<style>
.video-container {
position: relative;
padding-bottom: 56.25%; /* 16:9 aspect ratio */
height: 0;
overflow: hidden;
}
.video-container iframe {
position: absolute;
top: 0;
left: 0;
width: 100%;
height: 100%;
}
</style>
Success Metrics
After publishing, track:
- View count and watch time
- Click-through rate to repository
- Star/fork increases after video views
- User feedback in comments
- Mobile playback performance
Next Steps
- Practice the script (run through 2-3 times)
- Set up recording environment
- Record in segments (can edit together)
- Review and refine
- Upload and embed
- Gather feedback and iterate
This script fulfills UX-102 requirements: under 3 minutes, shows template selection and usage, designed for GitHub Pages embedding with mobile responsiveness.
What's inside
Script outline with 5 timed scenes, recording setup, pre-recording checklist, 3 phases of instructions, quick setup commands, and success metrics.
Change this for your project
- Replace
mirichard/pm-tools-templateswith your own repository name - Replace
node ecosystem-gateway.jswith your own onboarding script command - Replace
cd /Users/michael/pm-tools-templateswith your local project path - Replace
VIDEO_IDin the embed code with your actual YouTube video ID
Where it goes
Keep it in your repository where the agent or team that needs it will read it.
Worth borrowing
- Structuring a demo video around a timed script with explicit scene descriptions and voiceover text
- Including a pre-recording checklist for environment, content, and technical setup
Related Documents
RealDiag Demo Video Script
Provides a complete 5-7 minute demo video script for a clinical decision support tool, including timing, visual cues, and production notes.
Setup & Deployment Checklist
Guides you through 10 phases to set up, test, deploy, and customize a content agent system using OpenRouter and Streamlit.
š± Mobile Phone Preview - Quick Start
Walks you through four ways to preview a React Native Expo app on real devices and emulators, plus a testing checklist and troubleshooting guide.
Session 1 Agenda: Foundations + Setup
Schedules a 110-120 minute teaching session covering tech stack, RAG, knowledge base setup, and agent customization for a multi-agent email system.