tim-hub/powerball-harness / .claude/skills/generate-video
generate-video
VerifiedGenerates product demo videos and release walkthroughs via Remotion. Use when creating video documentation or animated demos.
Generate Video Skill
A collection of skills responsible for automatically generating product explanation videos.
Overview
This skill is used internally by the /generate-video command.
It executes the flow of codebase analysis → scenario proposal → parallel generation.
Feature Details
| Feature | Details |
|---|---|
| Best Practices | See references/best-practices.md |
| Codebase Analysis | See references/analyzer.md |
| Scenario Planning | See references/planner.md |
| Parallel Scene Generation | See references/generator.md |
| Visual Effects Library | See references/visual-effects.md |
| AI Image Generation | See references/image-generator.md |
| Image Quality Assessment | See references/image-quality-check.md |
Prerequisites
- Remotion is set up (
/remotion-setup) - Node.js 18+
- (Optional)
GOOGLE_AI_API_KEY- for AI image generation
/generate-video Flow
/generate-video
│
├─[Step 1] Analysis (analyzer.md)
│ ├─ Framework detection
│ ├─ Key feature detection
│ ├─ UI component detection
│ └─ Project asset analysis (Plans.md, CHANGELOG, etc.)
│
├─[Step 2] Scenario Proposal (planner.md)
│ ├─ Auto-determine video type
│ ├─ Scene composition proposal
│ └─ User confirmation
│
├─[Step 2.5] Asset Generation (image-generator.md) ← NEW
│ ├─ Determine if assets are needed (intro, CTA, etc.)
│ ├─ Generate 2 images with Nano Banana Pro
│ ├─ Claude assesses quality (image-quality-check.md)
│ └─ OK → adopt / NG → regenerate (up to 3 times)
│
└─[Step 3] Parallel Generation (generator.md)
├─ Parallel scene generation (Task tool)
├─ Integration + transitions
└─ Final rendering
Execution Steps
- User runs
/generate-video - Verify Remotion setup
- Analyze codebase with
analyzer.md - Propose scenario with
planner.md+ user confirmation - Parallel generation with
generator.md - Completion report
Video Types (by funnel stage)
| Type | Funnel Stage | Approx. Length | Auto-detection Criteria | Core Structure |
|---|---|---|---|---|
| LP/Ad Teaser | Awareness → Interest | 30-90s | New project | Pain → Result → CTA |
| Intro Demo | Interest → Consideration | 2-3 min | UI changes detected | Complete 1 use case |
| Release Notes | Consideration → Conviction | 1-3 min | CHANGELOG updated | Before/After focused |
| Architecture Overview | Conviction → Decision | 5-30 min | Major structural changes | Production use + evidence |
| Onboarding | Retention & Adoption | 30s - several min | First-time setup | Shortest path to Aha moment |
Details: references/best-practices.md
Scene Templates
90-second Teaser (for LP/ads)
| Time | Scene | Content |
|---|---|---|
| 0-5s | Hook | Pain or desired outcome |
| 5-15s | Problem+Promise | Target user and promise |
| 15-55s | Workflow | Signature workflow |
| 55-70s | Differentiator | Basis for differentiation |
| 70-90s | CTA | Next step |
3-minute Intro Demo (for consideration)
| Time | Scene | Content |
|---|---|---|
| 0-10s | Hook | Conclusion + pain |
| 10-30s | UseCase | Use case declaration |
| 30-140s | Demo | Full walkthrough on actual screens |
| 140-170s | Objection | Address one common concern |
| 170-180s | CTA | Call to action |
Common Scenes
| Scene | Recommended Duration | Content |
|---|---|---|
| Intro | 3-5s | Logo + tagline |
| Feature Demo | 10-30s | Playwright capture |
| Architecture Diagram | 10-20s | Mermaid → animation |
| CTA | 3-5s | URL + contact |
Detailed templates: ${CLAUDE_SKILL_DIR}/references/best-practices.md
Audio Sync Rules (Important)
Strictly follow these rules for narrated videos:
| Rule | Value |
|---|---|
| Audio start | Scene start + 30f (1-second wait) |
| Scene length | 30f + audio length + 20f padding |
| Transition | 15f (overlap with adjacent scenes) |
| Scene start calculation | Previous scene start + previous scene length - 15f |
Pre-check: Verify audio length with ffprobe before designing scenes
BGM Support
| Item | Recommended Value |
|---|---|
| With narration | bgmVolume: 0.20 - 0.30 |
| Without narration | bgmVolume: 0.50 - 0.80 |
| File location | public/BGM/ |
Subtitle Support
| Rule | Value |
|---|---|
| Subtitle start | Same as audio start |
| Subtitle duration | Audio length + 10f |
| Font | Base64 embedding recommended |
Visual Effects Library
A collection of effects for impactful videos:
| Effect | Use Case |
|---|---|
| GlitchText | Hook, titles |
| Particles | Background, CTA convergence |
| ScanLine | Analysis in-progress effect |
| ProgressBar | Parallel processing display |
| 3D Parallax | Card display |
Details: references/visual-effects.md
Notes
- If Remotion is not set up, guide users to
/remotion-setup - Number of parallel generations auto-adjusts based on scene count (max 5)
- Generated videos are output to the
out/directory - AI-generated images are saved to
out/assets/generated/ - When
GOOGLE_AI_API_KEYis not set, image generation is skipped (existing assets or placeholders are used)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file). | Stars: 198k | Updated | Claude CodeCodex | Unverified | Install |
| doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |